NAME

Chronicle::Plugin::Generate::Archive - Generate archive pages.

DESCRIPTION

This module will be invoked automatically when your site is built via the on_generate hook which Chronicle provides.

It is responsible for creating the top-level /archive/ pages which contain a list of previously created posts.

METHODS

Now follows documentation on the available methods.

on_generate

The on_generate method is automatically invoked to generate output pages. This particular plugin method is invoked after any on_initiate methods which might be present.

This method is responsible for generating the archive-output, which includes two sets of pages:

/archive/index.html

This is created using the archive_index.tmpl theme-template, and contains a list of all the year/month pairs which have blog-posts present for them.

/archive/$year/$mon/index.html

This is created for each distinct year/month pair, from the theme-template archive.tmpl

If either template is missing then this plugin will skip that part of the generation.

LICENSE

This module is free software; you can redistribute it and/or modify it under the terms of either:

a) the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version, or

b) the Perl "Artistic License".

AUTHOR

Steve Kemp <steve@steve.org.uk>