BLAZE-CONFIG

Section: BlazeBlogger Documentation (1)
Updated: 2012-04-15
Index Return to Main Contents
 

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.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
Command Line Options
Configuration Options
ENVIRONMENT
FILES
EXAMPLE USAGE
SEE ALSO
BUGS
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 14:58:41 GMT, January 17, 2018