summaryrefslogtreecommitdiff
path: root/templates.mdwn
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2010-07-17 15:21:24 +0200
committerJonas Smedegaard <dr@jones.dk>2010-07-17 15:21:24 +0200
commitaec645db66bf0d2ca6bb70f8297b5887a3f79f77 (patch)
tree749ab130800f96f1b915517bd0dadc1ccb154688 /templates.mdwn
parent1b17b412ec7e7f3aba270e42cfcd6e30e74d783e (diff)
parent747d1ba5821b87aae3792c8304db0fa8597f2dc6 (diff)
Merge branch 'master-da' into scs-da
Diffstat (limited to 'templates.mdwn')
-rw-r--r--templates.mdwn144
1 files changed, 69 insertions, 75 deletions
diff --git a/templates.mdwn b/templates.mdwn
index 3109931..6ae9424 100644
--- a/templates.mdwn
+++ b/templates.mdwn
@@ -1,85 +1,79 @@
-[[!meta robots="noindex, follow"]]
-[[!if test="enabled(template)"
-then="Denne wiki har skabeloner **aktiveret**."
-else="Denne wiki har skabeloner **deaktiveret**." ]]
-
-Skabeloner er filer som kan blive udfyldt og indsat på sider i wikien.
-
-[[!if test="enabled(template) and enabled(inline)" then="""
-
-Disse skabeloner er tilgængelige til indsættelse på andre sider i denne
-wiki:
-
-[[!inline pages="templates/* and !*/discussion" feeds=no archive=yes
-sort=title template=titlepage]]
-"""]]
-
-## Brug af skabelon
-
-En skabelon bruges som her:
-
- \[[!template id=note text="""Her er teksten til at sætte ind i min note."""]]
+[[Ikiwiki]] anvender mange skabeloner til forskellige formål. Ved at
+redigere disse skabeloner kan du fuldstændigt tilrette dette sted.
-Dette udfylder [[note]]-skabelonen, ved at erstatte `text`-feltet med den
-angivne værdi og indsætte resultatet på siden.
+Skabeloner erplaceret i `/usr/share/ikiwiki/templates` som standard;
+`templatedir`-indstillingen kan bruges til at kigge i en anden mappe
+først. Tilrettede skabeloner kan også placeres inde i "templates/"-mappen i
+din wiki's kildemateriale.
-Generelt kan en værdi indeholde enhver opmærkning som ville være tilladt på
-wikisiden udenfor skabelonen. Trippel-citering af værdien tillader endda at
-bruge citering som del af værdien. Kombineret med flerlinje-citerede værdier
-tillader dette indlejring af store klumper af opmærket tekst i skabelonen:
+Ikiwiki anvender HTML::Template modulet som dets skabelon-motor. Det
+understøtter ting som betingelser og løkker i skabeloner og er ret nemt at
+lære. Alt hvad du reelt behøver at vide for at tilrette skabeloner er dette:
- \[[!template id=foo name="Sally" color="grøn" age=8 notes="""
- * \[[Charley]]'s søster.
- * "Jeg vil være en astronaut når jeg bliver stor."
- * Egentligt 8 og et halvt.
- """]]
+* Brug `<TMPL_VAR variabel>` til at indsætte værdien af en variabel.
+* Gør en tekstblok betinget af at en variabel er i brug med `<TMPL_IF
+ variabel>tekst</TMPL_IF>`.
+* Brug een tekstblok hvis en variabel er i brug, og en anden hvis ikke, med
+ `<TMPL_IF variabel>tekst<TMPL_ELSE>anden tekst</TMPL_IF>`
-## Oprettelse af skabelon
+[[!if test="enabled(template)" then="""
+## skabelonsider
-Opret en skabelon ved simpelthen at tilføje skabelon-direktivet til en side,
-så vil siden vise en henvisning som kan bruges til at oprette
-skabelonen. Skabelonen er en normal wikiside, placeret i `templates/`
-undermappen indeni wikiens kildemappe.
+Med [[!iki ikiwiki/directive/template desc="skabelondirektivet"]] kan
+wikisider bruges som skabeloner, udfyldt og indsat i andre sider i wikien.
+"""]]
-Skabelonen bruger samme syntax som perl-modulet [[!cpan HTML::Template]] som
-giver mulighed for at lave ret komplekse ting. Læs dokumentationen for den
-fulde syntaks, men alt hvad du reelt behøver at vide er nogle få ting:
+[[!if test="enabled(edittemplate)" then="""
+## sntandard indhold for nye sider
-* Ethvert parameter du angiver til skabelondirektivet vil danne en
- skabelonvariabel. Der er også nogle foruddefinerede variable som PAGE og
- BASENAME.
-* Brug `<TMPL_VAR variabel>` til at indsætte værdien af en
- variabel. Wiki-opmærkning i værdien bliver først konverteret til html.
-* Brug `<TMPL_VAR raw_variabel>` til at indsætte den rå værdi af en
- variabel, med wiki-opmærkning endnu ikke konverteret til html.
-* Gør en tekstblok betinget af at en variabel er i brug med `<TMPL_IF
- NAME="variabel">tekst</TMPL_IF>`.
-* Brug een tekstblok hvis en variabel er i brug, og en anden hvis ikke, med
- `<TMPL_IF NAME="variabel">tekst<TMPL_ELSE>anden tekst</TMPL_IF>`
-
-Her er et eksempel på en skabelon (det anbefales at bruge engelske
-variabelnavne for at undgå problemer med æøå og andre specialtegn):
+[[!iki ikiwiki/directive/edittemplate desc="Edittemplate-direktivet"]] kan
+anvendes til at lade nyoprettede sider som standard indeholde tekst fra en
+skabelonside, som så kan tilrettes når siden redigeres.
+"""]]
- <span class="infobox">
- Navn: \[[<TMPL_VAR raw_name>]]<br />
- Alder: <TMPL_VAR age><br />
- <TMPL_IF NAME="color">
- Favoritfarve: <TMPL_VAR color><br />
- <TMPL_ELSE>
- Ingen favoritfarve.<br />
- </TMPL_IF>
- <TMPL_IF NAME="notes">
- <hr />
- <TMPL_VAR notes>
- </TMPL_IF>
- </span>
+[[!if test="(enabled(template) or enabled(edittemplate))
+and enabled(inline)" then="""
+[[!inline pages="templates/* and !*.tmpl and !templates/*/* and !*/discussion"
+feeds=no archive=yes sort=title template=titlepage
+rootpage=templates postformtext="Tilføj en ny skabelon med dette navn:"]]
+"""]]
-Den udfyldte skabelon vil blive formateret som resten af siden den er
-inkluderet i, så du kan medtage WikiLinks og alle andre former for wiki-
-opmærkning i skabelonen. Bemærk dog at sådanne WikiLinks ikke vil dukke op
-som krydshenvisninger (backlinks) til den side som anvender skabelonen.
+## wiki-skabeloner
+
+Disse skabeloner bliver brugt til at bygge wikien. Målet er at holde næsten
+al html ude af ikiwiki og inde i skabelonerne.
+
+* `page.tmpl` - Anvendt til at vise alle normale wikisider. Dette er den
+ centrale skabelon at tilrette. [[!if test="enabled(pagetemplate)" then="""
+ ([[!iki ikiwiki/directive/pagetemplate desc="Pagetemplate direktivet"]]
+ kan bruges til at lade en side anvende en anden skabelon end `page.tmpl`.)"""]]
+* `rsspage.tmpl` - Anvendt til at danne rss fødninger til blogs.
+* `rssitem.tmpl` - Anvendt til at danne individuelle emner i rss fødninger.
+* `atompage.tmpl` - Anvendt til at danne atom fødninger til blogs.
+* `atomitem.tmpl` - Anvendt til at danne individuelle emner i atom fødninger.
+* `inlinepage.tmpl` - Anvendt til at vise et indlæg i en blog.
+* `archivepage.tmpl` - Anvendt til opremsning af en side i en blogs arkivside.
+* `titlepage.tmpl` - Anvendt til opremsning af en sides titel i en blogs arkivside.
+* `microblog.tmpl` - Anvendt til at vise et mikroblog-indlæg inlejret.
+* `blogpost.tmpl` - Anvendt til en formular til at tilføje et indlæg til en blog (og rss/atom henvisninger)
+* `feedlink.tmpl` - Anvendt til at tilføje rss/atom henvisninger hvis `blogpost.tmpl` ikke anvendes.
+* `aggregatepost.tmpl` - Anvendt af aggregate-udvidelsen til at oprette
+ en side til et indlæg.
+* `searchform.tmpl`, `googleform.tmpl` - Anvendt af search-
+ og google-udvidelserne til at tilføje søgeformularer til wikisider.
+* `searchquery.tmpl` - Dette er en Omega-skabelon, anvendt af
+ search-udvidelsen.
+* `comment.tmpl` - Anvendt af comments-udvidelsen til at vise en kommentar.
+* `change.tmpl` - Anvendt til at oprette en side der beskriver en ændring lavet på wikien.
+* `recentchanges.tmpl` - Anvendt til at opremse en ændring på RecentChanges siden.
+* `autoindex.tmpl` - Udfyldt af autoindex-udvidelsen til at oprette index sider.
+* `autotag.tmpl` - Udfyldt af tag-udvidelsen til at oprette mærkat-sider.
+* `calendarmonth.tmpl`, `calendaryear.tmpl` - Anvendt af ikiwiki-calendar til
+ at oprette kalender-arkiv sider.
+* `editpage.tmpl`, `editconflict.tmpl`, `editcreationconflict.tmpl`,
+ `editfailedsave.tmpl`, `editpagegone.tmpl`, `pocreatepage.tmpl`,
+ `editcomment.tmpl` `commentmoderation.tmpl`, `renamesummary.tmpl`,
+ `passwordmail.tmpl`, `openid-selector.tmpl` - Dele af ikiwiki's brugerflade;
+ kræver normalt ingen tilretning.
-Bemærk brugen af "raw_name" indeni [[ikiwiki/WikiLink]]-generatoren. Dette
-sikrer at hvor navnet indeholder noget som måske kan fejltolkes som
-wiki-opmærkning, bliver det ikke konverteret til html før det er blevet
-behandlet som en [[ikiwiki/WikiLink]].
+[[!meta robots="noindex, follow"]]