Edition 1
Mono-spaced Bold
To see the contents of the filemy_next_bestselling_novelin your current working directory, enter thecat my_next_bestselling_novelcommand at the shell prompt and press Enter to execute the command.
Press Enter to execute the command.Press Ctrl+Alt+F2 to switch to the first virtual terminal. Press Ctrl+Alt+F1 to return to your X-Windows session.
mono-spaced bold. For example:
File-related classes includefilesystemfor file systems,filefor files, anddirfor directories. Each class has its own associated set of permissions.
Choose → → from the main menu bar to launch Mouse Preferences. In the Buttons tab, click the Left-handed mouse check box and click to switch the primary mouse button from the left to the right (making the mouse suitable for use in the left hand).To insert a special character into a gedit file, choose → → from the main menu bar. Next, choose → from the Character Map menu bar, type the name of the character in the Search field and click . The character you sought will be highlighted in the Character Table. Double-click this highlighted character to place it in the Text to copy field and then click the button. Now switch back to your document and choose → from the gedit menu bar.
Mono-spaced Bold ItalicProportional Bold Italic
To connect to a remote machine using ssh, typesshat a shell prompt. If the remote machine isusername@domain.nameexample.comand your username on that machine is john, typessh john@example.com.Themount -o remountcommand remounts the named file system. For example, to remount thefile-system/homefile system, the command ismount -o remount /home.To see the version of a currently installed package, use therpm -qcommand. It will return a result as follows:package.package-version-release
Publican is a DocBook publishing system.
mono-spaced roman and presented thus:
books Desktop documentation drafts mss photos stuff svn books_tests Desktop1 downloads images notes scripts svgs
mono-spaced roman but add syntax highlighting as follows:
package org.jboss.book.jca.ex1; import javax.naming.InitialContext; public class ExClient { public static void main(String args[]) throws Exception { InitialContext iniCtx = new InitialContext(); Object ref = iniCtx.lookup("EchoBean"); EchoHome home = (EchoHome) ref; Echo echo = home.create(); System.out.println("Created Echo"); System.out.println("Echo.echo('Hello') = " + echo.echo("Hello")); } }
Table of Contents
5.8.8 or higher.
Arch Linux: you can either build the package manually, or you can use the Yaourt utility. In both cases, ensure that the base-devel is installed by running the following command as root:
pacman -S base-develPKGBUILD file from AUR. For example:
wget -t 0 http://aur.archlinux.org/packages/blazeblogger/PKGBUILDmakepkg -sroot, install the newly built package by typing the following at a shell prompt:
pacman -U package_nameyaourt -S blazebloggerDebian. To install it, open a terminal, and run the following command as root:
apt-get install blazebloggerFedora 13 (“Goddard”) and Fedora 14 (“Laughlin”). To install it, open a terminal, and run the following command as root:
yum install blazebloggerGentoo Portage. To install it, open a terminal, and run the following command as root:
emerge blazebloggerUbuntu 10.04 LTS (“Lucid Lynx”) and Ubuntu 10.10 (“Maverick Meerkat”). To install it, open a terminal, and run the following command:
sudo apt-get install blazebloggerblazeblogger-1.2.0/windows/. For example:
C:\blazeblogger-1.2.0\windows> blaze inittar xfz blazeblogger-1.2.0.tar.gzblazeblogger-1.2.0 will appear in the current working directory. Switch to superuser, get into the newly created directory, and type the following at a shell prompt:
make install/usr/local/ directory, and place Bash completion file to /etc/bash_completion.d/. To use a different installation directory, change the value of prefix on the command line. For example, if you want to install BlazeBlogger to /usr/, type the following command:
make prefix=/usr installmake prefix=$HOME install_bincompdir to a directory you have access to. For example:
make prefix=$HOME compdir='$(prefix)/etc' installblaze-command and more convenient blaze command interchangeably. For a list of available commands, type the following at a shell prompt:
blaze helpblaze-init.blaze/, in which the blog data are stored. The actual content of this directory is not important, and it is recommended that you never touch the files in it directly.
--force (or -f for short) command line option:
blaze-init-f
blaze-init”.
~/public_html/ Directory~/public_html/. You can start a new blog in this directory by typing the following command:
public_html]$ blaze-init
Created a BlazeBlogger repository in .blaze.blaze-config command followed by an option name:
blaze-configoption
blaze-configoptionvalue…
blaze-config command with the --edit (or -e) command line option:
blaze-config-e
core.editor configuration option is already set, you must also specify a text editor to use by adding the --editor (or -E) option:
blaze-config-e-Eeditor
blaze-config”.
public_html]$ blaze-config -e -E "gvim -f"public_html]$ blaze-config core.editor "gvim -f"core.encoding option with a value in the form that is recognized by W3C standards:
blaze-configcore.encodingencoding
UTF-8.
blaze-configcore.doctypetype
html for HTML and xhtml for the XHTML standard. For compatibility reasons, the default option is to generate HTML pages.
blaze-configcore.extensionextension
blaze-make command.
public_html]$ blaze-config core.encoding ISO-8859-2
The option has been successfully saved.http:// (or https:// if you use a secure protocol) prefix:
blaze-configfeed.baseurlurl
blaze-make command.
public_html]$ blaze-config feed.baseurl http://blaze.blackened.cz/
The option has been successfully saved.blaze-configblog.titletitle
blaze-configblog.subtitlesubtitle
blaze-make command.
public_html]$blaze-config blog.title BlazeBloggerThe option has been successfully saved. public_html]$blaze-config blog.subtitle a CMS without boundariesThe option has been successfully saved.
blaze-configblog.descriptiondescription
blaze-configblog.keywordskeywords
blaze-make command.
public_html]$blaze-config blog.description a CMS without boundariesThe option has been successfully saved. public_html]$blaze-config blog.keywords blazeblogger, cms, blogThe option has been successfully saved.
blaze-configuser.namefull_name
blaze-configuser.nicknamenickname
blaze-configuser.emailemail_address
blaze-make command.
public_html]$blaze-config user.name Jaromír HradílekThe option has been successfully saved. public_html]$blaze-config user.nickname BlackenedThe option has been successfully saved. public_html]$blaze-config user.email jhradilek@gmail.comThe option has been successfully saved.
.blaze/lang/ directory, and configure the blog to use this translation:
blaze-configblog.langlanguage_code
blaze-make command.
/usr/local/share/blazeblogger/lang/ directory. On such system, you can change the translation of your blog to the Basque language by running the following commands:
public_html]$cp /usr/local/share/blazeblogger/lang/eu_ES .blaze/lang/public_html]$blaze-config blog.lang eu_ESThe option has been successfully saved.
.blaze/theme/ and .blaze/style/ respectively. Then change the configuration to use this theme by typing the following at a shell prompt:
blaze-configblog.themetemplate_fileblaze-configblog.stylestylesheet_file
blaze-make command.
.blaze/:
public_html]$wget http://blaze.blackened.cz/files/theme/vectorlover-1.0.2.tar.gz--2011-02-14 00:53:07-- http://blaze.blackened.cz/files/theme/vectorlover-1.0.2.tar.gz Resolving blaze.blackened.cz... 87.236.199.95 Connecting to blaze.blackened.cz|87.236.199.95|:80... connected. HTTP request sent, awaiting response... 200 OK Length: 59972 (59K) [application/x-gzip] Saving to: "vectorlover-1.0.2.tar.gz" 100%[======================================>] 59,972 --.-K/s in 0.1s 2011-02-14 00:53:08 (397 KB/s) - "vectorlover-1.0.2.tar.gz" saved [59972/59972] public_html]$tar xfz vectorlover-1.0.2.tar.gz
.blaze/theme/ and .blaze/style/ respectively:
public_html]$mv vectorlover.html .blaze/theme/public_html]$mv vectorlover.css .blaze/style/
public_html]$blaze-config blog.theme vectorlover.htmlThe option has been successfully saved. public_html]$blaze-config blog.style vectorlover.cssThe option has been successfully saved.
blaze-add--page (or -p) command line option:
blaze-add-p
| Option | Type | Description |
|---|---|---|
title
| Mandatory | Specifies the title of the blog post or page. |
author
| Mandatory |
Specifies the author of the blog post or page. The value of the user.name (or user.nickname if supplied) configuration option is used by default.
|
date
| Mandatory |
Specifies the date of publishing of the blog post or page, and has to be in the YYYY-MM-DD format. The current date is used by default.
|
keywords
| Optional | Allows you to specify a comma-separated list of keywords that are specific for the blog post or page. |
tags
| Optional | Allows you to specify a comma-separated list of categories the blog post belongs to. This option is not relevant for pages. |
url
| Optional | Allows you to specify the string to be used in the URL. It must contain alphanumeric characters, hyphens, and underscores only. |
| Form | Description |
|---|---|
<!-- break -->
| Delimits a blog post synopsis. |
%root%
| Is replaced with a relative path to the root directory of the blog. |
%home%
| Is replaced with a relative path to the index page of the blog. |
%page[
|
Is replaced with a relative path to a page with the given id.
|
%post[
|
Is replaced with a relative path to a blog post with the given id.
|
%tag[
|
Is replaced with a relative path to a tag with the given name.
|
blaze-add” for a full description of the blaze-add utility and its usage.
public_html]$ blaze-add# This and the following lines beginning with '#' are the blog post header.
# Please take your time and replace these options with desired values. Just
# remember that the date has to be in the YYYY-MM-DD form, tags are a comma
# separated list of categories the post (pages ignore these) belong to, and
# the url, if provided, should consist of alphanumeric characters, hyphens
# and underscores only. Specifying your own url is especially recommended
# in case you use non-ASCII characters in your blog post title.
#
# title: BlazeBlogger 1.1.1
# author: Jaromír Hradílek
# date: 2010-10-30
# keywords: release, bug fix
# tags: release
# url:
#
# The header ends here. The rest is the content of your blog post.
<p>
BlazeBlogger 1.1.1 has been released! This release fixes four bugs that may have caused BlazeBlogger to sort entries in a wrong order, produce invalid RSS feed, or not to run properly when using an older version of Perl.
</p>
<!-- break -->
<h3>Bug Fixes</h3>
<ul>
<li>
When the <code>feed.fullposts</code> configuration option was disabled, all HTML/XHTML entities were removed. However, this may have led to an invalid output. With this update, such entities are no longer stripped out, and the RSS feed is now created as expected. (<a href="http://code.google.com/p/blazeblogger/issues/detail?id=18">Issue 18</a>, <a href="http://code.google.com/p/blazeblogger/issues/detail?id=29">29</a>)
</li>
<li>
Due to incorrect use of the <code>cmp</code> operator, both <code>blaze-list</code> and <code>blaze-make</code> utilities may have listed blog posts in a wrong order. With this update, the comparison subroutine has been corrected, so that all entries are now sorted in a correct order. (<a href="http://code.google.com/p/blazeblogger/issues/detail?id=26">Issue 26</a>)
</li>
<li>
<p>When using an older version of Perl, attempting to run the <code>blaze-make</code> utility may have failed with the following error message:</p>
<pre>blaze-make: Creating `': mkdir : No such file or directory</pre>
<p>This error no longer occurs, and <code>blaze-make</code> now produces the expected output. (<a href="http://code.google.com/p/blazeblogger/issues/detail?id=30">Issue 30</a>)</p>
</li>
</ul>blaze-edit command followed by an appropriate identification number:
blaze-editid
--page (or -p) command line option:
blaze-edit-pid
blaze-edit”.
public_html]$ blaze-edit 10blaze-remove command followed by an appropriate identification number:
blaze-removeid
--page (or -p) command line option:
blaze-remove-pid
blaze-remove”.
--interactive (or -i) option:
blaze-remove-iid
public_html]$blaze-remove -i 10Remove the post with ID 10 titled `Debian and Fedora Packages'?nAborted.
blaze-list with the --stats (or -S) command line option:
blaze-list-S
--short (or -s) command line option as well:
blaze-list-Ss
public_html]$ blaze-list -S
Number of pages: 5
Number of posts: 11
Last post date: 2010-07-25
First post date: 2009-02-10public_html]$ blaze-list -Ss
There is a total number of 11 blog posts and 5 pages in the repository.blaze-list utility that allows you to display the content of a blog. This includes the important information such as the identification number, date of publishing, title, and attached tags.
blaze-list, use the following command:
blaze-configcolor.listtrue
blaze-list--pages (or -p) command line option:
blaze-list-p
--reverse (or -r) option:
blaze-list-r
--number (or -n) option.
blaze-list-nnumber
--author or -a), a tag (--tag or -T), a matching title (--title or -T), a date of publishing, and other criteria.
blaze-list”.
public_html]$ blaze-list -n 1 -r
ID: 1 | 2009-02-10 | Jaromír Hradílek
Title: BlazeBlogger 0.7.0
Tags: release
blaze-make--destdir (or -d) command line option:
blaze-make-ddirectory
--verbose (or -V) command line option:
blaze-make-V
blaze-make”.
--full-paths (or -F) option:
blaze-make-F
--no-rss (or -r) option:
blaze-make-Fr
public_html]$ blaze-make -VF
Created index.rss
Created index.html
Created index1.html
Created 2010/10/index.html
Created 2010/07/11-join-blazeblogger-on-irc/index.html
Created 2009/12/10-debian-and-fedora-packages/index.html
Created 2009/index.html
Created 2010/07/index.html
etc.
Done.blaze-log, use the following command:
blaze-configcolor.logtrue
blaze-log--reverse (or -r) command line option:
blaze-log-r
--number (or -n) command line option:
blaze-log-nnumber
blaze-log”.
public_html]$ blaze-log -n 1
Date: Sun Jul 25 16:48:22 2010
Edited the page with ID 5.
Table of Contents
blaze-initblaze-init creates a BlazeBlogger repository, or recovers a previously corrupted one.
blaze-init[-fqV] [-bdirectory]blaze-init-h|-v
blaze-init either creates a fresh new BlazeBlogger repository, or recovers an existing one in case it is corrupted. Optionally, it can also revert a configuration and default templates to their original state, leaving all user data (that is, both blog posts and pages) intact.
-b directory, --blogdir directorydirectory in which the BlazeBlogger repository is to be blaced. The default option is a current working directory.
-f, --force-q, --quiet-V, --verbose-h, --help-v, --version~]$ blaze-init
Created a BlazeBlogger repository in .blaze.~/public_html:
~]$ blaze-init -b ~/public_html
Created a BlazeBlogger repository in /home/jhradilek/public_html/.blaze.~]$ blaze-init -f
Recovered a BlazeBlogger repository in .blaze.~]$ blaze-init -fV
Created .blaze/config
Created .blaze/theme/default.html
Created .blaze/style/default.css
Created .blaze/lang/en_US
Recovered a BlazeBlogger repository in .blaze.blaze-config”blaze-config displays or sets BlazeBlogger configuration options.
blaze-add”blaze-add adds a blog post or a page to the BlazeBlogger repository.
blaze-configblaze-config displays or sets BlazeBlogger configuration options.
blaze-config[-qV] [-bdirectory] [-Eeditor]option[value…]blaze-config-e[-bdirectory]blaze-config-h|-v
blaze-config either sets BlazeBlogger configuration options, or displays their current value. Additionally, it can also open a configuration file in an external text editor.
-b directory, --blogdir directorydirectory in which the BlazeBlogger repository is placed. The default option is a current working directory.
-E editor, --editor editoreditor. When supplied, this option overrides the relevant configuration option.
-e, --edit-q, --quiet-V, --verbose-h, --help-v, --versionblog.title=stringblog.subtitle=stringblog.description=stringblog.keywords=listblog.theme=string.blaze/theme/ directory. The default option is default.html.
blog.style=string.blaze/style/ directory. The default option is default.css.
blog.lang=string.blaze/lang/ directory. The default option is en_US.
blog.posts=integer10.
color.list=booleantrue) or disable (false) colors in the blaze-list output. The default option is false.
color.log=booleantrue) or disable (false) colors in the blaze-log output. The default option is false.
core.doctype=stringhtml for HTML, or xhtml for the XHTML standard. The default option is html.
core.extension=stringhtml.
core.encoding=stringUTF-8.
core.editor=stringcore.processor=string%in% and %out% in place of an input and output file name respectively. This option is disabled by default.
feed.baseurl=stringhttp://example.com.
feed.posts=integer10.
feed.fullposts=booleantrue) or disable (false) inclusion of the whole content of a blog post in the feed, even though the <!-- break --> form is used. The default option is false.
post.author=stringtop), below it (bottom), or nowhere on the page (none). The default option is top.
post.date=stringtop), below it (bottom), or nowhere on the page (none). The default option is top.
post.tags=stringtop), below it (bottom), or nowhere on the page (none). The default option is top.
user.name=stringadmin.
user.nickname=stringuser.name setting. This option is disabled by default.
user.email=stringadmin@localhost.
EDITORcore.editor option is set, blaze-config tries to use system-wide settings to decide which editor to use.
.blaze/config.blaze/theme/.blaze/style/.blaze/lang/~]$ blaze-config core.editor nano
The option has been successfully saved.~]$blaze-config user.name Jaromir HradilekThe option has been successfully saved. ~]$blaze-config user.email jhradilek@gmail.comThe option has been successfully saved.
~]$blaze-config blog.title BlazeBloggerThe option has been successfully saved. ~]$blaze-config blog.subtitle a CMS without boundariesThe option has been successfully saved. ~]$blaze-config blog.theme keepitsimple.htmlThe option has been successfully saved. ~]$blaze-config blog.style keepitsimple.cssThe option has been successfully saved.
~]$blaze-config feed.fullposts trueThe option has been successfully saved. ~]$blaze-config feed.posts 10The option has been successfully saved. ~]$blaze-config feed.baseurl http://blaze.blackened.cz/The option has been successfully saved.
~]$ blaze-config -eblaze-init”blaze-init creates a BlazeBlogger repository, or recovers a previously corrupted one.
blaze-addblaze-add adds a blog post or a page to the BlazeBlogger repository.
blaze-add[-pqCPV] [-bdirectory] [-Eeditor] [-aauthor] [-ddate] [-kkeywords] [-ttitle] [-Ttags] [-uurl] [file…]blaze-add-h|-v
blaze-add adds a blog post or a page to the BlazeBlogger repository. If a file is supplied, it adds the content of that file, otherwise an external text editor is opened for you. 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.
<!-- break -->%root%%home%%page[id]%id.
%post[id]%id.
%tag[name]%name.
-b directory, --blogdir directorydirectory in which the BlazeBlogger repository is placed. The default option is a current working directory.
-E editor, --editor editoreditor. When supplied, this option overrides the relevant configuration option.
-t title, --title titletitle of a blog post or page.
-a author, --author authorauthor of a blog post or page.
-d date, --date datedate of publishing of a blog post or page.
-k keywords, --keywords keywordskeywords attached to a blog post or page.
-T tags, --tags tagstags attached to a blog post.
-u url, --url urlurl of a blog post or page. Allowed characters are letters, numbers, hyphens, and underscores.
-p, --page, --pagesblaze-add to add a page or pages.
-P, --post, --postsblaze-add to add a blog post or blog posts. This is the default option.
-C, --no-processor-q, --quiet-V, --verbose-h, --help-v, --versionEDITORcore.editor option is set, blaze-add tries to use system-wide settings to decide which editor to use.
~]$ blaze-add~]$ blaze-add new_packages.txt
Successfully added the post with ID 10.~]$ blaze-add -p~]$ blaze-add -p -E nanoblaze-init”blaze-init creates a BlazeBlogger repository, or recovers a previously corrupted one.
blaze-config”blaze-config displays or sets BlazeBlogger configuration options.
blaze-edit”blaze-edit edits a blog post or a page in the BlazeBlogger repository.
blaze-remove”blaze-remove removes a blog post or a page from the BlazeBlogger repository.
blaze-make”blaze-make generates a blog from the BlazeBlogger repository.
blaze-editblaze-edit edits a blog post or a page in the BlazeBlogger repository.
blaze-edit[-fpqCPV] [-bdirectory] [-Eeditor]idblaze-edit-h|-v
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.
<!-- break -->%root%%home%%page[id]%id.
%post[id]%id.
%tag[name]%name.
-b directory, --blogdir directorydirectory in which the BlazeBlogger repository is placed. The default option is a current working directory.
-E editor, --editor editoreditor. When supplied, this option overrides the relevant configuration option.
-p, --pageblaze-edit to edit a page or pages.
-P, --postblaze-edit to edit a blog post or blog posts. This is the default option.
-f, --forceblaze-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-q, --quiet-V, --verbose-h, --help-v, --versionEDITORcore.editor option is set, blaze-edit tries to use system-wide settings to decide which editor to use.
~]$ blaze-edit 10~]$ blaze-edit -p 4~]$ blaze-edit -p 2 -E nanoblaze-config”blaze-config displays or sets BlazeBlogger configuration options.
blaze-add”blaze-add adds a blog post or a page to the BlazeBlogger repository.
blaze-list”blaze-list lists blog posts or pages in the BlazeBlogger repository.
blaze-removeblaze-remove removes a blog post or a page from the BlazeBlogger repository.
blaze-remove[-fipqPV] [-bdirectory]id…blaze-remove-h|-v
blaze-remove removes a blog post or a page with the specified id from the BlazeBlogger repository.
-b directory, --blogdir directorydirectory in which the BlazeBlogger repository is placed. The default option is a current working directory.
-p, --page, --pagesblaze-remove to remove a page or pages.
-P, --post, --postsblaze-remove to remove a blog post or blog posts. This is the default option.
-f, --force-i, --interactive-q, --quiet-V, --verbose-h, --help-v, --version~]$ blaze-remove 10
Successfully removed the post with ID 10.~]$ blaze-remove -p 4
Successfully removed the page with ID 4.~]$ blaze-remove 10 4 6
Successfully removed the post with ID 10, 4 and 6.~]$blaze-remove -i 10 4 6Remove the post with ID 10 titled `Debian and Fedora Packages'?yRemove the post with ID 4 titled `BlazeBlogger 0.8.0 RC2'?yRemove the post with ID 6 titled `BlazeBlogger 0.8.1'?ySuccessfully removed the post with ID 10, 4 and 6.
blaze-config”blaze-config displays or sets BlazeBlogger configuration options.
blaze-add”blaze-add adds a blog post or a page to the BlazeBlogger repository.
blaze-list”blaze-list lists blog posts or pages in the BlazeBlogger repository.
blaze-listblaze-list lists blog posts or pages in the BlazeBlogger repository.
blaze-list[-cpqrsCPSV] [-bdirectory] [-Iid] [-aauthor] [-ttitle] [-Ttag] [-dday] [-mmonth] [-yyear] [-nnumber]blaze-list-h|-v
blaze-list lists existing blog posts or pages in the BlazeBlogger repository. Additionally, it can also display basic repository statistics.
-b directory, --blogdir directorydirectory in which the BlazeBlogger repository is placed. The default option is a current working directory.
-I id, --id idid.
-a author, --author authorauthor.
-t title, --title titletitle.
-T tag, --tag tagtag.
-d day, --day dayday of a month. The value has to be in the DD form.
-m month, --month monthmonth. The value has to be in the MM form.
-y year, --year yearyear. The value has to be in the YYYY form.
-n number, --number numbernumber of blog posts or pages to be listed.
-p, --pageblaze-list to list pages.
-P, --postblaze-list to list blog posts. This is the default option.
-S, --statsblaze-list to display statistics.
-s, --shortblaze-list to display each blog post or page information on a single line.
-r, --reverseblaze-list to display blog posts or pages in reverse order.
-c, --color-C, --no-color-q, --quiet-V, --verbose-h, --help-v, --version~]$ blaze-list
ID: 11 | 2010-07-05 | Jaromir Hradilek
Title: Join #blazeblogger on IRC
Tags: announcement
ID: 10 | 2009-12-16 | Jaromir Hradilek
Title: Debian and Fedora Packages
Tags: announcement, archlinux, debian, fedora, ubuntu
etc.~]$ blaze-list -r
ID: 1 | 2009-02-10 | Jaromir Hradilek
Title: BlazeBlogger 0.7.0
Tags: release
ID: 2 | 2009-02-11 | Jaromir Hradilek
Title: BlazeBlogger 0.7.1
Tags: release
etc.~]$ blaze-list -p
ID: 5 | 2009-02-10 | Jaromir Hradilek
Title: Downloads
ID: 4 | 2009-02-10 | Jaromir Hradilek
Title: Themes
etc.~]$ blaze-list -s
ID: 11 | 2010-07-05 | Join #blazeblogger on IRC
ID: 10 | 2009-12-16 | Debian and Fedora Packages
etc.~]$ blaze-list -Ss
There is a total number of 11 blog posts and 5 pages in the repository.blaze-config”blaze-config displays or sets BlazeBlogger configuration options.
blaze-add”blaze-add adds a blog post or a page to the BlazeBlogger repository.
blaze-makeblaze-make generates a blog from the BlazeBlogger repository.
blaze-make[-cpqrIFPTV] [-bdirectory] [-ddirectory]blaze-make-h|-v
blaze-make reads the BlazeBlogger repository, and generates a complete directory tree of static pages, including blog posts, single pages, monthly and yearly archives, tags, and even an RSS feed.
-b directory, --blogdir directorydirectory in which the BlazeBlogger repository is placed. The default option is a current working directory.
-d directory, --destdir directorydirectory in which the generated blog is to be placed. The default option is a current working directory.
-c, --no-css-I, --no-index-p, --no-posts-P, --no-pages-T, --no-tags-r, --no-rss-F, --full-paths-q, --quiet-V, --verbose-h, --help-v, --version.blaze/theme/.blaze/style/.blaze/lang/~]$ blaze-make
Done.~/public_html/ directory:
~]$ blaze-make -d ~/public_html
Done.~]$ blaze-make -F
Done.blaze-init”blaze-init creates a BlazeBlogger repository, or recovers a previously corrupted one.
blaze-config”blaze-config displays or sets BlazeBlogger configuration options.
blaze-add”blaze-add adds a blog post or a page to the BlazeBlogger repository.
blaze-logblaze-log displays the BlazeBlogger repository log.
blaze-log[-cqrsCV] [-bdirectory] [-nnumber]blaze-log-h|-v
blaze-log displays the content of the BlazeBlogger repository log.
-b directory, --blogdir directorydirectory in which the BlazeBlogger repository is placed. The default option is a current working directory.
-n number, --number numbernumber of log entries to be listed.
-s, --shortblaze-log to display each log entry on a single line.
-r, --reverseblaze-log to display log entries in reverse order.
-c, --color-C, --no-color-q, --quiet-V, --verbose-h, --help-v, --version.blaze/log~]$ blaze-log
Date: Sun Jul 25 16:48:22 2010
Edited the page with ID 5.
Date: Tue Jul 6 18:54:59 2010
Edited the page with ID 5.
etc.~]$ blaze-log -r
Date: Tue Feb 10 00:40:16 2009
Created/recovered a BlazeBlogger repository.
Date: Tue Feb 10 01:06:44 2009
Added the page with ID 1.
etc.~]$ blaze-log -rs -n 1
Tue Feb 10 00:40:16 2009 - Created/recovered a BlazeBlogger repository.blaze-init”blaze-init creates a BlazeBlogger repository, or recovers a previously corrupted one.
blaze-config”blaze-config displays or sets BlazeBlogger configuration options.
blaze.shblaze allows you to run all BlazeBlogger utilities with a single command.
blazecommand[option…]blazehelp|man[command]blaze-h|-v
blaze provides a common way to run BlazeBlogger utilities with a single command.
-h, --help-v, --versioninit, inblaze-init, a utility that either creates a BlazeBlogger repository, or recovers a previously corrupted one. Refer to Section 3.1, “blaze-init” for a full description of the command usage.
config, cf, cfgblaze-config, a utility that either displays, or sets BlazeBlogger configuration options. Refer to Section 3.2, “blaze-config” for a full description of the command usage.
addblaze-add, a utility that adds a blog post or a page to the BlazeBlogger repository. Refer to Section 3.3, “blaze-add” for a full description of the command usage.
edit, edblaze-edit, a utility that edits a blog post or a page in the BlazeBlogger repository. Refer to Section 3.4, “blaze-edit” for a full description of the command usage.
remove, rm, delblaze-remove, a utility that removes a blog post or a page from the BlazeBlogger repository. Refer to Section 3.5, “blaze-remove” for a full description of the command usage.
list, lsblaze-list, a utility that lists blog posts or pages in the BlazeBlogger repository. Refer to Section 3.6, “blaze-list” for a full description of the command usage.
make, mkblaze-make, a utility that generates a blog from the BlazeBlogger repository. Refer to Section 3.7, “blaze-make” for a full description of the command usage.
logblaze-log, a utility that displays the BlazeBlogger repository log. Refer to Section 3.8, “blaze-log” for a full description of the command usage.
helpcommand.
mancommand.
version, vs, verEDITORcore.editor option is set, blaze tries to use system-wide settings to decide which editor to use.
blaze-remove command:
~]$ blaze remove -p 4
Successfully removed the page with ID 4.blaze-config command:
~]$ blaze help config
Usage: blaze-config [-qV] [-b DIRECTORY] [-E EDITOR] OPTION [VALUE...]
blaze-config -e [-b DIRECTORY]
blaze-config -h|-v
-b, --blogdir DIRECTORY specify a directory in which the BlazeBlogger
repository is placed
-E, --editor EDITOR specify an external text editor
-e, --edit edit the configuration in a text editor
-q, --quiet do not display unnecessary messages
-V, --verbose display all messages
-h, --help display this help and exit
-v, --version display version information and exitblaze-init command:
~]$ blaze man initblaze-init”blaze-init creates a BlazeBlogger repository, or recovers a previously corrupted one.
blaze-config”blaze-config displays or sets BlazeBlogger configuration options.
blaze-add”blaze-add adds a blog post or a page to the BlazeBlogger repository.
blaze-edit”blaze-edit edits a blog post or a page in the BlazeBlogger repository.
blaze-remove”blaze-remove removes a blog post or a page from the BlazeBlogger repository.
blaze-list”blaze-list lists blog posts or pages in the BlazeBlogger repository.
blaze-make”blaze-make generates a blog from the BlazeBlogger repository.
blaze-log”blaze-log displays the BlazeBlogger repository log.
blaze.batblaze.bat allows you to run all BlazeBlogger utilities with a single command.
blazecommand[option…]blazehelp[command]
blaze.bat provides a common way to run BlazeBlogger utilities with a single command.
initblaze-init, a utility that either creates a BlazeBlogger repository, or recovers a previously corrupted one. Refer to Section 3.1, “blaze-init” for a full description of the command usage.
configblaze-config, a utility that either displays, or sets BlazeBlogger configuration options. Refer to Section 3.2, “blaze-config” for a full description of the command usage.
addblaze-add, a utility that adds a blog post or a page to the BlazeBlogger repository. Refer to Section 3.3, “blaze-add” for a full description of the command usage.
editblaze-edit, a utility that edits a blog post or a page in the BlazeBlogger repository. Refer to Section 3.4, “blaze-edit” for a full description of the command usage.
removeblaze-remove, a utility that removes a blog post or a page from the BlazeBlogger repository. Refer to Section 3.5, “blaze-remove” for a full description of the command usage.
listblaze-list, a utility that lists blog posts or pages in the BlazeBlogger repository. Refer to Section 3.6, “blaze-list” for a full description of the command usage.
makeblaze-make, a utility that generates a blog from the BlazeBlogger repository. Refer to Section 3.7, “blaze-make” for a full description of the command usage.
logblaze-log, a utility that displays the BlazeBlogger repository log. Refer to Section 3.8, “blaze-log” for a full description of the command usage.
helpcommand.
blaze-remove command:
C:\> blaze remove -p 4blaze-config command:
C:\> blaze help config
Usage: blaze-config [-qV] [-b DIRECTORY] [-E EDITOR] OPTION [VALUE...]
blaze-config -e [-b DIRECTORY]
blaze-config -h|-v
-b, --blogdir DIRECTORY specify a directory in which the BlazeBlogger
repository is placed
-E, --editor EDITOR specify an external text editor
-e, --edit edit the configuration in a text editor
-q, --quiet do not display unnecessary messages
-V, --verbose display all messages
-h, --help display this help and exit
-v, --version display version information and exitblaze-init”blaze-init creates a BlazeBlogger repository, or recovers a previously corrupted one.
blaze-config”blaze-config displays or sets BlazeBlogger configuration options.
blaze-add”blaze-add adds a blog post or a page to the BlazeBlogger repository.
blaze-edit”blaze-edit edits a blog post or a page in the BlazeBlogger repository.
blaze-remove”blaze-remove removes a blog post or a page from the BlazeBlogger repository.
blaze-list”blaze-list lists blog posts or pages in the BlazeBlogger repository.
blaze-make”blaze-make generates a blog from the BlazeBlogger repository.
blaze-log”blaze-log displays the BlazeBlogger repository log.
| Command | Description |
|---|---|
blaze-init
| Creates a new blog repository in a current directory. |
blaze-init --blogdir ~/public_html
|
Creates a new blog repository in ~/public_html/.
|
blaze-init --verbose
| Creates a new blog repository while displaying a list of created files. |
| Command | Description |
|---|---|
blaze-init
| Recovers a corrupted blog repository while keeping existing files intact. |
blaze-init --force
| Recovers a corrupted blog repository while reverting existing files to their initial state. |
blaze-init --verbose
| Recovers a corrupted blog repository while displaying a list of created files. |
| Command | Description |
|---|---|
blaze-config blog.title BlazeBlogger
| Changes the blog title to “BlazeBlogger”. |
blaze-config blog.subtitle CMS without boundaries
| Changes the blog subtitle to “CMS without boundaries”. |
blaze-config blog.description CMS without boundaries
| Changes the blog description to “CMS without boundaries”. |
blaze-config blog.keywords blazeblogger, cms, blog
| Changes the blog keywords to “blazeblogger”, “cms”, and “blog”. |
blaze-config blog.theme default.html
|
Changes the blog theme to default.html.
|
blaze-config blog.style default.css
|
Changes the style sheet to default.css.
|
blaze-config blog.lang en_US
|
Changes the blog translation to en_US.
|
blaze-config blog.posts 10
| Changes the number of blog posts to be listed on a single page to 10. |
| Command | Description |
|---|---|
blaze-config user.name Jaromír Hradílek
| Changes the default blog post author to Jaromír Hradílek. |
blaze-config user.nickname Blackened
| Changes the default blog post author's nickname to Blackened. |
blaze-config user.email jhradilek@gmail.com
|
Changes the email address to jhradilek@gmail.com
.
|
| Command | Description |
|---|---|
blaze-config feed.baseurl http://blaze.blackened.cz
| Changes the URL of the blog to http://blaze.blackened.cz. |
blaze-config feed.posts 10
| Changes the number of blog posts to be listed in the feed to 10. |
blaze-config feed.fullposts true
| Enables inclusion of the whole content of a blog post to the feed. |
| Command | Description |
|---|---|
blaze-config color.list true
|
Enables colors in the blaze-list utility output.
|
blaze-config color.log true
|
Enables colors in the blaze-log utility output.
|
| Command | Description |
|---|---|
blaze-config post.author top
| Places the blog post author above the post. |
blaze-config post.date top
| Places the date of publishing above the post. |
blaze-config post.tags bottom
| Places the blog post tags below the post. |
| Command | Description |
|---|---|
blaze-config core.doctype html
| Changes the document type to HTML. |
blaze-config core.extension html
|
Changes the file extension to html.
|
blaze-config core.encoding UTF-8
|
Changes the character encoding to UTF-8.
|
blaze-config core.editor 'gvim -f'
| Changes the external text editor to GVim. |
blaze-config core.processor 'markdown %in% > %out%'
| Configures Markdown to process each blog post or a page. |
| Command | Description |
|---|---|
blaze-add
| Opens an external text editor for you to write the blog post in. |
blaze-add release.txt changelog.txt
|
Creates blog posts from the release.txt and changelog.txt files.
|
blaze-add --editor nano
| Opens the nano text editor for you to write the blog post in. |
blaze-add --no-processor
| Opens an external text editor for you to write the blog post in while disabling processing it by an external application afterwards. |
| Command | Description |
|---|---|
blaze-add --page
| Opens an external text editor for you to write the page in. |
blaze-add --page about.txt downloads.txt
|
Creates pages from the about.txt and downloads.txt files.
|
blaze-add --page --editor nano
| Opens the nano text editor for you to write the page in. |
blaze-add --page --no-processor
| Opens an external text editor for you to write the page in while disabling processing it by an external application afterwards. |
| Command | Description |
|---|---|
blaze-edit 10
|
Opens an external text editor for you to edit the blog post with ID 10 in.
|
blaze-edit --editor nano 10
|
Opens the nano text editor for you to edit the blog post with ID 10 in.
|
blaze-edit --no-processor 10
|
Opens an external text editor for you to edit the blog post with ID 10 in while disabling processing it by an external application afterwards.
|
blaze-edit --force 10
|
Opens an external text editor for you to edit the blog post with ID 10 in, creating an empty source file in case it does not already exist.
|
| Command | Description |
|---|---|
blaze-edit --page 4
|
Opens an external text editor for you to edit the page with ID 4 in.
|
blaze-edit --page --editor nano 4
|
Opens the nano text editor for you to edit the page with ID 4 in.
|
blaze-edit --page --no-processor 4
|
Opens an external text editor for you to edit the page with ID 4 in while disabling processing it by an external application afterwards.
|
blaze-edit --page --force 4
|
Opens an external text editor for you to edit the page with ID 4 in, creating an empty source file in case it does not already exist.
|
| Command | Description |
|---|---|
blaze-remove 3 4 11
|
Removes the blog posts with ID 3, 4, and 11.
|
blaze-remove --interactive 3 4 11
|
Removes the blog posts with ID 3, 4, and 11 while requiring manual confirmation of each removal.
|
| Command | Description |
|---|---|
blaze-remove --page 2 3 4
|
Removes the pages with ID 2, 3, and 4.
|
blaze-remove --page --interactive 2 3 4
|
Removes the pages with ID 2, 3, and 4 while requiring manual confirmation of each removal.
|
| Command | Description |
|---|---|
blaze-list
| Lists all blog posts. |
blaze-list --reverse
| Lists all blog posts in reverse order. |
blaze-list --short
| Lists all blog posts, displaying each entry on a single line. |
blaze-list --number 7
| Lists the latest seven blog posts. |
blaze-list --author "Jaromir Hradilek"
| Lists blog posts written by Jaromir Hradilek. |
blaze-list --year 2009 --month 02
| Lists blog posts written in February 2009. |
blaze-list --tag release
|
Lists blog posts tagged as release.
|
blaze-list --id 11
|
Displays the blog post with ID 11.
|
| Command | Description |
|---|---|
blaze-list --pages
| Lists all pages. |
blaze-list --pages --reverse
| Lists all pages in reverse order. |
blaze-list --pages --short
| Lists all pages, displaying each entry on a single line. |
blaze-list --pages --number 3
| Lists the latest three pages. |
blaze-list --pages --id 4
|
Displays the page with ID 4.
|
| Command | Description |
|---|---|
blaze-list --stats
| Displays blog statistics. |
blaze-list --stats --short
| Displays blog statistics on a single line. |
| Command | Description |
|---|---|
blaze-make
| Generates a complete directory tree of static pages, including blog posts, single pages, monthly and yearly archives, tags, and an RSS feed. |
blaze-make --destdir ~/public_html
|
Generates a complete directory tree of static pages in the ~/public_html/ directory.
|
blaze-make --verbose
| Generates a complete directory tree of static pages while displaying a list of created files. |
blaze-make --full-paths
| Generates a complete directory tree of static pages while including page names in generated links. |
blaze-make --no-rss
| Generates a complete directory tree of static pages while omitting the creation of the RSS feed. |
| Command | Description |
|---|---|
blaze-log
| Lists all log entries. |
blaze-log --reverse
| Lists all log entries in reverse order. |
blaze-log --short
| Lists all log entries, displaying each record on a single line. |
blaze-log --number 5
| Lists the latest five log entries. |
| Form | Description |
|---|---|
<!-- START-DOCUMENT -->
| Is replaced with the document header followed by the opening HTML tag. |
<!-- END-DOCUMENT -->
| Is replaced with the closing HTML tag. |
<!-- content-type -->
| Is replaced with the Content-Type META tag. |
<!-- generator -->
| Is replaced with the Generator META tag. |
<!-- copyright -->
| Is replaced with the Copyright META tag. |
<!-- date -->
| Is replaced with the Date META tag. |
<!-- description -->
| Is replaced with the Description META tag. |
<!-- keywords -->
| Is replaced with the Keywords META tag. |
<!-- stylesheet -->
| Is replaced with the Stylesheet LINK tag. |
<!-- feed -->
| Is replaced with the RSS feed LINK tag. |
<!-- page-title -->
| Is replaced with a page title. |
<!-- title -->
| Is replaced with the blog title. |
<!-- subtitle -->
| Is replaced with the blog subtitle. |
<!-- name -->
| Is replaced with the author's name. |
<!-- nickname -->
| Is replaced with the author's nickname. |
<!-- e-mail -->
| Is replaced with the author's email. |
<!-- year -->
| Is replaced with the current year. |
<!-- tags -->
| Is replaced with the list of tags. |
<!-- archive -->
| Is replaced with the list of months. |
<!-- pages -->
| Is replaced with the list of pages. |
<!-- posts -->
| Is replaced with the list of recent blog posts. |
<!-- content -->
| Is replaced with the actual content. |
%root%
| Is replaced with a relative path to the root directory of the blog. |
%home%
| Is replaced with a relative path to the index page of the blog. |
%page[
|
Is replaced with a relative path to a page with the given id.
|
%post[
|
Is replaced with a relative path to a blog post with the given id.
|
%tag[
|
Is replaced with a relative path to a tag with the given name.
|
| Form | Description |
|---|---|
post
| A H2 tag containing the title of a blog post or a page. |
section
| A DIV tag containing a section name. |
information
| A DIV tag containing blog post meta information that are displayed above the post. |
post-footer
| A DIV tag containing blog post meta information that are displayed below the post. |
date
| A SPAN tag containing a date of publishing. |
author
| A SPAN tag containing an author of a blog post. |
tags
| A SPAN tag containing a list of attached tags. |
previous
| A DIV tag containing a link to a page with older blog posts. |
next
| A DIV tag containing a link to a page with newer blog posts. |
more
| An A tag containing a “Read more” link. |
Copyright (C)YEARYOUR NAME. 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 in the section entitled "GNU Free Documentation License".
with the Invariant Sections beingLIST THEIR TITLES, with the Front-Cover Texts beingLIST, and with the Back-Cover Texts beingLIST.
| Revision History | |||
|---|---|---|---|
| Revision 1-1 | 22 February 2011 | ||
| |||
| Revision 1-0 | 18 February 2011 | ||
| |||
| Revision 0 | 3 July 2010 | ||
| |||