blaze-edit (1) - Linux Manuals

blaze-edit: edit a blog post or a page in the BlazeBlogger repository

NAME

blaze-edit - edit a blog post or a page in the BlazeBlogger repository

SYNOPSIS

blaze-edit [-fpqCPV] [-b directory] id

blaze-edit -h | -v

DESCRIPTION

blaze-edit enables you to edit a blog post or a page in your favourite text editor.

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.
-p, --page
Edit page instead of blog post.
-P, --post
Edit blog post; this is the default option.
-f, --force
Force creating a new, empty raw file when it does not already exist, although the "core.processor" is enabled in the configuration; just be warned that this will rewrite whatever content is in the existing target file.
-C, --no-processor
Disable the use of external processor; just be warned that you will be editing the target (i.e. potentially previously processed) file instead of the raw source. 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, 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.

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 [at] 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.

SEE ALSO

blaze-config(1), perl(1).