From: Joey Hess Date: Tue, 27 Apr 2010 04:02:49 +0000 (-0400) Subject: format X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/commitdiff_plain/9daf3db277c31d3ce434253af2dfb7e0e436b5f9?ds=sidebyside format --- diff --git a/doc/news/version_3.20100427.mdwn b/doc/news/version_3.20100427.mdwn index 5fe732f87..1701fd670 100644 --- a/doc/news/version_3.20100427.mdwn +++ b/doc/news/version_3.20100427.mdwn @@ -1,36 +1,44 @@ -News for ikiwiki 3.20100427: +This version of ikiwiki has a lot of changes that you need to know about. - This version of ikiwiki has a lot of changes that you need to know about. - Now you can include customised versions of templates in the source - of your wiki. (For example, templates/page.tmpl.) When these templates - are changed, ikiwiki will automatically rebuild pages that use them. - Allowing untrusted users to upload attachments with the ".tmpl" - extension is not recommended, as that allows anyone to change - a wiki's templates. - The --getctime switch is renamed to --gettimes, and it also gets the - file modification time. And it's a lot faster (when using git). But - the really important change is, you don't have to remember to use this - switch. Now ikiwiki will do it when it needs to. - At last, the "tagged()" pagespec only matches tags, not regular wikilinks. - If your wiki accidentially relied on the old, buggy behavior, you might - need to change its pagespecs to use "link()". - Many of your wishes have been answered: Now tag pages can automatically be - created when new tags are used. This feature is enabled by default if you - have configured a tagbase. It can be turned on or off using the - tag\_autocreate setting. - These changes may also affect some users: - * The title\_natural sort method (as used by the inline directive, etc) - has been moved to the new sortnaturally plugin, which is not enabled - by default since it requires the Sort::Naturally perl module. - * TMPL\_INCLUDE is no longer supported in any template used by ikiwiki. - It used to be allowed in certian templates, but not in others. - * The add\_templates option has been removed from the underlay plugin. - If you used this option, you can instead use templates/ subdirectories - inside underlay directories added by the add\_underlays option. - Due to the above and other changes, all wikis need to be rebuilt on - upgrade to this version. If you listed your wiki in /etc/ikiwiki/wikilist - this will be done automatically when the Debian package is upgraded. Or - use ikiwiki-mass-rebuild to force a rebuild. +Now you can include customised versions of templates in the source +of your wiki. (For example, templates/page.tmpl.) When these templates +are changed, ikiwiki will automatically rebuild pages that use them. + +Allowing untrusted users to upload attachments with the ".tmpl" +extension is not recommended, as that allows anyone to change +a wiki's templates. + +The --getctime switch is renamed to --gettimes, and it also gets the +file modification time. And it's a lot faster (when using git). But +the really important change is, you don't have to remember to use this +switch. Now ikiwiki will do it when it needs to. + +At last, the "tagged()" pagespec only matches tags, not regular wikilinks. +If your wiki accidentially relied on the old, buggy behavior, you might +need to change its pagespecs to use "link()". + +Many of your wishes have been answered: Now tag pages can automatically be +created when new tags are used. This feature is enabled by default if you +have configured a tagbase. It can be turned on or off using the +`tag_autocreate` setting. + +These changes may also affect some users: + +* The `title_natural` sort method (as used by the inline directive, etc) + has been moved to the new sortnaturally plugin, which is not enabled + by default since it requires the Sort::Naturally perl module. + +* `TMPL_INCLUDE` is no longer supported in any template used by ikiwiki. + It used to be allowed in certian templates, but not in others. + +* The `add_templates` option has been removed from the underlay plugin. + If you used this option, you can instead use templates/ subdirectories + inside underlay directories added by the `add_underlays` option. + +Due to the above and other changes, all wikis need to be rebuilt on +upgrade to this version. If you listed your wiki in /etc/ikiwiki/wikilist +this will be done automatically when the Debian package is upgraded. Or +use ikiwiki-mass-rebuild to force a rebuild. ikiwiki 3.20100427 released with [[!toggle text="these changes"]] [[!toggleable text=""" @@ -108,4 +116,4 @@ ikiwiki 3.20100427 released with [[!toggle text="these changes"]] rebuild on upgrade to this version. * Fix removal of rendered files in rebuild mode. * Add page() PageSpec, which is like glob() but matches only pages, - not other files."""]] \ No newline at end of file + not other files."""]]