From 1b03a06c8c0dbf59469ff30d09a0c9c3051e0b00 Mon Sep 17 00:00:00 2001 From: Josh Triplett Date: Sun, 27 Jan 2008 16:13:54 -0800 Subject: Add new preprocessor directive syntax¸ using a '!' prefix. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add a prefix_directives option to the setup file to turn this syntax on; currently defaults to false, for backward compatibility. Support optional '!' prefix even with prefix_directives off, and use that in the underlay to support either setting of prefix_directives. Add NEWS entry with migration information. --- debian/NEWS | 33 +++++++++++++++++++++++++++++++++ debian/changelog | 6 ++++++ 2 files changed, 39 insertions(+) (limited to 'debian') diff --git a/debian/NEWS b/debian/NEWS index 5515bbd7d..461a81977 100644 --- a/debian/NEWS +++ b/debian/NEWS @@ -1,3 +1,36 @@ +ikiwiki (2.21) unstable; urgency=low + + ikiwiki now has an new syntax for preprocessor directives, using the + prefix '!': + + [[!directive ...]] + + This new syntax no longer relies on spaces to distinguish between + wikilinks and preprocessor directives. Thus, wikilinks can use spaces + in their link text, and preprocessor directives without arguments (such + as "toc") need not use a trailing space. + + To enable the new syntax, set prefix_directives to true in your ikiwiki + config. For backward compatibility with existing wikis, + prefix_directives currently defaults to false. In ikiwiki 3.0, + prefix_directives will default to true, and wikis which have not yet + converted to the new syntax will need to set prefix_directives to false + in their setup files. + + To convert your wiki to the new syntax, ikiwiki provides a new script + ikiwiki-prefix-directives. It will convert preprocessor directives in + all files given on the command line. To convert an entire wiki: + + find wikidir/ -type f -name '*.mdwn' -print0 | xargs -0 ikiwiki-prefix-directives + + Even with prefix_directives disabled, ikiwiki now allows an optional '!' + prefix on preprocessor directives (but still requires a space). Thus, a + directive which uses a '!' prefix and contains a space will work with + ikiwiki 2.21 and newer, regardless of the value of prefix_directives. + This allows the underlay to work with all ikiwikis. + + -- Josh Triplett Sat, 26 Jan 2008 16:26:47 -0800 + ikiwiki (2.20) unstable; urgency=low The template plugin has begin to htmlize the variables passed to templates. diff --git a/debian/changelog b/debian/changelog index 50196b077..e81cc21ad 100644 --- a/debian/changelog +++ b/debian/changelog @@ -14,6 +14,12 @@ ikiwiki (2.21) UNRELEASED; urgency=low [ Josh Triplett ] * Add trailing comma to commented-out umask in sample ikiwiki.setup, so that uncommenting it does not break the setup file. + * Add new preprocessor directive syntax¸ using a '!' prefix. Add a + prefix_directives option to the setup file to turn this syntax on; + currently defaults to false, for backward compatibility. Support + optional '!' prefix even with prefix_directives off, and use that in + the underlay to support either setting of prefix_directives. Add NEWS + entry with migration information. -- Joey Hess Fri, 11 Jan 2008 15:09:37 -0500 -- cgit v1.2.3