Man Linux: Main Page and Category List

NAME

       blaze-config - display or set the BlazeBlogger repository options

SYNOPSIS

       blaze-config [-qV] [-b directory] name [value...]

       blaze-config -e [-b directory]

       blaze-config -h | -v

DESCRIPTION

       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
       below.

OPTIONS

   Command-line options
       -b, --blogdir directory
           Specify the directory where the BlazeBlogger repository is placed.
           The default option is the current working directory.

       -e, --edit
           Open the configuration file in the external text editor.

       -q, --quiet
           Avoid displaying messages that are not necessary.

       -V, --verbose
           Display all messages. This is the default option.

       -h, --help
           Display usage information and exit.

       -v, --version
           Display version information and exit.

   Available option names
       blog.title
           Blog title.

       blog.subtitle
           Blog subtitle, supposedly a brief, single-line description of what
           should an occasional visitor expect to find.

       blog.theme
           Blog theme; the value should point to an existing file in the
           .blaze/theme directory.

       blog.style
           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.lang
           Blog language; the value should point to an existing file in the
           ".blaze/lang" directory.

       blog.posts
           Number of posts to be listed on a single page; the default value is
           10.

       blog.url
           Blog base url; required for RSS feeds only.

       color.list
           Whether to use coloured post/pages listing; the value has to be
           either "true", or "false". Colours are turned off by default.

       color.log
           Whether to use coloured log listing; the value has to be either
           "true", or "false". Colours are turned off by default.

       core.encoding
           Records encoding in the form recognised by the W3C HTML 4.01
           standard (e.g.  the default UTF-8).

       core.extension
           File extension for the generated pages. By default, the "html" is
           used as a reasonable choice.

       core.editor
           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.

       core.processor
           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).

       post.author
           Location of the post author information; available options are
           "top", "bottom", or "none". Author is placed above the post (below
           its heading) by default.

       post.date
           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.

       post.tags
           Location of the post tags; available options are "top", "bottom",
           or "none". Tags are placed above the post (below its heading) by
           default.

       user.name
           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
           notice).

       user.email
           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.

ENVIRONMENT

       EDITOR
           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.

FILES

       .blaze/config
           BlazeBlogger configuration file.

SEE ALSO

       perl(1).

BUGS

       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.

AUTHOR

       Written by Jaromir Hradilek <jhradilek@gmail.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

       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.