summaryrefslogtreecommitdiff
path: root/templates.mdwn
blob: 245725d0e72607011c76220111e391c9d0fc8456 (plain)

[[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="""

Tilgængelige skabeloner

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 indsat indeni min note."""]]

Dette udfylder [[note]]-skabelonen, ved at erstatte text-feltet med den angivne værdi og indsætte resultatet på siden.

En værdi kan 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:

    \[[template id=foo name="Sally" color="grøn" age=8 notes="""
    * \[[Charley]]'s søster.
    * "Jeg vil være astronaut når jeg bliver stor."
    * egentlig 8 og et halvt.
    """]]

Oprettelse af skabelon

Opret en skabelon ved simpelthen at tilføje skabelon-direktivet til en side, så vil siden vise en henvsining som kan bruges til at oprette skabelonen. Skabelonen er en normal wikiside, placeret i templates/-mappen.

Skabelonen bruger samme syntax som perl-modulet cpan HTML::Template som åbner nogle ret komplekse muligheder. Læs dokumentationen for den fulde syntaks, men alt hvad du i virkeligheden behøver at vide er nogle få ting:

  • Indsæt værdien af en variable med <TMPL_VAR variabel>.
  • 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:

    <span class="infobox">
    Name: <TMPL_VAR 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>

(det anbefales at bruge engelske variabelnavne for at undgå problemer med æøå og andre specialtegn)

Den udfyldte skabelon vil blive formatteret 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.