summaryrefslogtreecommitdiff
path: root/ikiwiki/directive.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/directive.mdwn')
-rw-r--r--ikiwiki/directive.mdwn51
1 files changed, 29 insertions, 22 deletions
diff --git a/ikiwiki/directive.mdwn b/ikiwiki/directive.mdwn
index b2c3be0..c4342de 100644
--- a/ikiwiki/directive.mdwn
+++ b/ikiwiki/directive.mdwn
@@ -1,38 +1,45 @@
[[!meta robots="noindex, follow"]]
-Direktiver ligner et [[WikiLink]] i form, undtagen at de begynder med `!` og
-kan indeholde parametre. Generelt er formen:
+Directives are similar to a [[ikiwiki/WikiLink]] in form, except they
+begin with `!` and may contain parameters. The general form is:
- \[[!direktiv 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 direktiv behøver ikke at blive holdt på een linje, det kan bredes ud over
-flere linjer hvis du har lyst:
+A directive does not need to all be on one line, it can be
+wrapped to multiple lines if you like:
- \[[!direktiv foo="baldersnatch"
+ \[[!directive foo="baldersnatch"
bar="supercalifragilisticexpialidocious" 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:
- \[[!direktiv tekst="""
+ \[[!directive text="""
1. "foo"
2. "bar"
3. "baz"
"""]]
-Ikiwiki har også en ældre syntaks til direktiver, 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 wikier er dette valg som standard
-deaktiveret i øjeblikket, så ikiwiki understøtter den ældre syntaks.
+ikiwiki also has an older syntax for directives, which requires a
+space in directives to distinguish them from [[wikilinks|ikiwiki/wikilink]].
+This syntax has several disadvantages: it requires a space after directives
+with no parameters (such as `\[[pagecount ]]`), and it prohibits spaces in
+[[wikilinks|ikiwiki/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.
+
+[[!if test="enabled(listdirectives)" then="""
+Here is a list of currently available directives in this wiki:
+
+[[!listdirectives ]]
+"""]]