PmWiki | PmWikiDe / Seitendirektiven

Autoren (Fortgeschrittene) (deutsche Übersetzung der Seite PmWiki.PageDirectives, Stand 2008-04-16)

PmWiki verwendet eine Anzahl von Direktiven um den Seitentitel, die Beschreibung, Schlüsselwörter sowie die Darstellung verschiedener Elemente zu steuern.

(:attachlist:)

Zeigt eine Liste mit den Anhängen der aktuellen Gruppe oder Seite (je nachdem, ob Anhänge gruppenweise oder seitenweise organisiert werden. Die Liste mit den Anhängen wird automatisch am Ende der zum Hochladen genutzten Formular-Seite angezeigt.

Als Parameter von (:attachlist:) kann der Name einer Wikiseite angegeben werden. In diesem Fall werden durch die Direktive alle verfügbaren Anhänge der jeweils aufgeführten Seite angezeigt.

Optionen: (:attachlist NAME:) zeigt eine Liste der Anhänge der Gruppe oder Seite namens NAME.

(:attachlist ext=xxx:) spezifiziert eine Dateierweiterung, um nur bestimmte Dateitypen anzuzeigen.

(:attachlist *:) zeigt das Verzeichnis, in das Dateien hochgeladen werden und erlaubt es, dieses Verzeichnis mit dem Browser zu durchblättern (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 im Seitenquelltext erzeugt.)

(:linebreaks:), (:nolinebreaks:): Beachtet alle Zeilenwechsel im Wiki-Quelltext. Text, der auf separaten Zeilen eingegeben wird, wird also auch beim Anzeigen der Seite auf separaten Zeilen dargestellt. Um Textzeilen später wieder automatisch zusammenzufügen, wird (:nolinebreaks:) genutzt.

(:linkwikiwords:), (:nolinkwikiwords:)
: Schaltet WikiWörter ein/aus.

(:markup:) ... (:markupend:)

Dies kann genutzt werden, um die Nutzung von Formatierungsanweisungen beispielhaft darzustellen. Es wird zuerst die eingegebene Formatierungsanweisung und darunter deren Ergebnis dargestellt.

Optionen: (:markupend:) kann weggelassen werden, wenn (:markup:) [=...=] genutzt wird.

Argumente: (:markup class=horiz:) und (:markup caption='...':)

Hinweis: Die Platzierung von Zeilenwechseln ist für diese Direktive sehr wichtig.. Wenn man die Form [=...=] 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. Peter Bowers February 14, 2008, at 01:33 AM

Hinweis: Das Verwenden der markup-Direktive ändert die Reihenfolge, in der die Formatierungsanweisungen interpretiert werden. Wenn die Reihenfolge der verwendeten Anweisungen wichtig ist, dann sollte sichergestellt werden, dass die Anweisungen entweder alle innerhalb der markup-Direktive stehen oder alle außerhalb der Direktive. Peter Bowers

(:noaction:): Schaltet den Abschnitt der Skin (Layout-Vorlage) ab, der durch  und  begrenzt wird. In der Standard-Skin 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).

(:nogroupheader:)
(:nogroupfooter:): Schaltet Gruppen-Kopf- oder Gruppen-Fuß-Bereich für die aktuelle Seite aus. (Siehe Kopfbereich 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:): 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 Option from= 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).

(:spacewikiwords:), (:nospacewikiwords:)

Schaltet automatische Leerzeichen in WikiWörtern ein/aus.

(:title text:): Legt einen Seitentitel abweichend vom Seitennamen fest. Der Titeltext kann Apostrophe und andere Spezialzeichen enthalten. Wenn verschiedene Titel in einer Seite festgelegt werden, wird der zuletzt angegebene verwendet.

(:nl:): Erzeugt einen Zeilenwechsel sofern nicht sowieso einer vorhanden ist. Vergleiche diese Diskussion (auf Englisch) für weitere Informationen hierzu.
: Identisch zu [[<<]]

<< Seitenlisten | Dokumentations-Index | Löschen von Seiten >>

Can I get (:redirect:) to return a "moved permanently" (HTTP 301) status code?

Use (:redirect PageName status=301:).

Is there any way to prevent the "redirected from" message from showing at the top of the target page when I use (:redirect:)?

There are several possibilities.

If you want to suppress the message in all cases

add $PageRedirectFmt = ''; to your local/config.php

If you want to suppress the message based on the destination/target of the redirect

add $PageRedirectFmt = ''; to a local/group.page.php or local/group.php file (see PmWiki:Per Group Customizations).

If you want to suppress the message based on the origin/source of the redirect

add the following to your local/config.php

if (@$_GET['from']) {
  $group = PageVar($_GET['from'], '$Group');
  if ($group == 'SomeGroup') $PageRedirectFmt = '';
}

(In the above code example, you might replace SomeGroup with Profiles.)

An alternative is the include the other page rather than redirect.

There are two cookbook recipes that may assist

Is there any method for redirecting to the equivalent page in a different group, i.e. from BadGroup/thispage => GoodGroup/thispage using similar markup to (:redirect Goodgroup.{Name}:)?

(:redirect Goodgroup.{$Name}:) works if you want to put it in one page.

If you want it to work for the entire group, put (:redirect Goodgroup.{*$Name}:) into Badgroup.GroupHeader - however, that only works with pages that really exist in Goodgroup; if you visit a page in Badgroup without a corresponding page of the same name in Goodgroup, instead of being redirected to a nonexistant page, you get the redirect Directive at the top of the page.

With (:if exists Goodgroup.{*$Name}:)(:redirect Goodgroup.{*$Name}:)(:ifend:) in Badgroup.GroupHeader you get redirected to Goodgroup.Name if it exists, otherwise you get Badgroup.Name without the bit of code displayed.