Suche

für die Liste aller Seiten

PmWiki bietet eine Basis-Such-Funktion. Wenn diese auch nicht auf einer "Suchmaschine" basiert, so kann sie doch dazu gebracht werden, Ergebnisse zu produzieren, die zielgerichtet und angepasst sind.

Zielgerichtete Suche

Eine Suche kann darauf zielen, die Suche auf bestimmte Seiten zu beschränken. Z. B. kann die Suche auf der Basis von Gruppen beschränkt werden, wo etwa "group=PmWiki" nur die PmWiki-Gruppe durchsucht und "group=-PmWiki" nur Seiten durchsucht, die nicht in der PmWiki-Gruppe sind. Zusätzlich zu Gruppen können Suchen auf der Basis von Namen ("name="), Seitenabfolgen ("trail="), Rückverweisen ("link=") und anderen Kriterien (so etwa "list=normal") beschränkt werden und auf eine maximale Anzahl beschnitten werden ("count="). Konsultieren Sie die Seite Seitenlisten für eine Dokumentation all dieser Parameter.

Angepasste Darstellung

Die Darstellung der Suchergebnisse kann angepasst werden, um das Format, den Inhalt und die Reihenfolge des Gelieferten zu kontrollieren.

fmt=

wählt Format und Inhalt, indem es eine Seitenlistenvorlage angibt, die das Layout bestimmt, wie Listenstile, und Seitenelemente, wie Titel und Beschreibung.

order=

erlaubt die Sortierung des Ergebnissen nach verschiedenen Kriterien, wie Name und Titel. Konsultieren Sie die Seite Seitenlisten für die Dokumentation der einzelnen Parameter.

Beispiele von Seitenlistenvorlagen finden Sie in Site.PageListTemplates, Site.LocalTemplates? und Cookbook:PagelistTemplateSamples.

Die (:pagelist request=1 req=1:)-Direktive kann anstelle von (:searchresults:) eingesetzt werden, um die Zeilen "Suche nach ..." und "X Treffer aus insgesamt Y durchsuchten Seiten." zu unterdrücken. Keiner dieser Parameter funktioniert für die (:searchresults:)- oder (:searchbox:)-Direktiven.

req=1

unterdrückt die Ausgabe der Liste, bis Suchergebnisse geliefert werden.

request=1

siehe Seitenlisten

Dies kann in viel mehr Fällen benutzt werden als nur bei der Standard-Wiki-Suche. Daten von Seiten mit STVs etc. können durchsucht, gefiltert und umsortiert werden.
Beachten Sie, dass die Standardsortierung auf Texten basiert, also 1, 10, 2, 3 liefert, und nicht nach numerischen Werten 1, 2, 3, 10 sortiert. Eine angepasste Sortierfunktion kann allerdings jede beliebige gewünschte Sortierung liefern (siehe allgemein Cookbook:Cookbook und speziell Angepasste Seitenlistenreihenfolge).

Jeder, überall

Leser können zielgerichtete und angepasste Suchen erzeugen, indem sie einfach die relevanten Parameter, z. B. "group=PmWiki", zusammen mit dem Suchbegriff in den Kasten einfügen. Autoren können solche zielgerichteten und angepassten Suchen vordefinieren, indem sie die Parameter in Seiten einbauen, die die (:searchbox:)- und (:searchresults:)-Direktiven benutzen (dokumentiert in Seitenlisten).

(:searchresults:) (Suchergebnisse) können Sie anpassen, indem Sie die Seite Site.Search bearbeiten.

Siehe auch

• $PageSearchForm
• $SearchBoxOpt
• $SearchPatterns

Probieren Sie's: Diese Seite erzeugt angepasste Suchergebnisse

Jede Suche, die von dieser Seite ausgeht, erzeugt automatisch einen vordefinierten Satz von Suchergebnissen,

• die auf verschiedene Sammlungen von Seiten zielen ('documentation', 'cookbook' und 'PITS', wenn sie erreichbar sind);
• die angepasste Formate, Sortierungen und Inhalte benutzen; und
• die die spezifischen Parameter offenlegen, die bei den jeweiligen Suchergebnissen benutzt wurden.

Ob Sie nun den Suchkasten hierunter benutzen oder den regulären Suchkasten, der oben auf der Seite erscheint, in jeder Suche, die Sie auf dieser Seite ausführen, werden die angepassten Ergebnisse geliefert.

für die Liste aller Seiten

---