From b3a7bf61d5ad05cdc86950b6fcc564a5c7e5917d Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Fri, 29 Feb 2008 23:26:44 -0500 Subject: formatting --- doc/news/version_2.40.mdwn | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/news/version_2.40.mdwn b/doc/news/version_2.40.mdwn index 09acb369b..03dc983c2 100644 --- a/doc/news/version_2.40.mdwn +++ b/doc/news/version_2.40.mdwn @@ -2,21 +2,27 @@ News for ikiwiki 2.40: ikiwiki now has an new syntax for preprocessor directives, using the prefix '!': - * [[!directive ...]] + + \[[!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-transition. 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-transition prefix\_directives + + find wikidir/ -type f -name '*.mdwn' -print0 | xargs -0 ikiwiki-transition 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 @@ -74,4 +80,4 @@ ikiwiki 2.40 released with [[toggle text="these changes"]] * inline: When forcing urls absolute for rss feeds, skip mailto and other such urls. * ikiwiki-makerepo: Don't fail if the third argument ends in a slash. - * Allow colons in URLs after the first slash. (Adeodato Simó)"""]] \ No newline at end of file + * Allow colons in URLs after the first slash. (Adeodato Simó)"""]] -- cgit v1.2.3