blaze-list

BLAZE-LIST(1)             BlazeBlogger Documentation             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.



Version 1.2.0                     2011-02-18                     BLAZE-LIST(1)