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 \*(C`.blaze/theme/\*(C' directory. The default option is \*(C`default.html\*(C'.

blog.style=string

A style sheet for your blog. Note that it must point to an existing file in the \*(C`.blaze/style/\*(C' directory. The default option is \*(C`default.css\*(C'.

blog.lang=string

A translation of your blog. Note that it must point to an existing file in the \*(C`.blaze/lang/\*(C' directory. The default option is \*(C`en_US\*(C'.

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 (\*(C`true\*(C') or disable (\*(C`false\*(C') colors in the blaze-list output. The default option is \*(C`false\*(C'.

color.log=boolean

A boolean to enable (\*(C`true\*(C') or disable (\*(C`false\*(C') colors in the blaze-log output. The default option is \*(C`false\*(C'.

core.doctype=string

A document type. It can be either \*(C`html\*(C' for \s-1HTML\s0, or \*(C`xhtml\*(C' for the \s-1XHTML\s0 standard. The default option is \*(C`html\*(C'.

core.extension=string

A file extension. The default option is \*(C`html\*(C'.

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 \*(C`UTF-8\*(C'.

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 \*(C`%in%\*(C' and \*(C`%out%\*(C' in place of an input and output file name respectively. This option is disabled by default.

feed.baseurl=string

A \s-1URL\s0 of your blog, for example \*(C`http://example.com\*(C'.

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 (\*(C`true\*(C') or disable (\*(C`false\*(C') inclusion of the whole content of a blog post in the feed, even though the <!-- break --> form is used. The default option is \*(C`false\*(C'.

post.author=string

A location of a blog post author name. It can be placed above the post (\*(C`top\*(C'), below it (\*(C`bottom\*(C'), or nowhere on the page (\*(C`none\*(C'). The default option is \*(C`top\*(C'.

post.date=string

A location of a date of publishing. It can be placed above the post (\*(C`top\*(C'), below it (\*(C`bottom\*(C'), or nowhere on the page (\*(C`none\*(C'). The default option is top.

post.tags=string

A location of post tags. They can be placed above the post (\*(C`top\*(C'), below it (\*(C`bottom\*(C'), or nowhere on the page (\*(C`none\*(C'). The default option is \*(C`top\*(C'.

user.name=string

Your full name to be used in the copyright notice, and as the default post author. The default option is \*(C`admin\*(C'.

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 \*(C`[email protected]\*(C'.

ENVIRONMENT

\s-1EDITOR\s0

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 [email protected] 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 \s-1RSS\s0 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

RELATED TO blaze-config…

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 \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of \s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.