Merge commit 'smcv/underlay'
[ikiwiki] / doc / plugins / prettydate.mdwn
1 [[!template id=plugin name=prettydate author="[[Joey]]"]]
2 [[!tag type/date]]
3
4 Enabling this plugin changes the dates displayed on pages in the wiki to
5 a format that is nice and easy to read. Examples: "late Wednesday evening, 
6 February 14th, 2007", "at midnight, March 15th, 2007"
7
8 The names given to each of the hours in the day can be customised by
9 setting the `timetable` configuration variable in ikiwiki's setup file.
10 The default value of this configuration value can be seen near the top of
11 `prettydate.pm`. Note that an hour can be left blank, to make it display the
12 same as the hour before. Midnight, noon, and teatime are all hardcoded,
13 since they do not occupy the whole hour.
14
15 The format used for the date can be customised using the `prettydateformat`
16 configuration variable in the setup file. `%X` will be expanded to the
17 prettified time value. The default prettydateformat is `"%X, %B %o, %Y"`.
18
19 This plugin uses the [[!cpan TimeDate]] perl module.