Die calendar-Anweisung wird durch die calendar-Erweiterung bereitgestellt.

Diese Anweisung zeigt einen Kalender, ähnlich denen, die auf manchen Blogs angezeigt werden.

Beispiele

[[!calendar  ]]

[[!calendar  type="month" pages="blog/* and !*/Discussion"]]

[[!calendar  type="year" year="2005" pages="blog/* and !*/Discussion"]]

Einrichtung

Der Kalender ist im Wesentlichen eine schicke Schnittstelle zu einem Archiv mit früheren Seiten und wird normalerweise für Blogs verwendet. Er kann einen Kalender für einen angegebenen Monat erzeugen, oder eine Liste der Monate eines angegebenen Jahres. Der Kalender im Jahresformat enthält einfach Links zu den Archivseiten mit Namen wie archiv/2007 (für ganz 2007) und archiv/2007/01 (für Januar 2007).

Während calendar-Anweisungen überall im Wiki verwendet werden können, auch in der Sidebar, muss man auch die Archiv-Seiten anlegen. Dort wird typischerweise diese Anweisung verwendet, um einen Kalender anzuzeigen, und außerdem die Seiten aus dem entsprechenden Zeitraum über inline eingebunden.

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.

Ein Beispiel-Eintrag in crontab:

0 0 * * * ikiwiki-calendar ~/ikiwiki.setup "posts/* and !*/Discussion"

Verwendung

  • type - Hiermit wird die Art des zu erzeugenden Kalenders angegeben. Kann entweder "month" oder "year" sein. Vorgeingestellt ist die Monatsansicht.
  • pages - Gibt die PageSpec der Seiten an, auf die aus dem Monatskalender verwiesen werden soll. Voreingestellt ist "*".
  • archivebase - Configures the base of the archives hierarchy. The default is "archives". Note that this default can also be overridden 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.
  • 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 range 1..12. Used only for the month view calendar, and defaults to the current month. Can also use -1 to refer to last month, and so on.
  • week_start_day - Eine Zahl aus dem Bereich 0 bis 6, die den Wochentag angibt, mit dem ein Monatskalender anfängt. 0 ist Sonntag, 1 ist Montag, und so weiter. Voreingestellt ist 0, also Sonntag.
  • months_per_row - In the year calendar, number of months to place in each row. Defaults to 3.