Direktiven

Deutsche Übersetzung der Seite PmWiki.Directives, Stand 20. Dez 2004

Siehe auch den MarkupMasterIndex.

PmWiki benutzt den Markup Code (:directive ...:) für eine Anzahl von Anweisungen und Text Ersetzungen. Viele von ihnen ersetzen die "Doppelklammer" Anweisungen von PmWiki 1.0 und früheren Versionen. Hier ist eine kurze Beschreibung jeder Anweisung.

(:title Text:)

Setzt den Seitentitel zu etwas anderem als den Seitennamen. Zum Beispiel der Markup
    (:title Peter's Startseite:)
setzt "Peter's Startseite" als Seitentitel in der Titelleiste des Browsers (HTML <title> tag) und dem Titelbereich der Seite ($PageTitle Variable). Beachte dass hier Apostrophen und andere Sonderzeichen benutzt werden können.

(:keywords Wort, ...:)

Setzt Schlüsselwörter der Seite in einen HTML <meta name='keywords' content='Wort, ...' /> Markup.

(:include SeitenName:) and (:include SeitenName#Beginn#Ende:)

Fügt den Inhalt einer anderen Seite in den Text der aktuellen Seite. In der zweiten Form des "include" wird nur der Teil der Seite zwischen den Ankern #Beginn und #Ende eingefügt. #Beginn und #Ende kann numerisch sein, dann beziehen sie sich auf Zeilennummern in der Seite, so dass (:include RecentChanges#1#10:) nur die ersten zehn Zeilen der RecentChanges Seite zeigt.
Zeilennummern Beispiele:
(:include EineSeite :) - EineSeite wird ganz eingefügt
(:include EineSeite lines=10 :) - EineSeite Zeilen 1-10 werden eingefügt
(:include EineSeite lines=1..10 :) - EineSeite Zeilen 1-10 werden eingefügt
(:include EineSeite lines=6..10 :) - EineSeite Zeilen 6-10 werden eingefügt
(:include EineSeite lines=6.. :) - EineSeite Zeile 6 bis zum Ende werden eingefügt
(:include EineSeite lines=6..6:) - allein EineSeite Zeile 6 wird eingefügt

(:noheader:), (:nofooter:), (:notitle:), etc.

Unterdrückt die Ausgabe der Kopf- oder Fußzeile bzw. des Seitentitels (insofern der Skin dies vorsieht).

(:(no)spacewikiwords:)

Schaltet die automatische Leerzeichen-Einfügung in WikiWörtern aus. Wenn eingeschaltet, erscheint WikiWort als Wiki Wort.

(:(no)linkwikiwords:)

Schaltet die automatische Verlinkung von WikiWörtern zur gleichnamigen Seite aus.

(:if cond param:)

Die (:if cond param:) Syntax ermöglicht, dass Textteile (bis zum nächsten (:if:)) besonders behandelt werden, falls bestimmte logische Bedingungen erfüllt sind, je nach Bedingungsbegriffen die der Administrator geschaffen hat. Die vorgegebenen Bedingungen sind "true", "false", "group", und "name". Zum Beispiel:
(:if group PmWiki:)Dieser Text wird nur in der PmWiki Gruppe gezeigt (:if:)
Mehr darüber siehe ConditionalMarkup?.

(:pagelist group=xxx fmt=yyy list=zzz:)

Die (:pagelist ..:) Syntax ermöglicht die Einfügung einer einfachen Liste der Seiten

einer Gruppe. Die Gruppe und die Seitennamen werden als Links (Verweise) dargestellt.

group=xxx
optional, xxx = Name der Gruppe, dessen Seitennamen in der Liste eingeschlossen werden.
Q: Kann man auch Seiten angeben, z.B. durch regex oder passendem Namen-Präfix: Gruppe\.PRÄF.* = alle Seiten einer Gruppe "Gruppe" beginnend mit "PRÄF"
A: Nein, nur Gruppen aber keine Seiten. Vielleicht wird es in Zukunft einmal die Möglichkeit geben, dass die Angabe von vollen Namen durch regex gestattet. Ausserdem gibt es immer die Möglichkeit mit der list=zzz Option unten, welche solche beliebigen listen erlaubt.
fmt=yyy
freigestellt, yyy =
bygroup
standardsmässig, Level 1 listet Einträge für jede Gruppe mit Level 2

Listen-Einträgen für jede Seite der Gruppe.

simple
eine Zeile für jede Seite mit vollem Seitennamen: "* Gruppenname.Seitenname",

kein Gruppen Kopfstück (kein GroupHeader)

siehe auch
Cookbook:DictIndex
list=zzz
freigestellt, zzz =
normal
spezielle Seiten wie RecentChanges, GroupHeader and GroupFooter werden aus der Liste ausgeschlossen.
Du kannst
(:pagelist:) für eine Liste aller Seiten,
(:pagelist group=PmWiki:) für eine Liste aller Seiten in der PmWiki Gruppe,
(:pagelist group={$Group}:) für eine Liste aller Seiten in der aktuellen Gruppe,
(:pagelist group={$Group} list=normal:) für eine Liste aller Seiten in der aktuellen Gruppe ausser GroupHeader, GroupFooter, RecentChanges etc
von mailings:
Für RecentPages, habe ich das folgende in meine local/config.php geschrieben:
(Es müssen zwei Leerzeichen zwischen dem Wiki Link und dem folgendem Text stehen
 -> Kopiere & füge ein vom rohen Text, nicht von der html Ansicht.)
$RCTime = strftime('%b %d %H:%M',$Now);
$RecentChangesFmt['Main.RecentPages'] = ':[[$FullName]]: $RCTime';

(:searchbox:)

Stellt ein Suchdialog-Feld in der Seite dar.

(:searchresults group=xxx fmt=yyy list=zzz text:)

siehe auch: Cookbook.SearchResults

<< Markup master index | PmWikiDe.DokumentationsIndex | WikiStruktur >>