NAME

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

SYNOPSIS

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

       blaze-edit -h|-v

DESCRIPTION

       blaze-edit opens an existing blog post or a page with the specified id in an external text editor. Note
       that there are several special forms and placeholders that can be used in the text, and that will be
       replaced with a proper data when the blog is generated.

   Special Forms
       <!-- break -->
           A mark to delimit a blog post synopsis.

   Placeholders
       %root%
           A relative path to the root directory of the blog.

       %home%
           A relative path to the index page of the blog.

       %page[id]%
           A relative path to a page with the supplied id.

       %post[id]%
           A relative path to a blog post with the supplied id.

       %tag[name]%
           A relative path to a tag with the supplied name.

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.

       -p, --page
           Tells blaze-edit to edit a page or pages.

       -P, --post
           Tells blaze-edit to edit a blog post or blog posts. This is the default option.

       -f, --force
           Tells  blaze-edit  to  create  an  empty  source  file  in  case  it  does  not already exist. If the
           core.processor option is enabled, this file is used as the input to  be  processed  by  the  selected
           application.

       -C, --no-processor
           Disables processing a blog post or page with an external application.

       -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.

ENVIRONMENT

       EDITOR
           Unless  the core.editor option is set, BlazeBlogger tries to use system-wide settings to decide which
           editor to use.

EXAMPLE USAGE

       Edit a blog post in an external text editor:

         ~]$ blaze-edit 10

       Edit a page in an external text editor:

         ~]$ blaze-edit -p 4

       Edit a page in nano:

         ~]$ blaze-edit -p 2 -E nano

SEE ALSO

       blaze-config(1), blaze-add(1), blaze-list(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                                      2019-10-07                                      BLAZE-EDIT(1)