directive

Directives are similar to a WikiLink in form, except they begin with ! and may contain parameters. The general form is:

[[!directive  param="value" param="value"]]

This gets expanded before the rest of the page is processed, and can be used to transform the page in various ways.

The quotes around values can be omitted if the value is a simple word. Also, some directives may use parameters without values, for example:

[[!tag  foo]]

A directive does not need to all be on one line, it can be wrapped to multiple lines if you like:

[[!directive  foo="baldersnatch"
bar="supercalifragilisticexpialidocious" baz=11]]

Also, multiple lines of quoted text can be used for a value. To allow quote marks inside the quoted text, delimit the block of text with triple-double-quotes or triple-single-quotes:

[[!directive  text="""
1. "foo"
2. "bar"
3. "baz"
""" othertext='''
1. 'quux'
2. "foo"
''']]

If you want to put text with triple quotes into a parameter value, you can use perl-style here-doc syntax, even nesting it like this:

[[!directive  text=<<OUTER
[[!otherdirective <<INNER
inner text
INNER]]
outer text
OUTER]]

ikiwiki also has an older syntax for directives, which requires a space in directives to distinguish them from wikilinks. This syntax has several disadvantages: it requires a space after directives with no parameters (such as [[pagecount ]]), and it prohibits spaces in wikilinks. ikiwiki now provides the !-prefixed syntax shown above as default. However, ikiwiki still supports wikis using the older syntax, if the prefix_directives option is disabled.

Here is a list of currently available directives in this wiki:

Want to be notified when new comments are posted on this page? Click on the RSS button after you add a comment to subscribe to the comment feed.

Add a comment


Wetknee home Homesteading ebook Microbusiness ebook Appalachian ecology ebook Chicken ebooks Search News Recent comments Blog archive Tags Contact us Links Innovations: Deer deterrent Chicken waterer	directive Directives are similar to a WikiLink in form, except they begin with `!` and may contain parameters. The general form is: `[[!directive param="value" param="value"]]` This gets expanded before the rest of the page is processed, and can be used to transform the page in various ways. The quotes around values can be omitted if the value is a simple word. Also, some directives may use parameters without values, for example: `[[!tag foo]]` A directive does not need to all be on one line, it can be wrapped to multiple lines if you like: `[[!directive foo="baldersnatch" bar="supercalifragilisticexpialidocious" baz=11]]` Also, multiple lines of quoted text can be used for a value. To allow quote marks inside the quoted text, delimit the block of text with triple-double-quotes or triple-single-quotes: `[[!directive text=""" 1. "foo" 2. "bar" 3. "baz" """ othertext=''' 1. 'quux' 2. "foo" ''']]` If you want to put text with triple quotes into a parameter value, you can use perl-style here-doc syntax, even nesting it like this: `[[!directive text=<<OUTER [[!otherdirective <<INNER inner text INNER]] outer text OUTER]]` ikiwiki also has an older syntax for directives, which requires a space in directives to distinguish them from wikilinks. This syntax has several disadvantages: it requires a space after directives with no parameters (such as `[[pagecount ]]`), and it prohibits spaces in wikilinks. ikiwiki now provides the `!`-prefixed syntax shown above as default. However, ikiwiki still supports wikis using the older syntax, if the `prefix_directives` option is disabled. Here is a list of currently available directives in this wiki: brokenlinks calendar comment commentmoderation date edittemplate if img inline listdirectives map meta more orphans pagecount pagestats poll progress shortcut sidebar table tag taglink template toc toggle toggleable version Want to be notified when new comments are posted on this page? Click on the RSS button after you add a comment to subscribe to the comment feed. Add a comment