blaze-config - display or set the BlazeBlogger repository options
blaze-config [-qV] [-b directory] name [value...]
blaze-config -e [-b directory]
blaze-config -h | -v
blaze-config is a simple configuration tool for the BlazeBlogger.
Depending on the number of given command-line arguments, it either
displays the current value of the specified option, or sets/replaces it
with the new one.
The accepted option name is in the form of dot separated section and
key (e.g. user.name). For the complete list of available options along
with the explanation of their meaning, see the appropriate section
-b, --blogdir directory
Specify the directory where the BlazeBlogger repository is placed.
The default option is the current working directory.
Open the configuration file in the external text editor.
Avoid displaying messages that are not necessary.
Display all messages. This is the default option.
Display usage information and exit.
Display version information and exit.
Available option names
Blog subtitle, supposedly a brief, single-line description of what
should an occasional visitor expect to find.
Blog theme; the value should point to an existing file in the
Blog stylesheet; the value should point to an existing file, either
in ".blaze/style" (recommended), or in the destination directory
where the static content is to be placed.
Blog language; the value should point to an existing file in the
Number of posts to be listed on a single page; the default value is
Blog base url; required for RSS feeds only.
Whether to use coloured post/pages listing; the value has to be
either "true", or "false". Colours are turned off by default.
Whether to use coloured log listing; the value has to be either
"true", or "false". Colours are turned off by default.
Records encoding in the form recognised by the W3C HTML 4.01
standard (e.g. the default UTF-8).
File extension for the generated pages. By default, the "html" is
used as a reasonable choice.
Text editor to be used for editing purposes. Unless this option is
set, BlazeBlogger tries to use system wide settings by looking for
"EDITOR" environment variable, and if neither of these options is
supplied, "vi" is used as a considerably reasonable option.
Optional external application to be used to process the entries;
use "%in%" and "%out%" in place of input and output file names
(e.g. "markdown --html4tags %in% > %out%"). Nevertheless, if you
intend to write your content in HTML directly, feel free to leave
this option empty (the default setting).
Location of the post author information; available options are
"top", "bottom", or "none". Author is placed above the post (below
its heading) by default.
Location of the post date of publishing information; available
options are "top", "bottom", or "none". Date of publishing is
placed above the post (below its heading) by default.
Location of the post tags; available options are "top", "bottom",
or "none". Tags are placed above the post (below its heading) by
User’s name to be used as a default posts’ author and optionally
anywhere on the page, depending on the theme (e.g. in the copyright
User’s e-mail. Depending on the theme, it can be used anywhere on
the page (e.g. in the copyright notice). However, non of the
official themes actually use it.
Unless the BlazeBlogger specific option core.editor is set, blaze-
edit tries to use system wide settings to decide which editor to
run. If neither of these options are supplied, the vi is used
instead as a considerably reasonable choice.
BlazeBlogger configuration file.
To report bug or even send patch, either add new issue to the project
bugtracker at <http://code.google.com/p/blazeblogger/issues/>, or visit
the discussion group at <http://groups.google.com/group/blazeblogger/>.
You can also contact the author directly via e-mail.
Written by Jaromir Hradilek <email@example.com>.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included as a file called FDL in the main
directory of the BlazeBlogger source package.
Copyright (C) 2008, 2009 Jaromir Hradilek
This program is free software; see the source for copying conditions.
It is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.