Usage — Feeds

gresiblos can generate Atom and RSS 2.0 feeds listing the read entries.

An Atom feed is generated using:

gresiblos blog/*.txt --atom-output <FILE_NAME>

Where <FILE_NAME> is the name of the file the Atom feed will be written to.

An RSS 2.0 feed is generated using:

gresiblos blog/*.txt --rss-output <FILE_NAME>

Where <FILE_NAME> is the name of the file the RSS 2.0 feed will be written to.

You can write both in one batch:

gresiblos blog/*.txt --atom-output <FILE_NAME1> --rss-output <FILE_NAME2>

Yet, several important information about the feeds will be missing. Some things have to be set on the command line additionally. A complete call that yields in valid Atom and RSS 2.0 should have the following feed information set:

gresiblos blog/*.txt --atom-output <FILE_NAME1> --rss-output <FILE_NAME2>
    --feed-title "Collected Notes"
    --feed-site http://john.doe.org
    --feed-description "Notes collected in the past time"
    --feed-editor-email john@doe.org
    --feed-editor-name "John Doe"
    --feed-copyright "(c) John Doe 2026"

You may want to use a configuration file:

gresiblos blog/*.txt -c blog.cfg

The according configuration file blog.cfg would look like this:

[gresiblos]
atom_output=atom-example.xml
rss_output=rss-example.xml
feed_title=Collected Notes
feed_site=http://john.doe.org
feed_description=Notes collected in the past time
feed_editor_email=john@doe.org
feed_editor_name=John Doe
feed_copyright=(c) John Doe 2026

The values are inserted into the respective feeds as given in the next table.