API:Search and discovery/de

MediaWiki, seine Erweiterungen und und seine Schwesterprojekte bieten enormes Potenzial, um Wissen durch Suchen zu entdecken. Das Search-Platform-Team entwickelt den Mechanismus, Werkzeuge und Dienste, um dies zu tun.

Benutzer können Informationen in MediaWiki finden, indem sie sie direkt suchen und in Wikidata, indem sie Help:Navigation in Wikidata lesen.

MediaWiki
Die MediaWiki API hat unterschiedliche Module mit Bezug zu Suchen. Du kannst am -Eingangspunkt jedes Wikis Abfragen stellen und dir die generierte Hilfe ansehen oder auf Special:ApiSandbox API-Abfrageparameter eintragen.

Suchmodule

 * action=opensearch
 * Siehe . Gibt Suchergebnisse im OpenSearch-Format aus, jeweils mit in Wikimedia-Projekten. Generierte API-Hilfe ansehen


 * action=languagesearch
 * Nach Sprachnamen in einem beliebigen Skript suchen. Generierte API-Hilfe ansehen

Abfragelisten-Submodule
Diese Abfrage-Submodule geben eine Liste von Wiki-Seiten aus, die Such-Kriterien erfüllen und geben teilweise zusätzliche Informationen über jede Seite aus. Darüber hinaus kannst du jedes als Generator nutzen, um viele andere Eigenschaften zu den zurückgegebenen Seiten bereitzustellen, wie das Einleitungsbild, Ausschnitt und/oder Seitenbeschreibung.


 * action=query list=prefixsearch
 * Ruft Titel von Wiki-Seiten mit dem angegebenen Präfix ab. Siehe den Artikel Seiteninfo in Suchergebnissen. Siehe die Modul-Dokumentation für und sieh dir die generierte API-Hilfe an.


 * action=query list=search
 * Nutzt die Wiki-Suchmaschine, um passende Seiten zu finden. In Wikimedia-Wikis bietet es Suchergebnisse der CirrusSearch, die typische Informationen zu Suchergebnissen, wie Text-Ausschnitte und Seitengröße ausgibt. Siehe die Modul-Dokumentation für und sieh dir die generierte API-Hilfe an


 * action=query list=geosearch
 * Wenn die GeoData-Erweiterung im Wiki installiert ist, gibt dies Wiki-Seiten in der Nähe mit geografischen Informationen aus. Siehe den Artikel Nahegelegene-Orte-Betrachter, die Modul-Dokumentation für die Geosuche und sieh dir die generierte API-Hilfe an.

Kommandozeile
Aus der Kommandozeile kannst du die API abfragen, indem du cURL nutzt, um die API-Abfrage zu stellen und jq, um die JSON-Abfrage zu parsen.

Lass uns zum Beispiel das Datenobjekt in Wikidata nachschlagen und die englische Bezeichnung abfragen:

Wir finden heraus, dass Q39246 der Wikidata-Identifikator für das Datenobjekt mit der englischen Bezeichnung "Richard Feynman" ist und dass es 55 Aussagen über ihn gibt.

JavaScript
Um einen MediaWiki-API-Client in JavaScript zu schreiben, wird nur ein JSONP-Handler benötigt. Viele Bibliotheken (z.B. jQuery) umfassen JSONP-Clients oder es kann ein unabhängiger geschrieben werden.

Im MediaWiki-Ökosystem kann jQuery direkt genutzt werden:

Dies nutzt  von jQuery, der in vielen interaktiven JavaScript-Code-Umgebungen verfügbar ist und Sinn macht, wenn dein Ziel ein eigenständiges Projekt ist.

Wenn dein Ziel ist, Code in einem Wiki auszuführen, z.B. als Gadget, solltest du die höherstufige Funktion  nutzen, die vom 'mediawiki.api'-ResourceLoader-Modul angeboten wird.

In anderen Umgebungen kann ein einfacher JSONP-Handler geschrieben werden:

CirrusSearch
CirrusSearch ist eine MediaWiki-Erweiterung, um die Elastic-basierte Suche des MediaWiki-Inhalts zu aktivieren. Sie fungiert als Such-Backend, wobei  die Haupt-Oberfläche hierfür ist.

Du kannst die gleichen Cirrus-Funktionen in API-Abfragen nutzen, die Benutzer in die Such-Box eingeben können. Zum Beispiel kannst du das Spezial-Präfix  nutzen, um verwandte Seiten zu finden.

Zusätzliche CirrusSearch-API-Module
Zusätzlich kann CirrusSearch seine Konfiguration und interne Informationen ausgeben. Diese APIs sind wahrscheinlich nur nützlich, wenn du dich mit Elasticsearch auskennst und sehen möchtest, wie CirrusSearch sie nutzt. Sie sind alle interne APIs zur Fehlersuche und es gibt keine Garantien hinsichtlich ihrer Rückwärts-Kompatibilität von Änderungen ihrer Ausgabe.


 * Seitenparameter
 * Zum Beispiel https://en.wikipedia.org/wiki/2014?action=cirrusdump


 * -Parameter für Special:Search-Abfragen
 * Dies ist ein Action-Parameter für index.php, zum Beispiel https://en.wikipedia.org/wiki/Special:Search/cat%20dog%20chicken?cirrusDumpQuery


 * -Parameter für Special:Search-Abfragen
 * Dies ist ein Action-Parameter für index.php, zum Beispiel https://en.wikipedia.org/wiki/Special:Search/cat%20dog%20chicken?cirrusDumpResult
 * Ein zusätzlicher Parameter  kann mit   übergeben werden, um die Lucene-Erklärung des Ergebnisses zu erhalten, das im Ergebnis-Dump enthalten ist. Zum Beispiel https://en.wikipedia.org/wiki/Special:Search/cat%20dog%20chicken?cirrusDumpResult&cirrusExplain


 * API-Module cirrus-config-dump, cirrus-settings-dump, cirrus-mapping-dump
 * Diese geben das CirrusSearch-Setup aus.

Wikidata
Die Wikidata-API enthält einige Funktionen (wbgetentities, wbgetclaims, wbsearchentities), die genutzt werden können, um nach Informationen über Datenobjekte, Eigenschaften und Aussagen zu suchen.

Wikidata-Abfragedienst
führt graph-basierte Suchen in über eine SPARQL-API aus. Er ist verfügbar auf https://query.wikidata.org/

Der WDQS-Explorer (Demo) (Quellcode) bietet Graph im Browser an, indem SPARQL-Abfragen an den Wikidata-Abfragedienst gestellt werden.

Wikipedia
Gehe auf https://en.wikipedia.org/wiki/Main_Page, öffne die JavaScript-Konsole und führe folgendes aus:

Dadurch wird die Zeichenkette  in der JavaScript-Konsole protokolliert.

Wenn die MediaWiki-Bibliotheken und -Umgebung nicht verfügbar sind, kann dies durch Nutzung der Funktion  von oben erfolgen:

Wikidata
Durch Nutzung von JSONP können wir die Schritte direkt von der JavaScript-Konsole des Browsers aus ausführen. In Wikipedia ist der Wikidata-Datenobjekt-Identifikator über den MediaWiki-Konfigurationswert  verfügbar.

Gehe auf https://en.wikipedia.org/wiki/Richard_Feynman, öffne die JavaScript-Konsole und führe folgendes aus:

Dadurch wird die Zeichenkette  und die Zeichenkette der Beschreibung des Wikidata-Eintrags "American quantum physicist" in der JavaScript-Konsole protokolliert.

Wenn die MediaWiki-Bibliotheken und -Umgebung nicht verfügbar sind, kann dies durch Nutzung der Funktion  von oben erfolgen:

Wiktionary
Gehe auf https://en.wikipedia.org/wiki/Main_Page, öffne die JavaScript-Konsole und führe folgendes aus:

Dadurch wird die Zeichenkette  in der JavaScript-Konsole protokolliert.

Wenn die MediaWiki-Bibliotheken und -Umgebung nicht verfügbar sind, kann dies durch Nutzung der Funktion  von oben erfolgen: