summaryrefslogtreecommitdiff
path: root/ikiwiki/directive.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/directive.mdwn')
-rw-r--r--ikiwiki/directive.mdwn38
1 files changed, 38 insertions, 0 deletions
diff --git a/ikiwiki/directive.mdwn b/ikiwiki/directive.mdwn
new file mode 100644
index 0000000..b2c3be0
--- /dev/null
+++ b/ikiwiki/directive.mdwn
@@ -0,0 +1,38 @@
+[[!meta robots="noindex, follow"]]
+Direktiver ligner et [[WikiLink]] i form, undtagen at de begynder med `!` og
+kan indeholde parametre. Generelt er formen:
+
+ \[[!direktiv param="værdi" param="værdi"]]
+
+Dette udvides før resten af siden udarbejdes, og kan bruges til at omforme
+siden på forskellige måder.
+
+Citationen omkring værdier kan udelades hvis værdien er et simpelt
+ord. Desuden kan nogle direktiver bruge parametre uden værdier. Eksempel:
+
+ \[[!tag foo]]
+
+Et direktiv behøver ikke at blive holdt på een linje, det kan bredes ud over
+flere linjer hvis du har lyst:
+
+ \[[!direktiv 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:
+
+ \[[!direktiv tekst="""
+ 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.