X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/f617ad857fe20659253b45808b504957459ea0cd..b6774bc6afac48e2c0a122647edc1485e7174a6e:/doc/plugins/conditional.mdwn?ds=sidebyside diff --git a/doc/plugins/conditional.mdwn b/doc/plugins/conditional.mdwn index a8dd21589..27a99bb7c 100644 --- a/doc/plugins/conditional.mdwn +++ b/doc/plugins/conditional.mdwn @@ -1,41 +1,5 @@ -[[template id=plugin name=conditional core=1 author="[[Joey]]"]] -[[tag type/format]] +[[!template id=plugin name=conditional core=1 author="[[Joey]]"]] +[[!tag type/special-purpose]] -With this plugin, you can make text be conditionally displayed on a page. -For example: - - \[[if test="enabled(smiley)" - then="The smiley plugin is enabled :-)" - else="No smiley plugin here.."]] - -If the specified `test` succeeds, the `then` text will be displayed, -otherwise the `else` text will be displayed. The `else` part is optional. - -The `then` and `else` values can include any markup that would be allowed -in the wiki page outside the template. Triple-quoting the values even allows -quotes to be included. - -The `test` is a [[PageSpec]]; if it matches any page in the wiki then it -succeeds. So you can do things like testing for the existence of a page or -pages, testing to see if any pages were created in a given month, and so -on. The regular [[PageSpec]] syntax is expanded with the following -additional tests: - -* enabled(plugin) - - Tests whether the specified plugin is enabled. - -* sourcepage(glob) - - Tests whether the glob matches the name of the page that contains the - conditional. - -* destpage(glob) - - Tests whether the glob matches the name of the page that is being built. - That might be different than the name of the page that contains the - conditional, if it's being inlined into another page. - -* included() - - Tests whether the page is being included onto another page. +This plugin provides the [[ikiwiki/directive/if]] [[ikiwiki/directive]]. +With this directive, you can make text be conditionally displayed on a page.