* Add processed date to aggregate preprocessor directive status output.
[ikiwiki.git] / doc / news / version_1.22.mdwn
1 Version 1.22 of ikiwiki is released. Some important news items for this
2 release:
3
4 Due to some changes in the CSS, wikis should be rebuilt on upgrade to this
5 version. If you listed your wiki in /etc/ikiwiki/wikilist this will be done
6 automatically when the Debian package is upgraded. Or use ikiiki-mass-rebuild
7 to force a rebuild.
8
9 If you have modified versions of ikiwiki's html templates, you will need
10 to update your templates to link to the stylesheet file using
11 "<TMPL_VAR BASEURL>style.css" instead of the old method which used
12 STYLEURL.
13
14 There have also been some changes to the plugin interface:
15 Any plugins that use santize, htmlize, or format hooks will need to be
16 updated for this version of ikiwiki since these hooks have been changed
17 to use named parameters.
18
19 Here's the full list of changes:
20
21    * Change how the stylesheet url is determined in the templates: Remove
22      STYLEURL and add BASEURL to all templates (some already had it). This
23      new more general variable can be used to link to other things (eg, images)
24      from the template, as well as stylesheets.
25    * Fix a bug introduced last version to do with nested inlines.
26    * Allow preprocessor directives to span multiple lines, both to make
27      long ones with lots of values easier to write, and to allow for ones with
28      multi-line quoted values.
29    * Allow preprocessor directives to contain python-like triple-quoted
30      text blocks, for easy nesting of quotes inside.
31    * Add a template plugin.
32    * Make pagespec merge code smarter about merging duplicate pagespecs.
33    * Patch from Jordà Polo to make Setup::Standard support hashes in config
34      files.
35    * Change order of linkify and preprocess; first preprocess and then linkify.
36      This allows passing a wikilink inside a parameter to a preprocessor
37      directive without it being expanded to html, and leaking out of the
38      parameter, which had required some non-obvious use of triple-quoting
39      to avoid. Note that any preprocessor plugins that output something
40      that looks like a wikilink will now have it treated as such; AFAIK
41      this doesn't change any behavior though except for the template plugin.
42    * Enable preprocessor directives when previewing an edit.
43    * Make all pages pull in a local.css style sheet, if present. This won't
44      be included in ikiwiki, but can be created to make local styling changes
45      w/o needing to merge in every new change to the distributed style.css.
46    * Use DESTDIR and not PREFIX to specify installation prefix for packaging.
47    * Support running "perl Makefile.PL PREFIX=foo" to build ikiwiki to run
48      from a different directory.
49    * Generalised preprocesser loop protection code.
50    * Patch from James Westby to allow a description to be set for rss feeds.
51    * Patch from James Westby to add a template for the search form.
52    * Added a ddate plugin.
53    * Patch from James Westby to add a --sslcookie switch, which forces
54      cookies to only be sent over ssl connections to avoid interception.
55    * Fix preferences page on anonok wikis; still need to sign in to get
56      to the preferences page.
57    * Add toc (table of contents) plugin.
58    * Change htmlize, format, and sanitize hooks to use named parameters.
59    * Patch from James Westby to add an actions option to inline; this
60      adds Edit and Discussion links at the end of blog entries.
61    * Due to some css changes, you'll want to rebuild your wiki on upgrade
62      to this version. Will be handled automatically by the deb.