blaze-list(1)

NAME

blaze-list - lists blog posts or pages in the BlazeBlogger repository

SYNOPSIS

blaze-list [-cpqrsCPSV] [-b directory] [-I id] [-a author] [-t title] [-T tag] [-d day] [-m month] [-y year] [-n number]

blaze-list -h|-v

DESCRIPTION

blaze-list lists existing blog posts or pages in the BlazeBlogger repository. Additionally, it can also display basic repository statistics.

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.

-I id, --id id

Allows you to display a single blog post or a page with the specified id.

-a author, --author author

Allows you to list blog posts or pages by the selected author.

-t title, --title title

Allows you to list blog posts or pages with matching title.

-T tag, --tag tag

Allows you to list blog posts or pages with matching tag.

-d day, --day day

Allows you to list blog posts or pages from the specified day of a month. The value has to be in the "DD" form.

-m month, --month month

Allows you to list blog posts or pages from the specified month. The value has to be in the "MM" form.

-y year, --year year

Allows you to list blog posts or pages from the specified year. The value has to be in the "YYYY" form.

-n number, --number number

Allows you to specify a number of blog posts or pages to be listed.

-p, --page

Tells blaze-list to list pages.

-P, --post

Tells blaze-list to list blog posts. This is the default option.

-S, --stats

Tells blaze-list to display statistics.

-s, --short

Tells blaze-list to display each blog post or page information on a single line.

-r, --reverse

Tells blaze-list to display blog posts or pages in reverse order.

-c, --color

Enables colored output. When supplied, this option overrides the relevant configuration option.

-C, --no-color

Disables colored output. When supplied, this option overrides the relevant configuration option.

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

EXAMPLE USAGE

List all blog post:

  ~]$ 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
  etc.

List all blog post in reverse order:

  ~]$ 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.

List all pages:

  ~]$ blaze-list -p
  ID: 5 | 2009-02-10 | Jaromir Hradilek
      Title: Downloads
  ID: 4 | 2009-02-10 | Jaromir Hradilek
      Title: Themes
  etc.

List each blog post on a single line:

  ~]$ blaze-list -s
  ID: 11 | 2010-07-05 | Join #blazeblogger on IRC
  ID: 10 | 2009-12-16 | Debian and Fedora Packages
  etc.

Display a short version of blog statistics:

  ~]$ blaze-list -Ss
  There is a total number of 11 blog posts and 5 pages in the repository.

SEE ALSO

blaze-config(1), blaze-add(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) 2009-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.