Suchen

PmWiki bietet eine grundlegende Suchfunktion. Da sie nicht von einer "Suchmaschine" unterstützt wird, kann sie optimiert werden dahingehend, dass ihre Ergebnisse auf bestimmte Ziele beschränkt und ihre Ausgabe angepasst werden kann.

Zielgerichtete Suche

Die Suche kann auf Ziele gerichtet werden, indem sie auf bestimmte Seiten begrenzt wird. Eine Suche kann z. B. auf Gruppen begrenzt werden, indem etwa mit "group=PmWikiDe" nur in den Seiten der deutschen Dokumentation gesucht wird oder mit "group=-PmWikiDe" alle deutschen Seiten von der Suche ausgeschlossen werden. Zusätzlich zu Gruppen kann die Beschränkung auf Seitennamen ("name="), Seitenabfolgen ("trail="), Rückverweise ("link=") und andere Kriterien (z. B. "list=normal") erfolgen und die Ergebnisliste an einer Maximalzahl gekappt werden ("count="). Für eine ausführliche Dokumentation dieser Parameter siehe Seitenlisten.

Angepasste Ausgabe

Die Ausgabe der Suchergebnisse kann angepasst werden, indem man das Format, den Inhalt und die Sortierung des zurückgelieferten Ergebnisses beeinflusst. Format und Inhalt werden ausgewählt über den "fmt="-Parameter, mit dem man eine Seitenlistenvorlage wählt, die das Layout, etwa Listenstile, und Seitenelemente, wie etwa Titel und Beschreibung, bestimmt. Die "order="-Option erlaubt es, das Ergebnis nach verschiedenen Kriterien zu sortieren, etwa nach Namen oder Titeln. Für die Dokumentation jedes dieser Parameter siehe Seitenlisten. Für Beispiele von Seitenlistenformaten siehe Site.Page List Templates und Cookbook:Pagelist Template Samples.

Die (:pagelist request=1 req=1:)-Direktive kann kann anstelle von (:searchresults:) benutzt werden, um die "Suche nach ..."-Meldung und die "### Treffer auf insgesamt ### durchsuchten Seiten"-Meldung zu entfernen. Der "req=1"-Parameter deaktiviert die Seitenliste, wenn die Suche kein Ergebnis liefert. Das kann in mehr Fällen als nur der Standardsuche von PmWiki genutzt werden. Daten von Seiten mit PVTs etc. können durchsucht, gefiltert und sortiert werden. Beachten Sie, dass die Standardsortierung nach Textstrings geschieht, d. h. 1, 10, 2, 3 und nicht 1, 2, 3, 10, hingegen kann eine angepasste Sortierfunktion (siehe das Kochbuch) jede gewünschte Sortierreihenfolge erzeugen.

Jeder, überall

Leser können zielgerichtete, angepasste Suchergebnisse erzeugen, indem sie einfach die relevanten Parameter, z. B. "group=-PmWikiDe" — ohne die Anführungszeichen —, zusammen mit ihrem Stichwort in das Suchfeld eingeben. Autoren können solche zielgerichteten, angepassten Suchergebnisse vordefinieren, indem sie die (:searchbox:)- and (:searchresults:)-Direktiven benutzen (dokumentiert in Seitenlisten).

(:searchresults:) können durch bearbeiten der Seite Site.Search angepasst werden.

Siehe auch

• $PageSearchForm
• $SearchBoxOpt
• $SearchPatterns

Probieren Sie es aus: diese Seite erzeugt ein spezielle Ergebnis

Jede Suche, die von dieser Seite ausgeht, erzeugt automatisch ein vordefinierten Satz von Ergebnissen, der: auf verschiedene Seitenbereiche zielt (Dokumentation, Kochbücher und PITS, falls vorhanden); angepasste Formate, Inhalte und Sortierung benutzt und schließlich die spezifischen Parameter aufdekt, mit denen die Suchergebnisse erzeugt wurden. Ob Sie nun das Eingabefeld unten oder das reguläre Suchfeld oben über dem Seiteninhalt benutzen, jede Suche, die von dieser Seite ausgeht, mündet in die spezielle Ausgabe des Suchergebnisses.

Originalseite auf PmWikiDe.Suchen - Rückverweise
Zuletzt geändert:
PmWikiDe.Suchen am 09.07.2012