diff options
author | Simon McVittie <smcv@debian.org> | 2014-11-26 09:13:44 +0000 |
---|---|---|
committer | Simon McVittie <smcv@debian.org> | 2014-11-26 09:13:44 +0000 |
commit | 96566c33a79a1628a75bc573d924fd3be8b6b37d (patch) | |
tree | 827f50a9bc46d076c3966e6f9ab5545b93d2010f /doc/ikiwiki | |
parent | eb7baeb196703a455221751bda4b10c149b84b53 (diff) | |
parent | 473bcbe7a42a4168cab82ed12185817248de045f (diff) | |
download | ikiwiki-96566c33a79a1628a75bc573d924fd3be8b6b37d.tar ikiwiki-96566c33a79a1628a75bc573d924fd3be8b6b37d.tar.gz |
Merge remote-tracking branch 'spalax/calendar-autocreate'
Diffstat (limited to 'doc/ikiwiki')
-rw-r--r-- | doc/ikiwiki/directive/calendar.mdwn | 20 |
1 files changed, 14 insertions, 6 deletions
diff --git a/doc/ikiwiki/directive/calendar.mdwn b/doc/ikiwiki/directive/calendar.mdwn index cb40f884e..412285c97 100644 --- a/doc/ikiwiki/directive/calendar.mdwn +++ b/doc/ikiwiki/directive/calendar.mdwn @@ -25,14 +25,22 @@ in the sidebar, you'll also need to create these archive pages. They typically use this directive to display a calendar, and also use [[inline]] to display or list pages created in the given time frame. -The `ikiwiki-calendar` command can be used to automatically generate the -archive pages. It also refreshes the wiki, updating the calendars to -highlight the current day. This command is typically run at midnight from -cron. +## Generating archive pages + +If [[option|plugins/calendar]] `calendar_autocreate` is not set, the +[[ikiwiki-calendar]] command can be used to automatically generate the archive +pages. It also refreshes the wiki, updating the calendars to highlight the +current day. This command is typically run at midnight from cron. An example crontab: - 0 0 * * * ikiwiki-calendar ~/ikiwiki.setup "posts/* and !*/Discussion" + 0 0 * * * ikiwiki-calendar ~/ikiwiki.setup "posts/* and !*/Discussion" + + +With [[setup option|plugins/calendar]] `calendar_autocreate`, all this work is +done by `ikiwiki` itself. Thus, the crontab command can be replaced by: + + 0 0 * * * ikiwiki --setup ~/ikiwiki.setup --refresh ## usage @@ -45,7 +53,7 @@ An example crontab: for the whole wiki by setting `archivebase` in ikiwiki's setup file. Calendars link to pages under here, with names like "2010/04" and "2010". These pages can be automatically created using the - `ikiwiki-calendar` program. + `calendar_autocreate` [[setup option|plugins/calendar]]. * `year` - The year for which the calendar is requested. Defaults to the current year. Can also use -1 to refer to last year, and so on. * `month` - The numeric month for which the calendar is requested, in the |