BLAZE-CONFIG(1) BlazeBlogger Documentation BLAZE-CONFIG(1)
NAME
blaze-config - displays or sets BlazeBlogger configuration options
SYNOPSIS
blaze-config [-qV] [-b directory] [-E editor] option [value...]
blaze-config -e [-b directory]
blaze-config -h|-v
DESCRIPTION
blaze-config either sets BlazeBlogger configuration options, or displays their current value. Additionally, it can also open a
configuration file in an external text editor.
OPTIONS
Command Line Options
-b directory, --blogdir directory
Allows you to specify a directory in which the BlazeBlogger repository is placed. The default option is a current working directory.
-E editor, --editor editor
Allows you to specify an external text editor. When supplied, this option overrides the relevant configuration option.
-e, --edit
Allows you to edit the configuration in a text editor.
-q, --quiet
Disables displaying of unnecessary messages.
-V, --verbose
Enables displaying of all messages. This is the default option.
-h, --help
Displays usage information and exits.
-v, --version
Displays version information and exits.
Configuration Options
blog.title=string
A title of your blog.
blog.subtitle=string
A subtitle of your blog.
blog.description=string
A brief description of your blog.
blog.keywords=list
A comma-separated list of keywords.
blog.theme=string
A theme for your blog. Note that it must point to an existing file in the ".blaze/theme/" directory. The default option is
"default.html".
blog.style=string
A style sheet for your blog. Note that it must point to an existing file in the ".blaze/style/" directory. The default option is
"default.css".
blog.lang=string
A translation of your blog. Note that it must point to an existing file in the ".blaze/lang/" directory. The default option is "en_US".
blog.posts=integer
A number of blog posts to be listed on a single page. The default option is 10.
color.list=boolean
A boolean to enable ("true") or disable ("false") colors in the blaze-list output. The default option is "false".
color.log=boolean
A boolean to enable ("true") or disable ("false") colors in the blaze-log output. The default option is "false".
core.doctype=string
A document type. It can be either "html" for HTML, or "xhtml" for the XHTML standard. The default option is "html".
core.extension=string
A file extension. The default option is "html".
core.encoding=string
A character encoding. Note that it has to be in a form that is recognized by W3C standards. The default option is "UTF-8".
core.editor=string
An external text editor. When supplied, this option overrides the system-wide settings.
core.processor=string
An external application to be used to process newly added or edited blog posts and pages. Note that you must supply "%in%" and "%out%"
in place of an input and output file name respectively. This option is disabled by default.
feed.baseurl=string
A URL of your blog, for example "http://example.com".
feed.posts=integer
A number of blog posts to be listed in the feed. The default option is 10.
feed.fullposts=boolean
A boolean to enable ("true") or disable ("false") inclusion of the whole content of a blog post in the feed, even though the <!-- break
--> form is used. The default option is "false".
post.author=string
A location of a blog post author name. It can be placed above the post ("top"), below it ("bottom"), or nowhere on the page ("none").
The default option is "top".
post.date=string
A location of a date of publishing. It can be placed above the post ("top"), below it ("bottom"), or nowhere on the page ("none"). The
default option is top.
post.tags=string
A location of post tags. They can be placed above the post ("top"), below it ("bottom"), or nowhere on the page ("none"). The default
option is "top".
user.name=string
Your full name to be used in the copyright notice, and as the default post author. The default option is "admin".
user.nickname=string
Your nickname to be used as the default post author. When supplied, it overrides the user.name setting. This option is disabled by
default.
user.email=string
Your email address. The default option is "admin@localhost".
ENVIRONMENT
EDITOR
Unless the core.editor option is set, BlazeBlogger tries to use system-wide settings to decide which editor to use.
FILES
.blaze/config
A file containing the configuration.
.blaze/theme/
A directory containing blog themes.
.blaze/style/
A directory containing style sheets.
.blaze/lang/
A directory containing language files.
EXAMPLE USAGE
Configure the default text editor:
~]$ blaze-config core.editor nano
The option has been successfully saved.
Configure the user information:
~]$ blaze-config user.name Jaromir Hradilek
The option has been successfully saved.
~]$ blaze-config user.email jhradilek@gmail.com
The option has been successfully saved.
Configure the blog appearance:
~]$ blaze-config blog.title BlazeBlogger
The option has been successfully saved.
~]$ blaze-config blog.subtitle a CMS without boundaries
The option has been successfully saved.
~]$ blaze-config blog.theme keepitsimple.html
The option has been successfully saved.
~]$ blaze-config blog.style keepitsimple.css
The option has been successfully saved.
Configure the RSS feed:
~]$ blaze-config feed.fullposts true
The option has been successfully saved.
~]$ blaze-config feed.posts 10
The option has been successfully saved.
~]$ blaze-config feed.baseurl http://blaze.blackened.cz/
The option has been successfully saved.
Open the configuration in a text editor:
~]$ blaze-config -e
SEE ALSO
blaze-init(1)
BUGS
To report a bug or to send a patch, please, add a new issue to the bug tracker at <http://code.google.com/p/blazeblogger/issues/>, or visit
the discussion group at <http://groups.google.com/group/blazeblogger/>.
COPYRIGHT
Copyright (C) 2008-2011 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.
Version 1.2.0 2012-03-05 BLAZE-CONFIG(1)