PmWikiDe / Seitenlisten

für die Liste aller Seiten

Autoren (Fortgeschrittene) und Administratoren

< Kategorien | Dokumentations-Index | Liste von Anhängen >

PmWiki kommt mit zwei Direktiven zum Erzeugen von Seitenlisten – (:pagelist:) und (:searchresults:). Beide Direktiven sind im Grunde das Gleiche und jede nimmt die unten beschriebenen Parameter entgegen. Der eigentliche Unterschied ist, dass searchresults die Nachrichten "Suche nach ..." und "### Treffer aus insgesamt ### durchsuchten Seiten" um das Ergebnis erzeugt.

Die (:searchbox:)-Direktive erzeugt ein Such-Formular (input text search box) zum Eintragen der Suchanfragen. Das Markup nimmt die gleichen Parameter wie (:pagelist:) entgegen, wodurch es möglich ist, das Suchergebnis in gleicher Weise einzuschränken, zu sortieren und zu formatieren wie es unten für (:pagelist:) beschrieben ist. Für weitere Informationen über die (:searchbox:)-Direktive und die Art, wie sie sich von (:pagelist:) unterscheidet, können Sie vorspringen zum Abschnitt Die Searchbox-Direktive.

Grundlegende Syntax

zeigt eine Liste gemäß der übergebenen Parameter an. Parameter sind optional.

Parameter

Alle Argumente, die in (:pagelist:) auftauchen und nicht von der Form 'Schlüssel=Wert' sind, werden als Text behandelt, der im Seitentext vorkommen muss (oder nicht darf).

Das Minus-Zeichen (-) kann benutzt werden um anzuzeigen, dass Dinge ausgeschlossen werden sollen. So listet

(:pagelist trail=PmWiki.DocumentationIndex list=normal Apfel -Strudel:)

alle "normalen" Seiten im Dokumentations-Index auf, die "Apfel" aber nicht "Strudel" enthalten.

Mit Seiten-Text-Variablen (STV)

In der englischen Dokumentation wird die Abkürzung PTV (page text variable) benutzt.

Man kann auch Seiten-Text-Variablen als Schlüssel benutzen, um Seiten gemäß der Existenz von Seiten-Text-Variablen aufzulisten.

(:pagelist $:seitentextvar=einwert:)

listet alle Seiten auf, in denen $:seitentextvar auf einwert gesetzt ist.
Minuszeichen (-), Joker (?*) und kommagetrennte Listen von Werten funktionieren auch, wenn eine Auswahl auf Seiten-Text-Variablen beruht.

Z. B. listet

(:pagelist $:eineseitentextvar=t*,-test:)

alle Seiten auf, deren Variable $:eineseitentextvar auf 't*' passt, aber nicht 'test' ist.

Beispiele:

STV ist gesetzt (ist nicht leer):(:pagelist $:MeineSeitenTextVariable=- :)
STV ist leer oder nicht gesetzt:
 (d. h. ist nicht gesetzt auf ein Zeichen,
 gefolgt von 0 oder mehr Zeichen)
(:pagelist $:MeineSeitenTextVariable=-?* :)
STV ist nicht WERT:(:pagelist $:MeineSeitenTextVariable=-WERT :)
STV ist gesetzt und nicht JA:(:pagelist $:MeineSeitenTextVariable=?*,-JA:)

Seien Sie auf der Hut, wenn Sie (:pagelist $:MySTV=$:YourSTV :) benutzen, Seiten-Text-Variablen enthalten Formatierungen, Sie könnten nicht die Treffer erhalten, die Sie eigentlich erwartet haben. Momentan ist der einzige Weg, darum herum zu kommen, der Gebrauch von Jokern; wenn Formatstrings enthalten sind, könnten Sie sich vom Glück verlassen fühlen.

Bemerkung: Beachten Sie, dass Pagelist keine Formatierungsanweisungen im Ausdruck auswertet, wenn mit STVs gearbeitet wird. Wenn also Ihre Seiten-Text-Variablen definiert sind, um damit den Wert zu setzen, wird Pagelist eher den wörtlichen Wert des Textes in Ihrem Ausdruck sehen als das Ergebnis Ihres Ausdrucks. Beispielsweise wird die STV-Definition (:foo:{(substr abcdef 2 4)}:) als eine öffnende geschweifte Klammer, gefolgt von einer öffnenden runden Klammer, gefolgt von s-u-b-s-t-r etc. angesehen, anstatt als b-c-d-e. Jedwede Auswertung des Ausdrucks in der Ausgabe Ihrer Seitenliste passiert in nachfolgenden Regeln (nach Pagelist) im Zusammenhang mit der aktuellen Seite und so können diese Werte nicht zum Sortieren oder Auswählen von Seiten genutzt werden. (Quelle)

Mit Seiten-Variablen (SV)

In der englischen Dokumentation wird die Abkürzung PV (page variable) benutzt.

Seitenspezifische Variablen können in Seitenlisten auf die gleiche Weise benutzt werden wie Seiten-Text-Variablen. Siehe oben für weitere Einzelheiten. Man benutzt einfach $var statt $:var.

group= und name=

Die "group="- und "name="-Parameter begrenzen das Ergebnis auf Seiten in einer bestimmten Gruppe oder mit einem bestimmten Namen:

Alle Seiten der PmWikiDe-Gruppe: (:pagelist group=PmWikiDe :)
Alle Seiten außer denen der PmWikiDe- oder Site-Gruppe: (:pagelist group=-PmWikiDe,-Site :)
Alle RecentChanges-Seiten (:pagelist name=RecentChanges :)
Alle Seiten außer RecentChanges (:pagelist name=-RecentChanges :)

Joker

Namen-, Gruppen-, Verweis- und Kategorie-Parameter können Joker-Zeichen enthalten, die nur Seiten zeigen, die auf ein gegebenes Muster passen:

Beispiele:

Alle Seiten in allen Gruppen, die mit "PmWiki" beginnen: (:pagelist group=PmWiki* :)
Alle Seiten in allen Gruppen, die mit "PmWiki" beginnen außer chinesische: (:pagelist group=PmWiki*,-PmWikiZh :)
Alle Seiten in der PmCal-Gruppe, deren Name mit "2005" beginnt: (:pagelist name=PmCal.2005* :)
Alle Kochbücher, deren Name mit einem A oder einem B beginnen:
Beachten Sie die verschiedenen Bezeichner, die zum gleichen Ergebnis führen.
(:pagelist group=Cookbook  name=A*,B*   :)
(:pagelist name=Cookbook.A*,Cookbook.B* :)
(:pagelist group=Cookbook  name=[AB]*   :)
(:pagelist name=Cookbook.[AB]*          :)
Seiten in den Kategorien Media oder Images (wenigstens eine Kategorie)
(:pagelist category=Media,Images  :)
Seiten in den Kategorien Media und Images (beide)
(:pagelist category=+Media,+Images  :)

Wenn Sie mehrfache Bedingungen benutzen wollen, müssen Sie Kommata als Trenner einsetzen. Zum Beispiel

key="ein Wert,anderer Wert"

trail=

Die "trail="-Option besorgt sich die Liste der anzuzeigenden Seiten aus einem Seitenabfolgeindex:

(:pagelist trail=PmWiki.DocumentationIndex order=-time:)
(:pagelist trail=RecentChanges count=5:)

list=

Die "list="-Option erlaubt einer Suche, Seiten ein- oder auszuschließen bezüglich vom Administrator vordefinierter Muster

Wikiadministratoren können angepasste Listen über das Suchmuster-Array $SearchPatterns definieren (siehe Cookbook:SearchResults).

fmt=

Die "fmt="-Option bestimmt, wie das Ergebnis angezeigt wird. PmWiki definiert mehrere Formate vor:

Diese Formate werden definiert in Seitenlistenvorlagen, die angepasst werden können (siehe auch Seitenlisten mit Standardvorlagen und PageListTemplates (in Englisch)).

fmt=count

Dies Format ist nicht in der Seitenlistenvorlage definiert:

link= und category=

Die "link="- und "category="-Argumente implementieren Rückverweise – d. h., sie geben eine Liste von Seiten zurück, die einen Verweis auf das Ziel enthalten oder in denen die Kategorie deklariert ist. Das ist insbesondere nützlich für Kategorie-Seiten und zum Finden zugehöriger Seiten.

Das category=Name-Argument unterscheidet sich vom link=Category.Name-Argument, indem es nur Seiten auflistet, die in der Kategorie deklariert sind mit dem Markup [[!Name]], dagegen sind Seiten, die einfach auf [[Category/Name]] verweisen, nicht enthalten (es sei denn, sie enthalten ebenfalls [[!Name]]).

(:pagelist link=PmWikiDe.DocumentationIndex:)
(:pagelist link={$FullName}:)
(:pagelist category=Skins:)

Seit PmWiki 2.3.0 akzeptieren link= und category= mehrfache und negative Ziele sowie Listen mit Jokerzeichen, siehe Abschnitt Joker.

Beachten Sie, link= and category= ignorieren die Direktiven (:if...:), (:include...:), (:redirect...:), (:pagelist...:) und Seitentextvariablen-Direktiven, während sie nach Verweisen in den Seiten suchen. Das bedeutet, dass Verweise in eingefügten Seiten nicht gefunden werden, aber Verweise innerhalb nicht angezeigter bedingter Auszeichnungen gefunden werden. Siehe hierfür in Seitentextvariablen, wie Verweise in einer Seite versteckt werden, aber dennoch von link= gefunden werden können. Im Kapitel über Seiten-Text-Variablen werden Wege beschrieben, einen Verweis auf einer Seite zu verstecken und doch link= zu erlauben, ihn zu finden.

Beachten Sie außerdem, dass das neue category=-Argument erfordert, dass alle Seiten, die [[!Category]]-Verweise enthalten, reindiziert werden müssen. Siehe hierzu das Rezept Cookbook:ReindexCategories, das diesen Vorgang automatisieren kann.

count=

Die "count="-Option bietet die Möglichkeit,

Eine einfache, unnummerierte Liste der zehn zuletzt geänderten Seiten:

(:pagelist trail=Site.AllRecentChanges count=10 fmt=#simple:)

Zeige die ersten zehn Seiten einer Liste an:
count=10       # Zeige die ersten zehn Seiten an
Negative Zahlen zählen die Seiten vom Ende der Liste aus:
count=-10      # Zeige die letzten zehn Seiten an
Bereiche können mit '..' angegeben werden, so wie hier:
count=1..10    # die ersten zehn Seiten
count=5..10    # 5. bis 10. Seite
Negative Zahlen in Bereichen zählen von Ende der Liste aus:
count=-10..-5  # 10. von hinten, 9. von hinten, 
                 ..., 5. von hinten
Lässt man den Start oder das Ende des Bereiches weg, wird dafür der Start oder das Ende der Liste gesetzt:
count=10..     # überspringe die ersten zehn Seiten
count=..10     # 1. bis 10. Seite
count=-10..    # die letzten zehn Seiten
count=..-10    # Alle bis auf die letzten neun Seiten
Bereiche können umgedreht werden, um anzuzeigen, dass die Reihenfolge der Seiten in der Ausgabe ebenso umgedreht werden sollen:
count=5..10    # 5. bis 10. Seite
count=10..5    # das gleiche rückwärts
count=-1..1    # Alle Seiten von hinten 
                 nach vorn aufgelistet
"Rückwärts zählen" hier bezieht sich auf die Liste nach der Sortierung, deshalb sind die drei Anweisungen rechts äquivalent:
(:pagelist order=-name count=10:)
(:pagelist order=-name count=1..10:)
(:pagelist order=name  count=-1..-10:) 

Vergleiche fmt=count

wrap=

Die "wrap"-Option hat die Werte none und inline.

Mit "wrap=inline" und "wrap=none" wird die Ausgabe der Seitenliste (Markup oder HTML) direkt im Markup der Seite eingebettet ohne irgendwelche umgebenden <div class=...> - </div>-Tags.

Mit "wrap=inline" wird eine umgebende <ul> fortgesetzt. Ohne "wrap=inline" startet die HTML-Ausgabe eine neue <ul> (nicht umgekehrt?). Das ist wichtig, wenn man möchte, dass die Seitenliste eine zweite Ebene in der <ul> erzeugt, denn der Beginn einer neuen Liste mit "**" führt nicht zu einer zweiten <ul>-Ebene sondern zu <dl><dd><ul>...

"wrap=inline" hat außerdem noch andere Effekte, da es den Aufruf von $FPLTemplateMarkupFunction unterdrückt (die standardmäßig MarkupToHTML ist).

class=

Standardmäßig hat eine Seitenliste die 'fpltemplate'-Klasse. Die 'bygroup'-, 'simple'-, 'group'- und 'title'-Seitenlistenformate haben eigene Klassennamen fplbygroup, fplsimple etc. Man kann selbst eine Klasse mit dem class=-Parameter angeben oder durch setzen des $FPLFormatOpt-Arrays.

request=

Mit (:pagelist [andere Parameter] request=1:) können Sie die meisten Seitenlisten-Parameter überschreiben, indem Sie die Parameter in den URL einfügen.
Beispiele:

Hinweise: Kodieren Sie jedes "#" in dem URL als "%23".
Da dieser Parameter Benutzern ohne Bearbeiten-Recht die Möglichkeit gibt, Seitenlisten nach ihrer Façon zu gestalten, sollten sie seine Sicherheitsauswirkungen für Ihre Website beachten, bevor Sie ihn einsetzen.

Seit Version 2.2.71 ist es möglich, explizit nur bei ausgewählten Parametern zu erlauben, sie zu überschreiben, oder bei einigen Parametern zu verbieten, sie zu überschreiben. Wenn Sie das brauchen, setzen Sie statt der 1 den Parameternamen ein.

Alle Parameter zum Überschreiben frei geben:
(:pagelist request=1:)

Nur die Parameter 'order' und 'count' dürfen überschrieben werden:
(:pagelist request=order,count:)

Erlaube, alle Parameter zu überschreiben, außer 'fmt' und 'trail', beachten Sie das Minuszeichen vor jedem verbotenen Parameter.
(:pagelist request=-fmt,-trail:)

req=1

Der req=1-Parameter erfordert, dass Suchbegriffe übertragen werden (das heißt, dass der Benutzer "Suchen" in einem Suchenformular angeklickt hat oder einen Verweis mit zusätzlichen Parametern folgt wie [[Page?q=terms&order=-name]]), bevor die Seitenliste erzeugt wird.
Beachten Sie, dass (:pagelist request=1 req=1:) fast wie (:searchresults:) funktioniert, wenn auch ohne die Zeilen "Suche nach ..." und "X Treffer aus insgesamt Y durchsuchten Seiten.". Beide Parameter "request=1" und "req=1" sind nötig.

Wenn eine Suche durchgeführt wird, entweder über eine searchbox-Direktive oder das Suchfeld des Skins, wird die Seite zum Darstellen des Suchergebnisses benutzt, wenn die Seite eine searchresults-Direktive enthält; enthält die Seite die searchresults-Direktive nicht, wird Site.Search für die Ausgabe des Suchergebnisses benutzt.

passwd=

Die "passwd"-Option liefert nur jene Seiten zurück, die eins der Passwortattribute gesetzt haben (z. B. passwd=write).

if=

Die "if"-Option erlaubt Bedingungen für die Erzeugung von Seitenlisten zu setzen, statt dies in den Seitenlistenvorlagen zu tun. Nur die Seiten, für die die Bedingung wahr ist, werden ausgeliefert. Alles, was in einem (:if ...:) funktioniert, kann als Bedingung genommen werden. Zum Beispiel liefert

(:pagelist if="date {(ftime %GW%V {*$Name})} {=$Name}" :)

alle Seiten aus, deren Namen in der gleiche Woche liegt wie der Name der aktuellen Seite (also der Seite, in die die Liste eingebettet ist).

Wenn ein Argument innerhalb der Anführungszeichen Leerzeichen enthalten kann, muss es in einfache Anführungszeichen gesetzt werden.

  (:pagelist if="date 2009-01-01..2009-12-31 '{=$:Mydate}'" :)

order=

Die "order="-Option erlaubt es, die gelisteten Seiten nach unterschiedlichen Kriterien zu sortieren. Mit einem Minuszeichen erreicht man eine umgedrehte Sortierreihenfolge. Mehrfache Sortierkriterien können durch Kommata getrennt angegeben werden. Außerdem können Sie Ihre eigenen Sortierreihenfolgen erzeugen:

Außerdem erlaubt die order=-Option angepasste Sortierfunktionen zu schreiben.

cache=0

Seitenlisten können zwischengespeichert werden, was den Prozess erheblich beschleunigt (wenn $PageListCacheDir gesetzt ist). Hin und wieder führt dieses Zwischenspeichern zu unerwünschten Ergebnissen, die Angabe von cache=0 schaltet das Zwischenspeichern ab.

Variablen als Parameter angeben

Man kann auch Variablen innerhalb der Seitenlistenanweisung angeben und sich in der Vorlage auf diese Variablen beziehen, indem man das {$$variable1}-Format benutzt.

(:pagelist fmt=#pagelist variable1="value" variable2="value2":)

Das setzt voraus, dass die Site $EnableRelativePageVars gesetzt hat, was in PmWiki 2.2.0 empfohlen wird – aber standardmäßig ausgeschaltet ist, um ein Upgraden von 2.1.x zu erleichtern (seit 2.2.9 die Standardeinstellung).

Zum Beispiel mit der Vorlage

>>comment<<
[[#tvars]]
(:template default count=1 ParamName=Simon:)
Hi, {$$ParamName}, how are you today?
[[#tvarsend]]
>><<

(:template default count=1 ParamName=Simon:) Hi, {$$ParamName}, how are you today?

erhält man:

(:pagelist fmt=#tvars ParamName="Sam":)

(:pagelist fmt=#tvars ParamName="Sally":)

(:pagelist fmt=#tvars:)

Hi, Sam, how are you today?

Hi, Sally, how are you today?

Hi, Simon, how are you today?

Siehe auch $EnableUndefinedTemplateVars.

Beispiele

Schließe den Inhalt einer zufälligen Seite aus der Bannergruppe ein:

(:pagelist group=Banners order=random count=1 fmt=#include list=normal:)

Zeige eine einfache Liste der zehn zuletzt geänderten Dateien an:

(:pagelist trail=Site.AllRecentChanges count=10 fmt=#simple:)

Die Searchbox-Direktive

Die (:searchbox:)-Direktive nimmt generell die gleichen Parameter wie die (:pagelist:)- und die (:input search:)-Direktive an:

Der zusätzliche Parameter label="Label" kann benutzt werden, um die Aufschrift der zugehörigen Submit-Schaltfläche zu ändern.

   (:searchbox label="Durchsuche dies Wiki":)

Standardmäßig hat das Eingabefeld den "Text"-Typ wegen der Kompatibilität mit HTML/XHTML. Alternativ können Sie es für HTML5 auf den "search"-Inputtyp setzen, siehe $SearchBoxInputType (einige HTML5-Skins setzten das schon ein).

Die Suchergebnis-Direktive

Die (:searchresults:)-Direktive nimmt generell die gleichen Parameter wie die (:pagelist:)- und die (:input search:)-Direktive an.

request=1 req=1

Die Suchergebnisse erscheinen ohne die Einleitung, die da heißt "Suche nach ..." .

Anpassen von "Suche nach ..." und "3 Treffer auf ..."

Um die Texte, die das Suchergebnis umrahmen, zu ändern, kann man das Folgende anpassen und zur local/config.php oder zur $FarmD/local/farmconfig.php hinzufügen.

XLSDV('de', array(
        'SearchFor' => 'Suchergebnis für <em>$Needle</em>:',
        'SearchFound' => 
                '$MatchCount Seiten gefunden unter $MatchSearched durchsuchten Seiten.'
));
Hinweis: 'de' muss für andere Sprachen als Deutsch entsprechend angepasst werden.

Alternativ kann man auch die 'SearchFor'- und 'SearchFound'-Strings in der Übersetzungsseite anpassen.

Auch die $SearchResultsFmt-Variable kann in local/config.php oder $FarmD/local/farmconfig.php gesetzt werden.

SDV($SearchResultsFmt, "<div class='wikisearch'>\$[SearchFor]
    <div class='vspace'></div>\$MatchList
    <div class='vspace'></div>\$[SearchFound]</div>");

Sie können auch die Zeilen über und unter der erzeugten Liste entfernen, indem Sie dies in die config.php-Datei einfügen:

$SearchResultsFmt = '$MatchList';

Siehe auch

FAQ

Wie öffnet PmWiki Seiten mit PageStore?

Wenn PmWiki eine Datei zum Lesen öffnen muss, fragt es die PageStore-Objekte eines nach dem anderen, in der Reihenfolge, in der Sie sie in der config.php-Datei definiert haben, ob sie MeineGruppe.MeineSeite haben. Das erste PageStore-Objekt, das diese Seite findet, gibt sie zurück und wenn es noch mehr PageStore-Objekte gibt, werden diese nicht behelligt.

Wenn Sie ein PageStore-Objekt definieren mit Pfaden wie wiki.d/{$Group}/{$FullName} und dann fragen "gibt es eine Seite MeineGruppe.MeineSeite", prüft das PageStore-Objekt nur "ist da eine Datei wiki.d/MeineGruppe/MeineSeite", es sieht also nur in dem Unterverzeichnis ''ki.d/MeineGruppe nach, nicht in anderen Unterverzeichnissen.

Wenn Sie eine Seite schreiben, wird nur das erste PageStore-Objekt benutzt, das gewöhnlich $WikiDir ist. So können wir die Dokumentation in wikilib.d haben, doch wenn Sie eine Seite aus PmWiki oder der Site-Gruppe bearbeiten, wird sie in wiki.d gespeichert und von da an wird nur noch diese Datei in wiki.d gelesen und geschrieben.

Wie ist das Verhalten von pagelist und searchresults, wenn nur ein Name oder Wort angegeben wird?

Beide, pagelist und searchresults, durchsuchen alle Gruppen, außer entweder

  • es gibt ein group=DieseGruppe-Argument im Suchfeld oder im Markup, oder
  • Sie haben (:template default group=EineGruppe,{*$Group}:) in der pagelist-Vorlage, oder
  • es gibt ein request=1-Argument im Markup und da ist irgendwie ein $_REQUEST['group']-Argument, z. B. vom Suchformular oder von der URL, oder
  • Sie setzen irgendwelche $SearchPatterns['xy'] und list=xy, oder
  • setzen eine Standard-$MakePageListOpt['gruppe'] oder $SearchBoxOpt['gruppe'].

Wenn eine Option nicht benutzt wird, sollte diese Option nicht vordefiniert werden.

  • Wenn es kein Suchwort gibt, zeige alle Seiten;
  • wenn group= nicht benutzt wird, zeige alle Gruppen;
  • wenn name= nicht benutzt wird, zeige alle Seiten;
  • wenn link= nicht benutzt wird, zeige Seiten, die irgendwo hin zeigen oder auch nicht;
  • wenn count= nicht benutzt wird, zeige alle Seiten anstatt nur einen Teil davon (die einzige Ausnahme ist die order=-Option, die als Standard order=name enthält, da ohne diesen Standard die Ergebnisse zwischen Seitennachladen uneinheitlich sortiert werden, was besonders unglücklich ist, wenn Sie auch noch count=21..30 benutzen.

Wie kann eine eigene Funktion das Ergebnis einer Seitenliste als Array abrufen?

Siehe diesen Thread in der Mailingliste. für die Liste aller Seiten

< Kategorien | Dokumentations-Index | Liste von Anhängen >


Übersetzung von PmWiki.PageLists,   Originalseite auf PmWikiDe.PageLists   —   Backlinks

Zuletzt geändert:   PmWikiDe.PageListsam 04.03.2023
 PmWiki.PageListsam 03.03.2023