Seitendirektiven
PmWiki verwendet eine Anzahl von Direktiven um Seitentitel, Beschreibungen und Schlüsselwörter ("keywords") festzulegen sowie die Darstellung verschiedener Elemente zu steuern. Bei Direktiven-Schlüsselwörtern wird nicht zwischen Groß- und Kleinschreibung unterschieden, so sind DESCRIPTION, Description und description äquivalent.
(:attachlist:)
(:attachlist:)
wird immer zu einem Seitennamen aufgelöst. Die Direktive zeigt dann alle Anhänge, die aktuell für diese Seite verfügbar sind.
- Optionen
-
(:attachlist NAME:)
zeigt eine Liste der Anhänge der Gruppe oder Seite namens NAME.
(:attachlist {*$Name}:)
zeigt eine Liste der Anhänge der aktuellen Gruppe oder Seite. Das ist nützlich, wenn man eine Liste der Anhänge im Kopf- oder Fußbereich der Gruppe haben will, für den Fall, dass ein Verzeichnis für jede Seite eingestellt ist.
(:attachlist ext=xxx,yyy:)
mit Kommata getrennte Dateiendungsmuster zum Filtern per Dateityp, Groß/Kleinschreibung wird berücksichtigt.
(:attachlist names=*.jpg,*.pdf,-private*.jpg:)
mit Kommata getrennte Dateinamensmuster zum Filtern per Dateinamen, Groß/Kleinschreibung wird berücksichtigt.
(:attachlist *:)
zeigt das Verzeichnis, in das Dateien hochgeladen werden, und erlaubt es, alle hochgeladenen Dateien verzeichnisweise durchzublättern, wenn Ihre Serverkonfiguration automatische Dateilisten erlaubt (dies funktioniert nicht, wenn $EnableDirectDownload
auf 0 gesetzt ist).
(:description text:)
- Beschreibender Text für die jeweilige Seite. (Erzeugt ein
<meta name='description' content='...' />
-Element im Seitenquelltext.)
(:keywords Wort1, Wort2, ...:)
- Gibt die Schlüsselwörter für die jeweilige Seite an. Diese werden nicht angezeigt, helfen aber Suchmaschinen beim Indizieren der Seite. (Um genau zu sein: Es wird ein
<meta name='keywords' content='...' />
-Element in der HTML-Ausgabe erzeugt.)
(:linebreaks:)
,(:nolinebreaks:)
- Beachtet alle Zeilenwechsel im Wiki-Quelltext, d. h. Text, der auf separaten Zeilen eingegeben wird, wird also auch beim Anzeigen der Seite auf separaten Zeilen dargestellt. Um Textzeilen später (weiter unten in der gleichen Seite) wieder automatisch zusammenzufügen, wird
(:nolinebreaks:)
genutzt.
(:linkwikiwords:), (:nolinkwikiwords:)
- :Schaltet WikiWörter-Links? ein/aus. Beachten Sie, dass diese Einstellung voraussetzt, dass WikiWords aktiviert werden, siehe
$EnableWikiWords
. Siehe auch$LinkWikiWords
.
(:markup:) ... (:markupend:)
oder(:markup:)
[= ... =]
- Dies kann genutzt werden, um die Verwendung von Formatierungsanweisungen beispielhaft darzustellen. Es wird zuerst die eingegebene Formatierungsanweisung und darunter deren Ergebnis dargestellt.
- Optionen
-
(:markup class=horiz:)
zeigt die Formatierungsanweisung und das Ergebnis nebeneinander anstatt übereinander an.
(:markup class=norender:)
Zeigt nur den Quelltext, nicht auch das Ergebnis.(:markup caption='...':)
fügt eine Überschrift zum dargestellten Beispiel hinzu.(:markupend:)
kann weggelassen werden, wenn(:markup:)
genutzt wird.[=...=]
[=...=]
nutzt, dann MUSS dass öffnende [=
auf der selben Zeile wie (:markup:)
stehen. Wenn man die (komplette) Form (:markup:) ... (:markupend:)
nutzt, dann muss der Beispiel-Kode NACH einem Zeilenwechsel hinter dem beginnenden (:markup:)
folgen.
(:messages keys=a,b details=open:)
- Zeigt Nachrichten von PmWiki, Erweiterungen oder Rezepten an, z. B. um Angaben bezüglich der Bearbeitung von Seiten auszugeben. Erlaubt verschachtelte Arrays mit Schlüsseln, die von Erweiterungen und Rezepten gesetzt werden können. Das Attribut "
keys=
" hat kommaseparierte Schlüssel oder Muster. Das Attribut "details=
" kann "open
" oder "closed
" sein und hüllt die gruppierten Nachrichten in ein<details>
-Element ein. Zusätzlich werden jetzt individuelle Nachrichten, die mit "markup:
" beginnen, von der Markup-Engine erneut bearbeitet.
(:noaction:)
- Schaltet den Abschnitt der Layout-Vorlage (Skin) ab, der durch <!--PageActionFmt--> und <!--/PageActionFmt--> begrenzt wird. In dem Standard-Layout von PmWiki wird dadurch die Darstellung der verfügbaren Aktionen im oberen rechten Bereich der Seite abgeschaltet (andere Skins können die verfügbaren Aktionen an anderen Stellen darstellen). Es bleiben aber die Standardaktionen am unteren Seitenrand aktiv.
(:nogroupheader:)
(:nogroupfooter:)
- Schaltet den Gruppen-Kopf- oder den Gruppen-Fuß-Bereich für die aktuelle Seite aus. (Siehe Kopfbereich (und Fußbereich) der Gruppe.)
(:noheader:), (:nofooter:)
(:noleft:), (:noright:), (:notitle:)
- Falls vom Skin unterstützt, werden die zugehörigen Bereiche der Seite ausgeblendet (Kopf-, Fußbereiche, linke Seitenleiste, rechte Seitenleiste, Titelbereich).
(:redirect PageName:)
- Leitet den Browser zu einer anderen Wikiseite um.
(:redirect PageName#anchor:)
- Leitet den Browser zu einem Anker innerhalb einer Wikiseite um.
(:redirect PageName status=301 from=name quiet=1:)
- Leitet den Browser zu einer anderen Seite um und zeigt eine entsprechende Meldung an. Aus Sicherheitsgründen kann nur auf eine andere Wikiseite, jedoch nicht auf externe URLs, umgeleitet werden. Die Option
status=
kann genutzt werden, um einen beliebigen HTTP-Statuscode für die Weiterleitung zu definieren. Die Optionfrom=
beschränkt Weiterleitungen insofern, als dass sie nur von Seiten aus stattfinden, auf die das Suchmuster name passt. (Dies ist nützlich, wenn(:redirect:)
in einer eingebundenen Seite enthalten ist (vgl. Einbinden anderer Seiten). Die Optionquiet=1
dient dazu, auf der Zielseite der Umleitung die Anzeige eines Links auf die Originalseite zu unterdrücken ($EnableRedirectQuiet
sollte dazu auf 1 gesetzt sein.)
(:spacewikiwords:), (:nospacewikiwords:)
- Schaltet automatische Behandlung von Leerzeichen in WikiWörtern ein/aus.
(:title text:)
- Legt einen Seitentitel abweichend vom Seitennamen fest. Der Titeltext kann Apostrophe und andere Spezialzeichen enthalten. Wenn mehrere Titel in einer Seite festgelegt werden, wird der zuletzt angegebene verwendet (siehe auch bei
$EnablePageTitlePriority
, wie man das ändern kann).
(:toc:),(:notoc:)
- Fügt ein automatisches Inhaltsverzeichnis anstelle der Direktive ein. Diese Direktive erfordert eine entsprechende Konfiguration des Wikis, siehe Inhaltsverzeichnis -> Fügen Sie ein einfaches automatisches Inhaltsverzeichnis und Nummerierungen der Überschriften in Ihre Seiten ein.
(:Summary:text:)
- Summary setzt die Zusammenfassung für eine Seite. Summary wird in einigen der Standard-Seitenlistenvorlagen genutzt. Beachten Sie, dies ist eine Seitentextvariable und anders als bei den Seitendirektiven des PmWiki-Kerns wird die Groß/Kleinschreibung berücksichtigt.
FAQ
Lässt sich (:redirect:)
dazu bringen, den Status-Code "Permanent verschoben" (HTTP 301) anzuzeigen?
Das geht mit (:redirect SeitenName status=301:)
.
Gibt es eine Möglichkeit, den Text "umgeleitet von ..." ganz oben auf der Zielseite zu unterdrücken, wenn ich (:redirect:)
nutze?
Seit Version 2.2.1 können Sie $EnableRedirectQuiet=1;
in die local/config.php-Datei setzen. In die Seite fügen Sie dann (:redirect OtherPage quiet=1:)
für eine stumme Weiterleitung ein.
Gibt es eine Methode, auf eine äquivalente Seite in einer anderen Gruppe umzuleiten, z. B. von SchlechteGruppe/Seite => GuteGruppe/Seite – etwa indem man eine Formatierungsanweisung wie (:redirect GuteGruppe.{$Name}:)
verwendet?
(:redirect GuteGruppe.{$Name}:)
ist möglich, wenn Sie die Anweisung einfach nur in einer bestimmten Seite verwenden wollen.
(:redirect GuteGruppe.{*$Name}:)
in die Seite SchlechtGruppe.GroupHeader
ein. Dies funktioniert allerdings nur mit Seiten, die in GuteGruppe
existieren; wenn Sie eine Seite in SchlechteGruppe
aufrufen, für die es keine korrespondierende Seite in GuteGruppe
gibt, wird die(:redirect:)
-Direktive am Seitenanfang angezeigt (anstatt dass Sie auf eine nicht-existierende Seite umgeleitet werden).
(:if exists GuteGruppe.{*$Name}:)(:redirect GuteGruppe.{*$Name}:)(:ifend:)
in der Seite SchlechteGruppe.GroupHeader
werden Sie auf GuteGruppe.Name
umgeleitet, sofern diese Seite existiert, ansonsten bleiben Sie auf SchlechteGruppe.Name
, ohne dass irgendein Kode-Schnipsel angezeigt wird.
Wie kann ein Wiki standardmäßig Zeilenumbrüche aktivieren, d. h. ohne die Direktive (:linebreaks:)
in einer Seite oder im Gruppen-Header einzufügen?
Fügen Sie in config.php eine solche Zeile hinzu:$HTMLPNewline = '<br/>';
Übersetzung von PmWiki.PageDirectives, Originalseite auf PmWikiDe.PageDirectives — Rückverweise
Zuletzt geändert: | PmWikiDe.PageDirectives | am 04.11.2024 |
PmWiki.PageDirectives | am 04.11.2024 |