1BLAZE-EDIT(1)             BlazeBlogger Documentation             BLAZE-EDIT(1)
2
3
4

NAME

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

SYNOPSIS

9       blaze-edit [-fpqCPV] [-b directory] [-E editor] id
10
11       blaze-edit -h|-v
12

DESCRIPTION

14       blaze-edit opens an existing blog post or a page with the specified id
15       in an external text editor. Note that there are several special forms
16       and placeholders that can be used in the text, and that will be
17       replaced with a proper data when the blog is generated.
18
19   Special Forms
20       <!-- break -->
21           A mark to delimit a blog post synopsis.
22
23   Placeholders
24       %root%
25           A relative path to the root directory of the blog.
26
27       %home%
28           A relative path to the index page of the blog.
29
30       %page[id]%
31           A relative path to a page with the supplied id.
32
33       %post[id]%
34           A relative path to a blog post with the supplied id.
35
36       %tag[name]%
37           A relative path to a tag with the supplied name.
38

OPTIONS

40       -b directory, --blogdir directory
41           Allows you to specify a directory in which the BlazeBlogger
42           repository is placed. The default option is a current working
43           directory.
44
45       -E editor, --editor editor
46           Allows you to specify an external text editor. When supplied, this
47           option overrides the relevant configuration option.
48
49       -p, --page
50           Tells blaze-edit to edit a page or pages.
51
52       -P, --post
53           Tells blaze-edit to edit a blog post or blog posts. This is the
54           default option.
55
56       -f, --force
57           Tells blaze-edit to create an empty source file in case it does not
58           already exist. If the core.processor option is enabled, this file
59           is used as the input to be processed by the selected application.
60
61       -C, --no-processor
62           Disables processing a blog post or page with an external
63           application.
64
65       -q, --quiet
66           Disables displaying of unnecessary messages.
67
68       -V, --verbose
69           Enables displaying of all messages. This is the default option.
70
71       -h, --help
72           Displays usage information and exits.
73
74       -v, --version
75           Displays version information and exits.
76

ENVIRONMENT

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

EXAMPLE USAGE

83       Edit a blog post in an external text editor:
84
85         ~]$ blaze-edit 10
86
87       Edit a page in an external text editor:
88
89         ~]$ blaze-edit -p 4
90
91       Edit a page in nano:
92
93         ~]$ blaze-edit -p 2 -E nano
94

SEE ALSO

96       blaze-config(1), blaze-add(1), blaze-list(1)
97

BUGS

99       To report a bug or to send a patch, please, add a new issue to the bug
100       tracker at <http://code.google.com/p/blazeblogger/issues/>, or visit
101       the discussion group at <http://groups.google.com/group/blazeblogger/>.
102

104       Copyright (C) 2008-2010 Jaromir Hradilek
105
106       This program is free software; see the source for copying conditions.
107       It is distributed in the hope that it will be useful, but WITHOUT ANY
108       WARRANTY; without even the implied warranty of MERCHANTABILITY or
109       FITNESS FOR A PARTICULAR PURPOSE.
110
111
112
113Version 1.1.2                     2010-11-08                     BLAZE-EDIT(1)
Impressum