X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/127bceef5b4799e58cb068043e49ed16a3ec840d..9cee2962e01ef0538cc8498951867a543f91b47d:/doc/plugins/conditional.mdwn diff --git a/doc/plugins/conditional.mdwn b/doc/plugins/conditional.mdwn index ba1cf9bb2..27a99bb7c 100644 --- a/doc/plugins/conditional.mdwn +++ b/doc/plugins/conditional.mdwn @@ -1,47 +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. - -If you want the [[PageSpec]] to only match against the page that -contains the conditional, rather than matching against all pages in the -wiki, set the "all" parameter to "no". - -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.