Provided by: nanoblogger_3.4.2-3_all
NAME
NanoBlogger - small weblog engine for the UNIX command line
SYPNOSIS
nb [-b blog_dir] [options]
DESCRIPTION
NanoBlogger User's manual. NanoBlogger is a small weblog engine written in Bash for the command line. It uses common unix tools, such as cat, grep and sed. It's free to use and modify under the GNU General Public License.
OPTIONS
-a, --add create new entry, category, or weblog (directory). -b, --blogdir <directory> specify weblog directory. -B, --body <text> deprecated, please use '-T' or '--text' instead. -c, --category <ID,cat> specify category (for '--add', '--delete', '--edit', '--list', '--update', and '--update-cache'). --cfgfile <file> specify an alternate configuration file. --configure configure weblog (for '--update'). --datadir <directory> specify weblog's data directory. -d, --delete <ID,cat> delete an entry or category. -D, --desc <text> set text of description (for '--add', '--draft', '--makefile' and '--makepage'). -e, --edit <ID,cat> edit an entry or category. -E, --draft <file> edit or create metafile. -f, --file <file> specify metafile to import as entry (for '--add'). -h, --help show this help message. -i, --interactive <1=on/0=off> toggle interactive mode (for '--add', '--delete', '--preview', '--publish', and '--update'). -l, --list <all,cat,DATE,max> list entries or categories (defaults to max). --manual view the manual. -m, --move <ID> move an entry to a specified category (for '--category'). -M, --makepage <file1> <file2> create new weblog page (file2) from metafile (file1). --makefile <file> create new metafile. -n, --author <text> set text of author (for '--add', '--draft', '--makefile' and '--makepage'). --plugindir <directory> specify weblog's plugin directory. -p, --preview run command to preview weblog. -P, --publish run command to publish weblog. --template <file> specify file to load as template (for '--draft', '--makepage' and '--makefile'). --template-dir <directory> specify weblog's template directory. -t, --title <text> set text of title (for '--add', '--category', '--draft', '--makefile' and '--makepage'). --tag <TAG> specify tag (for '--add', '--draft', '--edit', '--makefile' and '--makepage'). --tag-text <text> set text of tag (for '--tag'). -T, --text <text> set text of body (for '--add', '--draft', '--makefile' and '--makepage'). -U, --update-cache <all,DATE,max,expired> force update of weblog's cache removing specified cached data (defaults to 'expired'). -u, --update <all,DATE,main,max> force update of weblog's files updating specified weblog data (defaults to 'max'). -v, --verbose <1=on/0=off> toggle level of verbosity. -V, --version display version information. -c,-d,-e,-m accepts multiple ID numbers separated by commas (e.g. 1,2,3). --list and --update can match entries by date (irrelevant of entry id(s)). date = YYYY-MM-DD, YYYY-MM, YYYY
EXAMPLES
--blogdir [myblog_dir] --add Where myblog_dir is a nonexistent directory. This will create a new directory, copy the default files over, and then let you edit the weblog's configuration. Multiple weblogs can be created this way. Running the same command again on an existing weblog directory will add a new entry. --blogdir [myblog_dir] --configure -u all This opens blog.conf from the weblog directory for editing and updates the entire weblog. [-b blog_dir] -a Add a new entry [-b blog_dir] -c 1 -a Add a new entry to a category [-b blog_dir] -t “New Entry” -n [entry_author] -a Set title and author for new entry [-b blog_dir] -t “New Entry” -n [entry_author] -M “My message.” -a Set title, author, and body for new entry [-b blog_dir] -l List current entries [-b blog_dir] -l all List all entries [-b blog_dir] -c 1 -l List entries for a category [-b blog_dir] -e 1 Edit the last entry created [-b blog_dir] -c 1 -e 1 Edit an entry from a category [-b blog_dir] -e 1,2,3 Edit multiple entries [-b blog_dir] -c 1 -m 1 Move an entry to a category [-b blog_dir] -c 1,2,3 -m 1 Move an entry to multiple categories [-b blog_dir] -c 1 -m 1,2,3 Move multiple entries to a category [-b blog_dir] -d 1 Permanently delete an entry [-b blog_dir] -d 1,2,3 Permanently delete multiple entries [-b blog_dir] -c 1 -d 1 Delete an entry from a category [-b blog_dir] -c new -a Create a new category [-b blog_dir] -t “New Category” -c new -a Set the title for a new category [-b blog_dir] -l cat List available categories [-b blog_dir] -c 1 -t “News” -e cat Edit a category's title [-b blog_dir] -c 1 -d cat Delete a category [-b blog_dir] -u all Update the Weblog's Data Directory
NOTES
The articles plugin provides a simple way for NanoBlogger to automatically generate and update articles for your weblog. Creating a new article is easy, create a new file in the articles directory and save it with the suffix, "txt". To remove an article simply rename it's suffix to something other than "txt" or remove it from the articles directory. Edit templates/main_links.htm to add new links.
FILES
/etc/nanoblogger/nb.conf
AUTHOR
NanoBlogger written by Kevin Wood (n1xt3r) <un1xt3r@fastmail.fm> This manual page was originally written by William Vera <billy@billy.com.mx> and then updated by Michal Cihar <michal@cihar.com> for the Debian system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation
SEE ALSO
/usr/share/doc/nanoblogger/nanoblogger.html http://nanoblogger.sourceforge.net/