summaryrefslogtreecommitdiff
path: root/ikiwiki/preprocessordirective.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/preprocessordirective.mdwn')
-rw-r--r--ikiwiki/preprocessordirective.mdwn41
1 files changed, 21 insertions, 20 deletions
diff --git a/ikiwiki/preprocessordirective.mdwn b/ikiwiki/preprocessordirective.mdwn
index 8fe073d..743c0d9 100644
--- a/ikiwiki/preprocessordirective.mdwn
+++ b/ikiwiki/preprocessordirective.mdwn
@@ -1,25 +1,26 @@
[[!meta robots="noindex, follow"]]
-Preprocessor-direktiver ligner et [[WikiLink]] i form, på nær at de begynder
-med `!` og kan indeholde parametre. Generelt er formen:
+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]]
-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"
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="""
1. "foo"
@@ -27,12 +28,12 @@ citation i den citerede tekst skal du adskille blokken med trippel-citat:
3. "baz"
"""]]
-Ikiwiki har også en ældre syntaks til preprocessordirektiver, som kræver et
-mellemrum i direktiver for at skelne dem fra [[wikilinks|wikilink]]. Denne
-syntaks har flere ulemper: den kræver et mellemrum efter direktiver uden
-parametre (såsom `\[[pagecount ]]`), og den forbyder mellemrum i
-[[wikilinks|wikilink]]. Ikiwiki har nu den `!`-foranstillede syntaks vist
-ovenfor som det foretrukne alternativ. Ikiwiki understøtter dog fortsat den
-ældre syntaks, hvis ikke `prefix_directives`-valget er aktiveret. For
-bagudkompatibilitet med eksisterende er dette valg som standard deaktiveret
-i øjeblikket, så ikiwiki understøtter den ældre syntaks.
+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.