X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/127bceef5b4799e58cb068043e49ed16a3ec840d..f9fc77ce55e13297387ab391187a07ab0265f954:/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.