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

NAME

6       blaze-add - adds a blog post or a page to the BlazeBlogger repository
7

SYNOPSIS

9       blaze-add [-pqCPV] [-b directory] [-E editor] [-a author] [-d date] [-t
10       title] [-T tags] [-u url] [file...]
11
12       blaze-add -h|-v
13

DESCRIPTION

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

OPTIONS

42       -b directory, --blogdir directory
43           Allows you to specify a directory in which the BlazeBlogger
44           repository is placed. The default option is a current working
45           directory.
46
47       -E editor, --editor editor
48           Allows you to specify an external text editor. When supplied, this
49           option overrides the relevant configuration option.
50
51       -t title, --title title
52           Allows you to specify the title of a blog post or page.
53
54       -a author, --author author
55           Allows you to specify the author of a blog post or page.
56
57       -d date, --date date
58           Allows you to specify the date of publishing of a blog post or
59           page.
60
61       -T tags, --tags tags
62           Allows you to supply a comma-separated list of tags attached to a
63           blog post.
64
65       -u url, --url url
66           Allows you to specify the url of a blog post or page. Allowed
67           characters are letters, numbers, hyphens, and underscores.
68
69       -p, --page, --pages
70           Tells blaze-add to add a page or pages.
71
72       -P, --post, --posts
73           Tells blaze-add to add a blog post or blog posts. This is the
74           default option.
75
76       -C, --no-processor
77           Disables processing a blog post or page with an external
78           application. For example, if you use Markdown to convert the
79           lightweight markup language to the valid HTML output, this will
80           enable you to write this particular post in plain HTML directly.
81
82       -q, --quiet
83           Disables displaying of unnecessary messages.
84
85       -V, --verbose
86           Enables displaying of all messages. This is the default option.
87
88       -h, --help
89           Displays usage information and exits.
90
91       -v, --version
92           Displays version information and exits.
93

ENVIRONMENT

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

EXAMPLE USAGE

100       Write a new blog post in an external text editor:
101
102         ~]$ blaze-add
103
104       Add a new blog post from a file:
105
106         ~]$ blaze-add new_packages.txt
107         Successfully added the post with ID 10.
108
109       Write a new page in an external text editor:
110
111         ~]$ blaze-add -p
112
113       Write a new page in nano:
114
115         ~]$ blaze-add -p -E nano
116

SEE ALSO

118       blaze-init(1), blaze-config(1), blaze-edit(1), blaze-remove(1), blaze-
119       make(1)
120

BUGS

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

127       Copyright (C) 2008-2010 Jaromir Hradilek
128
129       This program is free software; see the source for copying conditions.
130       It is distributed in the hope that it will be useful, but WITHOUT ANY
131       WARRANTY; without even the implied warranty of MERCHANTABILITY or
132       FITNESS FOR A PARTICULAR PURPOSE.
133
134
135
136Version 1.1.2                     2010-11-08                      BLAZE-ADD(1)
Impressum