Englisch: |
Autoren (Grundlagen)
Die Seitenaktionen der Site-Seite wird als Quelle benutzt, um die Standardaktionen von PmWiki in der oberen rechten Ecke des Standard-Skins von PmWiki zu zeigen. Das sieh dann so aus:
Beachten Sie, dass es noch viele andere Verfügbare Aktionen in den Kochbüchern und PmWikis Diagnosen und Skripten gibt. Die Site.PageActions-Seite nutzt das Zusammenwirken einer ganzen Reihe von PmWiki-Charakteristika. Diese Seite gibt eine kurze Erläuterung der Möglichkeiten, die gewöhnlich in den Seitenaktionen der Site eingesetzt werden und gibt Hinweise darauf, wo weitere Informationen zu finden sind. Beginnen wir mit einem Blick auf den Anfang einer typischen Site.PageAction-Seite, wie sie mit der PmWiki-Version 2.2.25 ausgeliefert wurde. * %item rel=nofollow class=browse accesskey='$[ak_view]' % [[ {*$FullName} | $[View] ]] * %item rel=nofollow class=edit accesskey='$[ak_edit]' % [[ {*$FullName}?action=edit | $[Edit] ]] * %item rel=nofollow class=diff accesskey='$[ak_history]' % [[ {*$FullName}?action=diff | $[History] ]] (:if auth upload:) * %item rel=nofollow class=upload accesskey='$[ak_attach]' % [[ {*$FullName}?action=upload | $[Attach] ]] (:ifend:) * %item rel=nofollow class=print accesskey='$[ak_print]' % [[ {*$FullName}?action=print | $[Print] ]] (:if group Site,SiteAdmin,Cookbook,Profiles,PmWiki*:) (:comment delete if and ifend to enable backlinks:) * %item rel=nofollow class=backlinks accesskey='$[ak_backlinks]'% [[{*$Name}?action=search&q=link={*$FullName} | $[Backlinks] ]] (:ifend:) (:if enabled AuthPw:) * %item rel=nofollow class=logout accesskey="$[ak_logout]"%'' [-[[{*$FullName}?action=logout | $[Logout] ]]-]'' (:ifend:) Das könnte ein bisschen entmutigend wirken, aber wir nähern uns Schritt für Schritt. Beginnen wir damit, die erste Zeile anzusehen und auseinander zunehmen. Das gibt uns auch gute Hinweise, wie denn all die anderen Zeilen funktionieren. ListeJede Zeile ist Bestandteil einer ungeordneten Liste, deshalb beginnt sie mit einem nicht eingerückten Sternchen '*'. Sie können mehr über Listen in der Seite mit den Grundlagen der Bearbeitung erfahren. PmWiki stellt eine solche ungeordnete Liste gewöhnlich als einem Satz mit 'Knöpfchen' versehener Aufzählungspunkte dar. Sie können aber auch anders in Erscheinung treten, je nach dem Zusammenhang, in dem sie erscheinen. Diese Unterschiede sind in CSS-Regeln festgelegt, die das Aussehen der PmWiki-Oberfläche (Skin) bestimmen. Wenn Sie einen Blick auf die Seite PageActions mit der Standard-Oberfläche von PmWiki werfen, sehen Sie, dass die Liste zweimal erscheint, einmal in der Mitte der Seite als normale, senkrechte Aufzählung mit Knöpfchen und einmal rechts oben als waagerechte Aneinanderreihung ohne Knöpfchen. Das wird durch die Tatsache kontrolliert, dass sie dort oben innerhalb einer HTML-<div>-Umgebung mit der ID 'wikicmds' dargestellt werden und die CSS-Regeln der Standard-Oberfläche setzen Listenelemente in dieser Umgebung eben nebeneinander und unterdrücken die Knöpfchen. Sie können den Effekt selbst sichtbar machen, denn PmWiki hat Textauszeichnungen, die es möglich machen, etwas in einer <div>-Umgebung mit der ID 'wikicmds' darzustellen:
StilDem ' In diesem Fall beginnt der Wikistil mit dem Wort ' <li class='edit'>...</li>
anstatt solcher <li><span class='edit'>...</span></li>
Das Setzen des Klassenattributs für die Liste gestattet es, CSS-Eigenschaften auf das Listenelement anzuwenden, passend zur aktuellen Aktion. Um zum Beispiel die aktuelle Aktion mit einem blauen Hintergrund zu versehen, könnte ein Administator dies tun: # das gehört in die Datei local/config.php
= ' .{$Action} { background-color: blue; }';
Dann würde die aktuell ausgeführte Aktion blau hinterlegt werden. Wenn Sie also gerade eine Seite bearbeiten (auf englisch 'edit'), wobei PmWiki ein '?action=edit' an den URL der Seite anhängt, wird das Listenelement 'Edit' passend zur ('edit'-)-Bearbeiten-Aktion mit einem blauen Hintergrund versehen werden. Das sieht allerdings erbärmlich aus. Die andere Eigenschaft innerhalb des Tastaturkürzel (Accesskey)Ein Tastaturkürzel kann an verschiedenen Stellen definiert werden, aber im Wesentlichen passiert es in einer Phrasenübersetzung, die dem Modell für die Internationalisierung folgt. PmWikis Tastaturkürzel werden in der Datei Das Man kann bei der deutschen Oberfläche gut sehen, wie diese Übersetzung arbeitet. In der Aktionsleiste stehen die Wörter 'Anzeigen', 'Bearbeiten', 'Versionen' und 'Druckansicht' für 'View', 'Edit', 'History' und 'Print'. In der Datei PmWikiDe.XLPage findet sich dazu ein Abschnitt — 'View' => 'View'
'Edit' => 'Edit'
'History' => 'History'
'Print' => 'Print'
— in dem diese Übersetzung definiert wird. Wenn Sie französisch oder spanisch können, überzeugen Sie sich, dass das auch mit anderen Sprachen funktioniert. Das macht es sehr einfach für PmWiki, diverse Sprachen zu unterstützen, da ein Rezept-Autor einfach alle übersetzbaren Phrasen
ins Innere von Verweis (Link)Alles was von der ersten Zeile zu erklären übrig bleibt, ist der Verweis selbst: Der Linkzielteil (links vom Pipesymbol '|') enthält die IfDamit ist erklärt, was es mit allen diesen '*'-Zeilen auf sich hat. Das lässt noch die Abhängig vom Sicherheits- und Rechte-Modell einer gegebenen Site ist es nicht ungewöhnlich, viel mehr bedingte Auszeichnungen zu sehen, die zum Beispiel testen, ob ein Benutzer das Bearbeiten-Recht an der augenblicklichen Seite hat. Fehlt dieses Recht, wird die Bearbeiten-Aktion nicht angezeigt. — Im einfachsten Modell wird das Recht erst abgefragt, wenn man die Aktion beginnt, dort darf man die Aktion also nicht ausblenden. Andererseits spart einem das Ausblenden auch nicht, die Schreibrechte einzurichten, denn jeder kann '?action=edit' an die URL anhängen. Weitere Informationen über die verschiedenen Bedingungen findet sich in der Seite Bedingte Auszeichnung, die generelle Übersicht über alle PmWiki-Dokumentationen finden Sie im Dokumentations-Index. Gruppen-SeitenaktionenJede Gruppe kann ihre eigene PageActions-Seite haben, nicht nur die Gruppe Site. Wenn es eine Seite mit dem Namen Group.PageActions gibt, benutzt PmWiki diese Seitenaktionen in der Gruppe 'Group'. Auf die Seitenaktionen der Site-Gruppe fällt PmWiki zurück, wenn die entsprechende Gruppenseite nicht vorhanden ist. Das funktioniert gerade so wie bei den SideBar-Seiten. Verbergen von AktionenWollen Sie die Aktionen in einer Seite nicht angezeigt sehen, fügen Sie in die Seite die Direktive SetTmplDisplay('PageActionFmt',0);
Sollen die Aktionen für eine ganze Gruppe verborgen werden, fügen Sie das Folgende in die local/Group.php-Datei ein (wobei 'Group' der Name der Gruppe ist): SetTmplDisplay('PageActionFmt',0);
Hoffentlich hat diese Dokumentation ein wenig Licht ins Dunkle gebracht, wenigsten, was die PageActions angeht. Wenn nicht, möchten Sie vielleicht in den PmWiki-Mailing-Listen Rat suchen. Übersetzung von PmWiki.SitePageActions, Originalseite auf PmWikiDe.SitePageActions — Backlinks
|