# NAME ikiwiki-calendar - create calendar archive pages # SYNOPSIS ikiwiki-calendar [-f] your.setup [pagespec] [startyear [endyear]] # DESCRIPTION `ikiwiki-calendar` creates pages that use the [[ikiwiki/directive/calendar]] directive, allowing the archives to be browsed one month at a time, with calendar-based navigation. You must specify the setup file for your wiki. The pages will be created inside its `srcdir`, beneath the `archivebase` directory used by the calendar plugin (default "archives"). To control which pages are included on the calendars, a [[ikiwiki/PageSpec]] can be specified. The default is all pages, or the pages specified by the `comments_pagespec` setting in the config file. A pagespec can also be specified on the command line. To limit it to only posts in a blog, use something like "posts/* and !*/Discussion". It defaults to creating calendar pages for the current year. If you specify a year, it will create pages for that year. Specify a second year to create pages for a span of years. Existing pages will not be overwritten by this command by default. Use the `-f` switch to force it to overwrite any existing pages. # CRONTAB While this command only needs to be run once a year to update the archive pages for each new year, you are recommended to set up a cron job to run it daily, at midnight. Then it will also update the calendars to highlight the current day. An example crontab: 0 0 * * * ikiwiki-calendar ~/ikiwiki.setup 'posts/* and !*/Discussion' # TEMPLATES This command uses two [[templates]] to generate the pages, `calendarmonth.tmpl` and `calendaryear.tmpl`. # AUTHOR Joey Hess Warning: this page is automatically made into ikiwiki-calendar's man page, edit with care