blaze-add(1)
NAME
blaze-add - add a blog post or a page to the BlazeBlogger repository
SYNOPSIS
blaze-add [-pqCPV] [-b directory] [-a author] [-d date] [-t title] [-T tags] [-u url] [file...]
blaze-add -h | -v
DESCRIPTION
blaze-add adds new blog posts or pages to the BlazeBlogger repository.
If supplied, it tries to read data from the existing files, otherwise
an external editor is opened to let you create a new content.
Note that inside your posts and pages, you can use several special
placeholders to be replaced by appropriate data later, when the static
content is being generated; the case is not significant, and supported
placeholders are as follows:
- %root%
- Relative path to the root directory of the blog; to be used inside links.
- %home%
- Relative path to the website home (index) page; to be used inside
links. - %page[id]%
- Relative path to the page with given id; to be used inside links.
- %post[id]%
- Relative path to the post with given id; to be used inside links.
- %tag[name]%
- Relative path to the tag with given name; to be used inside links.
- You can also use a special form, <!-- break -->, to mark the end of a part to be displayed on index page.
OPTIONS
- -b, --blogdir directory
- Specify the directory where the BlazeBlogger repository is placed. The default option is the current working directory.
- -t, --title title
- Specify the post/page title.
- -a, --author author
- Specify the post/page author.
- -d, --date date
- Specify the post/page date of publishing; the date has to be in the YYYY-MM-DD form.
- -T, --tags tags
- Specify the comma separated list of tags attached to the blog post;
pages ignore these. - -u, --url url
- Specify the post/page url to be used instead of the one based on the post/page title. It should consist of alphanumeric characters, hyphens and underscores only, and it is especially useful if nonASCII characters are present in the title.
- -p, --page, --pages
- Add page instead of blog post.
- -P, --post, --posts
- Add blog post; this is the default option.
- -C, --no-processor
- Disable the use of external processor. Unless the "core.processor" is enabled in the configuration, this is the default behaviour.
- -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.
ENVIRONMENT
- EDITOR
- Unless the BlazeBlogger specific option core.editor is set, blazeedit 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
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.