---
name: "blaze-list"
section: "1"
platform: "linux"
package: "blazeblogger"
version: "1.2.0-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/blaze-list"
---

# blaze-list(1)

lists blog posts or pages in the BlazeBlogger repository

## 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-config/1.md), [**blaze-add**(1)](/blaze-add/1.md)

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