summaryrefslogtreecommitdiff
path: root/ikiwiki/preprocessordirective.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/preprocessordirective.mdwn')
-rw-r--r--ikiwiki/preprocessordirective.mdwn45
1 files changed, 26 insertions, 19 deletions
diff --git a/ikiwiki/preprocessordirective.mdwn b/ikiwiki/preprocessordirective.mdwn
index 660d411..743c0d9 100644
--- a/ikiwiki/preprocessordirective.mdwn
+++ b/ikiwiki/preprocessordirective.mdwn
@@ -1,32 +1,39 @@
-Preprocessor-direktiver ligner et [[WikiLink]] i form, på nær at de indeholder
-mellemrum og parametre. Generelt er formen:
+[[!meta robots="noindex, follow"]]
+Preprocessor directives are similar to a [[WikiLink]] in form, except they
+begin with `!` and may contain parameters. The general form is:
- \[[directive param="værdi" param="værdi"]]
+ \[[!directive param="value" param="value"]]
-Dette udvides før resten af siden udarbejdes, og kan bruges til at omforme siden
-på forskellige måder.
+This gets expanded before the rest of the page is processed, and can be used
+to transform the page in various ways.
-Citationen omkring værdier kan udelades hvis værdien er et simpelt ord. Desuden
-kan nogle direktiver bruge parametre uden værdier. Eksempel:
+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]]
+ \[[!tag foo]]
-Bemærk at hvis et preprocessor-directiv ingen parametre har, skal der puttes et
-mellemrum efter dets navn, for at undgå forveksling med et [[WikiLink]]. Eksempel:
-
- \[[pagecount ]]
-
-Et preprocessor-directiv behøves ikke at holdes på een linje, det kan godt brede
-sig over flere linjer hvis du har lyst:
+A preprocessor directive does not need to all be on one line, it can be
+wrapped to multiple lines if you like:
- \[[directive foo="baldersnatch"
+ \[[!directive foo="baldersnatch"
bar="supercalifragalisticexpealadocious" baz=11]]
-Flere linjer *citeret* tekst kan også bruges som værdi. For at tillade citation
-i den citerede tekst skal du adskille blokken med trippel-citat:
+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-quotes:
- \[[directive text="""
+ \[[!directive text="""
1. "foo"
2. "bar"
3. "baz"
"""]]
+
+ikiwiki also has an older syntax for preprocessor directives, which requires a
+space in directives to distinguish them from [[wikilinks|wikilink]]. This
+syntax has several disadvantages: it requires a space after directives with no
+parameters (such as `\[[pagecount ]]`), and it prohibits spaces in
+[[wikilinks|wikilink]]. ikiwiki now provides the `!`-prefixed syntax shown
+above as the preferred alternative. However, ikiwiki still supports wikis
+using the older syntax, if the `prefix_directives` option is not enabled.
+For backward compatibility with existing wikis, this option currently
+defaults to off, so ikiwiki supports the old syntax.