Hilfe:URL-Parameter

aus Wikipedia, der freien Enzyklopädie
Dies ist die aktuelle Version dieser Seite, zuletzt bearbeitet am 12. September 2022 um 20:10 Uhr durch imported>PerfektesChaos(310926) (+ dtunsubscribe).
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

Über die URL https://de.wikipedia.org/ kann die deutschsprachige Wikipedia aufgerufen werden. Alle weiteren Seiten sind über Links, Suchfenster oder Schaltflächen erreichbar. Dennoch kann gelegentlich zusätzliches Wissen über eine URL und ihre Parameter notwendig sein.

Werte

Für Einstellungen als falsch oder wahr wird in der Regel die Ziffer 0 oder 1 erwartet. Oft funktioniert auch true für wahr. In einigen älteren Programmierungen werden nur die hier genannten Werte ermöglicht.

Auf dieser Hilfeseite wird Schreibmaschinenschrift für buchstäblich zu übernehmende Zeichen verwendet; Kursivschrift als Platzhalter für aktuell einzusetzende Werte.

URL-Format

Die allgemeine Struktur bei Verwendung von URL-Parametern lautet:

(bzw. http:// oder ganz ohne vorangestelltes Protokoll //). Statt mit title=Seitenname kann die Seite auch über curid=PageId identifiziert werden.

Alternativ können Parameter auch dem einfachen Format für Seitennamen nachgestellt werden, indem ein Fragezeichen dem Seitennamen folgt:

https://de.wikipedia.org/wiki/Seitenname?Parametername=Wert

Grundsätzlich können beliebig viele Zuweisungen folgen in der Form

&Name=Wert

Wenn die Werte (insbesondere Seitennamen) Zeichen enthalten, die nicht zum ASCII-Zeichensatz gehören oder wie & und ? eine Sonderbedeutung haben, müssen sie kodiert werden.

Es gibt in allen Wikis vier Pfade mit vielen Einträgen:

  1. /wiki/ – eine Clean URL als Abkürzung von /w/index.php?title=
  2. /w/ – die „Skripte“, namentlich:
    • /w/index.php für normale, interaktive Darstellungen im Browser
    • /w/load.php für „Ressourcen“; das sind Codes in CSS und JavaScript
    • /w/api.php für automatisierte Vorgänge mittels klassischer API.
  3. /api/rest_v1/ – neuere REST-API.
  4. /static/ – Dateien mit bestimmten Bildern usw.

Weiterhin gibt es einige Einzeldateien außerhalb dieser Pfade, etwa robots.txt oder Favicons für verschiedene Plattformen.

  • /w/extensions/ beispielsweise hält Ressourcen bestimmter Erweiterungen.

Für Sonderzwecke außerhalb unseres Wiki-Gebrauchs gibt es noch:

  • /w/autoload.php
  • /w/img_auth.php
  • /w/opensearch_desc.php – Schnittstelle für OpenSearch zur Browser-Konfiguration; ergibt XML-Struktur.
  • /w/profileinfo.php
  • /w/thumb.php
  • /w/thumb_handler.php

https

Auf dieser Hilfeseite wird den URL das Protokoll https:// (verschlüsselte Verbindung, Standard ab Herbst 2013) vorangestellt. Seit Sommer 2015 sind nur noch solche Verbindungen möglich; zuvor gab es die Möglichkeit, sich der Art der momentanen Verbindung anzupassen („protokoll-relativ“). Darauf ist nunmehr keine Rücksichtnahme mehr erforderlich; nach und nach können URL auf https:// umgestellt werden.

canonicalurl etc.

Mit der Parserfunktion canonicalurl lässt sich eine URL kürzer und gegen mögliche Konfigurationsänderungen gesichert schreiben:

{{canonicalurl:Seitenname|Parameter=Wert&Parameter2=Wert2}}

Möglichkeiten je nach Namensraum

Parameter für reguläre Seiten

Dieser Abschnitt befasst sich mit Parametern, die für reguläre Seiten (dazu zählen alle Artikel; genauer: keine Spezialseiten) verwendet werden können.

Parameter action

Der Parameter action übernimmt die grundlegende Steuerung, wie die Antwort des Servers aussehen soll.

Wird er nicht angegeben, so wird &action=view verwendet.

Parameter Bedeutung
&action=view
&action=
öffnet eine Seite im Lesemodus
&action=edit öffnet eine Seite im Quelltext-Bearbeitungsmodus, bei geschützten Seiten und fehlenden Bearbeitungsrechten wird der Quelltext angezeigt
&action=edit&preview=no unterdrückt die Funktion „Vorschau beim ersten Bearbeiten immer anzeigen“, sofern diese in der
– Einstellung
aktiviert ist
&action=edit&preview=yes wie &action=edit, zudem wird direkt die Vorschau der Seite angezeigt
&action=edit&wpPreview=true&live=true generiert (ohne oder mit irgendeiner Wertangabe) eine Vorschau-Ansicht für die LivePreview-Methoden im XML-Format. Eine Wirkung von wpPreview ist in einer GET-URL nicht erkennbar, mag aber im eigentlich vorgesehenen POST wirksam sein.
&action=edit&redlink=1 öffnet eine leere Seite anstatt eine Sperrmeldung zu zeigen, falls der Benutzer die Seite nicht bearbeiten darf
&action=edit&undo=id öffnet eine Seite im Quelltext-Bearbeitungsmodus und macht die letzte Bearbeitung rückgängig
&action=edit&undo=id1&undoafter=id2 öffnet eine Seite im Quelltext-Bearbeitungsmodus und macht alle Bearbeitungen zwischen id2 und id1 rückgängig
&action=edit&section=n öffnet einen bestimmten Abschnitt einer Seite im Quelltext-Bearbeitungsmodus, ebenso für Benutzer- bzw. Benutzerdiskussionsseiten möglich
&action=edit&section=new öffnet einen neuen Abschnitt am Ende einer Seite im Quelltext-Bearbeitungsmodus
action=edit&section=new&preloadtitle=Überschrift übergibt beim Erstellen eines neuen (Diskussions-)Beitrages die Überschrift des neuen Abschnittes
action=edit&preload=Seitenname Seite bearbeiten, Inhalt vorbelegen mit Inhalt von Seitenname
action=edit&preload=Seitenname&preloadparams[]=Parameterwert1 Seite bearbeiten, Inhalt vorbelegen mit Seitenname und dort Parameter vom Typ $1 usw. ersetzen
action=edit&summary=Bearbeitungskommentar Seite bearbeiten, Bearbeitungskommentar vorbelegen, etc.
action=edit&lintid=Linter-DB-ID Wikisyntax-Validierung; beanstandeten Bereich markieren
action=dtunsubscribe Abonnierten Abschnitt abbestellen
action=cirrusdump Durchsuchbarer Inhalt für eine Seite.
&action=parsermigration-edit Quelltext-Bearbeitung mit aktiviertem Migrationswerkzeug (2017/18)
&action=submit speichert eine im Quelltext-Bearbeitungsmodus befindliche Seite, zeigt eine Vorschau oder die Textänderungen
&action=history öffnet die Versionsgeschichte einer Seite (&limit=n und &offset=m können die Anzeige auf n Versionen, beginnend bei der Versionsnummer m eingrenzen); &feed lenkt die Änderungen in einen Newsfeed um, dabei sind =atom und =rss gültige Werte für Atom- bzw. RSS-Feeds; mit dem veralteten Parameter &go=first kann die erste Version eines Artikels aufgerufen werden
&action=historysubmit wurde bis MW 1.18 verwendet, wenn aus der Versionsgeschichte einer Seite heraus der Versionsunterschied angezeigt werden sollte. Inzwischen werden URL mit &diff=n generiert. Vorhandene URL mit &action=historysubmit bleiben funktionstüchtig.
&action=watch setzt einen Artikel auf die Beobachtungsliste
&action=unwatch entfernt einen Artikel von der Beobachtungsliste
&action=purge löscht einen Artikel aus dem Cache der Server.
  • Weitergehende Möglichkeiten mit der API
&action=info öffnet eine Informationsseite mit verschiedenen Detailinformationen
&action=rollback&from=Benutzername&token=id setzt die letzten Bearbeitungen desselben Benutzers in einem Artikel zurück (nur von Sichtern, globalen Zurücksetzern und Administratoren durchführbar), optional kann die Zusammenfassung per summary übergeben werden, zudem können globale Zurücksetzer und Administratoren die Bearbeitung optional als Bot-Bearbeitung per bot markieren
&action=revert setzt ein Bild auf eine ältere Version zurück, wobei die beiden Parameter oldimage (Version, auf die zurückgesetzt werden soll) und ein gültiger wpEditToken (siehe Manual:Edit token) benötigt werden
&action=protect ändert den Seitenschutz einer Seite (nur von Administratoren durchführbar)
&action=unprotect hebt den Seitenschutz einer Seite auf (nur von Administratoren durchführbar)
&action=delete löscht eine Seite (nur von Administratoren durchführbar), mittels &wpReason=Löschgrund kann der Löschgrund übergeben werden (phab:T13079 (Bugzilla:11079))
&action=undelete stellt eine gelöschte Seite wieder her (nur von Administratoren durchführbar)
&action=markpatrolled&rcid=n markiert die Version n als überprüft (nur von Administratoren durchführbar)
&action=render öffnet eine HTML-Darstellung eines Artikels ohne Verwendung der üblichen Stylesheets, Buttons, Toolboxen u. Ä., beispielsweise bei der Hauptseite: //de.wikipedia.org/w/index.php?title=Hauptseite&action=render
&action=raw zeigt keine HTML-Darstellung, sondern ruft den unverarbeiteten Quelltext der Seite ab; Näheres siehe unten
&action=deletetrackback diese Funktionalität ist standardmäßig in der DefaultSettings.php deaktiviert
&action=print bewirkt das Gleiche wie &action=view
&action=dublincore ist für RDF-Metadaten zuständig, standardmäßig deaktiviert, über $wgEnableDublinCoreRdf zu aktivieren
&action=creativecommons ist für Creative Commons RDF-Metadaten zuständig, standardmäßig deaktiviert, über $wgEnableCreativeCommonsRdf zu aktivieren
&action=credits Zeigt Seiteninformationen an. Dazu gehört die letzte Bearbeitung, sowie alle Autoren. Falls ein Klarname angegeben wird, wird dieser angezeigt. Ist standardmäßig deaktiviert.
&action=validate aktuelle Funktionalität unbekannt
&action=show-download-screen Zeigte bis 2020 in der Druckversion einen bestimmten Modus zum Herunterladen der HTML-Seite an.

Siehe auch: mw:Manual:Parameters to index.php #Actions (englisch)

Alle Namensräume und Seiten

Alle für Artikel in Frage kommenden Parameter können auch auf Bilder sowie die Seiten anderer Namensräume angewendet werden.

Parameter Bedeutung
&oldid=n ruft eine bestimmte Versionsnummer n eines Artikels auf, die Nummerierung erfolgt über die Parserfunktion {{REVISIONID}}
&curid=n Ruft die Seite mit der entsprechenden Seitenkennnummer auf, die aufsteigend nach dem Zeitpunkt der Artikelanlage vergeben wird. Die Hauptseite hat beispielsweise die ID=5248757, kann also über {{canonicalurl:x|curid=5248757}} aufgerufen werden.
&redirect=no Bewirkt auf Weiterleitungsseiten, dass die Weiterleitungsseite aufgerufen, jedoch keine Weiterleitung durchgeführt wird; ansonsten ignoriert.
&namespace=nsn Grenzt anhand der Nummer die Ausgabe der Einträge in Listen auf einen bestimmten der nachfolgenden Namensräume ein: Artikel (0), Artikeldiskussion (1), Benutzerseiten (2), usw.
&rdfrom wird eine Seite durch eine Weiterleitung aus einem externen Wiki aufgerufen, so enthält der Parameter den Namen des aufrufenden Wikis
&bot=0 ermöglicht Bots gezielt pro Bearbeitung das Botflag auszuschalten (phab:T14574 (Bugzilla:12574))
&veaction benutzt den VisualEditor, falls der Wert =edit übergeben wird
&vesection=n Nummer eines Abschnitts bei veaction=edit
&mode=file erlaubte bis April 2013 die Benutzung eines externen Editor für die Dateibearbeitung
&internaledit überging bis April 2013 die eigenen
– Einstellungen
für diese eine Bearbeitung und benutzt den internen Editor der MediaWiki
&externaledit überging bis April 2013 die eigenen
– Einstellungen
für diese eine Bearbeitung und benutzt statt des internen Editors der MediaWiki einen externen Editor

Kategorien

Folgende Parameter können nur auf Kategorieseiten angewandt werden.

Parameter Bedeutung
&from=sortkey Es werden nur solche Seiten der ausgewählten Kategorie abgerufen, deren sortkey identisch oder alphanumerisch größer als der übergebene Wert ist.
&until=sortkey Es werden nur solche Seiten der ausgewählten Kategorie abgerufen, deren sortkey alphanumerisch kleiner als der übergebene Wert ist, der Parameter from darf nicht angegeben werden.
&pagefrom=seitenname Es werden die Seiten ab diesem Seitennamen aufgelistet; verwendet zum Blättern durch Folgeseiten.
&pageuntil=seitenname Es werden die Seiten bis zu diesem Seitennamen aufgelistet; verwendet zum Blättern durch Folgeseiten.

Außerdem gibt es gallerymode für Dateikategorien.

Bilder

Nachfolgender Parameter funktioniert ausschließlich für Dateibeschreibungsseiten und die Medien selbst.

Parameter Bedeutung
&page=vsn gibt die gewünschte Versionsnummer eines versionierten Mediums an, die erste Version trägt die Ordnungszahl 1

Versionsvergleich

Die folgenden Parameter sind ausschließlich beim Versionsvergleich sinnvoll.

Parameter Bedeutung
&diff=vsn Bewirkt einen Versionsvergleich dieser Seite. vsn kann dabei die in der rechten Spalte dargestellte (neuere) Version sein (O oder cur stehen dabei für die aktuelle Version) – oder die ältere (linke Spalte).
Ohne weitere Angaben wird mit der vorangegangen Version verglichen (&direction=prev). Ansonsten kann die Vergleichsversion in anderen Parametern spezifiziert werden (&direction=next, &oldid=n für eine ältere).
&diffonly=1 Versionsvergleich: Nur die Unterschiede und nicht die vollständige Seite anzeigen (kann standardmäßig über die Einstellung aktiviert werden).
&direction=next ermöglicht das „Blättern“ in der Versionsgeschichte zur nachfolgenden Version, ausgehend von der aktuell aufgerufenen diff=oldid.
&direction=prev Ermöglicht das „Blättern“ in der Versionsgeschichte zur vorausgehenden Version, ausgehend von der aktuell aufgerufenen diff=oldid.
&diffmode=source Klassischer Versionsvergleich der Quelltexte zweier Seitenversionen (Vorgabe).
&diffmode=visual Visueller Versionsvergleich der resultierenden Textdarstellung (seit etwa 2017); ggf. kombiniert mit &type=revision – zuvor auch: &visualdiff

Eingabefelder und Vorlagen

Parameter Bedeutung
&templates=expand expandiert eingebundene Vorlagen in HTML-Code
&preload=Vorlage öffnet eine Seite im Bearbeitungsmodus und kopiert dabei den Wikitext der Vorlage in das Fenster, siehe auch mw:Manual:Creating pages with preloaded text
&editintro=Vorlage der Seiteninhalt der Vorlage wird als Erläuterung vor dem Bearbeitungsfenster dargestellt
&title=Seitenname öffnet die angegebene Seite zur Bearbeitung
&create=Bezeichnung gibt die Bezeichnung des Buttons des Eingabefelds wieder

Siehe: Hilfe:Eingabefelder

PDF-Erstellung (Buchfunktion)

Parameter Bedeutung
&bookcmd=rendering
  • rendering
  • download
&collection_id= Gespeicherte Dateiversion
&papersize=
  • A4
  • letter
  • Angaben in cm oder in oder px
Blattgröße
&writer=rdf2latex
&writer=rl
Ausgabeformat
  • rl oder rdf2latex → PDF (Standard; zurzeit einziges Format)

Siehe: Hilfe:Buchfunktion

Verschiedene

Parameter Bedeutung
&fromrc=1 Von „Letzte Änderungen“ kommend.
&liveupdate=1 In „Letzte Änderungen“ einen experimentellen dynamischen Seitenaktualisierungsmodus einschalten.
&fromsection=n Abschnitt, der bearbeitet wurde
&shownotice=1 Hinweis anzeigen, dass die Änderung noch nicht gesichtet ist.
&stable=0 Nicht die gesichtete Version anzeigen.
&dtenable=0 Diskussionsseiten-Hilfsmittel nicht aktivieren.
&withgadget=gadget-ID Hierfür konfiguriertes Gadget starten.
&tour=Tour-Name Name einer „Guided Tour“ und diese starten.
&wpReason={{urlencode:Freigabe}} Löschgrund

action=raw

Die allgemeine Struktur der Aufrufe, die zur Anzeige des Seitenquelltextes im raw-Modus führen, lautet:
//de.wikipedia.org/w/index.php?title=Seitenname&action=raw&Parameter=Wert

Parameter Bedeutung
&templates führt zur Expandierung der in der aufgerufenen Seite eingebundenen Vorlagen, falls der Wert =expand übergeben wird
&ctype definiert den im HTTP-Header enthaltenen Content-Type, wobei =text/css, =text/javascript und =application/x-zope-edit gültige Werte sind und =text/x-wiki der Defaultwert ist
&gen generiert ein CSS stylesheet oder JavaScript, abhängig vom übergebenen Wert =css bzw. =js (ansonsten wird dies von den „Dateinamenserweiterungen“ der Seite .css und .js automatisch abgeleitet)
&bcache=1 („Browser-Cache“) – ermöglichte seit Mitte 2013 auf Varnish-Servern, die Steuerung auch wirklich zu nutzen.
Mit rOPUPce1f2b6 wurden alle Anweisungen zur Cache-Steuerung überschrieben (phab:T71460 (Bugzilla:69460)). Benutzer können jedoch ihre Browser anweisen, dies und ggf. &maxage= zum Cache-Management nach eigenen Vorstellungen auszuwerten.
&maxage=n gibt die Ablaufzeit in Sekunden an, wie lange die Seite ungeprüft im Browser-Cache verweilen darf (HTTP-Header Cache-Control:max-age=)
Zurzeit muss auch bcache angegeben werden, damit die Option wirksam wird.
&smaxage=n wie &maxage – jedoch für Proxy-Server<section begin="smaxage" />
  • Mit der 2013 begonnenen durchgängigen Verwendung von HTTPS wurde dieser Parameter obsolet.
  • Ursprünglich generierte er eine Antwort des Servers, mit der sich die Speicherung der Ressource gleicher URL auf Zwischenknoten im Internet zwecks Direktantwort steuern lässt.
  • Nur unter http: ist aber für die Zwischenknoten die URL sichtbar.
  • Obendrein beginnt der Parameter Ende 2013, die Wiki-Server von der Auslieferung aktualisierter Seitenversionen abzuhalten.

<section end="smaxage" />

&usemsgcache wirkt sich nur auf Seiten des MediaWiki-Namensraums aus; falls dieser Parameter gesetzt wird, so wird der Systemtext aus dem Cache anstatt aus der Datenbank gelesen
&oldid=rvID gibt die Nummer der auszugebenden Revision (Version) an
&direction gibt die auszugebende Revision über die Reihenfolge der Versionen in der Versionsgeschichte an, wobei entweder die nächste (=next), die vorherige (prev) oder die aktuelle (cur) Revision ausgegeben werden kann
&section=n gibt an, welcher Abschnitt einer Seite ausgegeben werden soll, wobei n nur positive, ganzzahlige Werte akzeptiert, 0 bezeichnet den Abschnitt vor der ersten Überschrift (phab:T13353 (Bugzilla:11353))

Aus naheliegenden Gründen wird einer Weiterleitung nie gefolgt.

Die Spezialseite Special:PageData/main/Seitenname entspricht action=raw, lässt jedoch zurzeit keine weiteren Parameter zu.

Spezialseiten

Siehe: Hilfe:Spezialseiten/Parameter #URL-Format

Situationsunabhängig

Die folgenden Parameter lassen sich in vielen Situationen zusätzlich anwenden.

Parameter Bedeutung
&uselang=de das Benutzerinterface der Seite wird in der Sprache des angegebenen Sprachcodes angezeigt, beispielsweise die Statistik der chinesischen Wikipedia (nicht mit render oder raw)
&setlang=de Die Sprache der Benutzeroberfläche wird auf die Sprache des angegebenen Sprachcodes umgestellt. Eine Sicherheitsabfrage wird eingeblendet, um die Umstellung zu bestätigen.
&useformat=mobile öffnet die Seite in der Aufbereitung für Mobilgeräte (kann nicht alle Aspekte eines Mobilgeräts simulieren). Zunächst auch als: &useformat=mobile-wap
&useformat=desktop öffnet die Seite im Desktop-Modus
&useskin=Skin öffnet die angegebenen Seite unter Nutzung der vorgegebenen Skin, beispielsweise die Hauptseite mit Modern-Skin (nicht mit render oder raw)
&useskin=default öffnet die angegebenen Seite unter Nutzung der Standardskin.
&variant= spezifiziert eine Sprachvariante (wird beispielsweise in der chinesischsprachigen Wikipedia genutzt, die mehrere Sprachvarianten unterstützt) für die GUI (nicht mit render oder raw)
&limit=Anzahl Anzahl von aufzulistenden Einträgen. Manuell bei länger angemeldeten Benutzern bis 1000, teilweise bis 5000 möglich.
&offset=Nummer Aufzulistende Einträge bei einer bestimmten Stelle beginnen.
&printable=yes stellt eine Seite für den Ausdruck aufbereitet dar (nicht mit render oder raw)
&ajax ruft eine Ajax-Funktion für Erweiterungen auf, falls $wgUseAjax gesetzt ist
&debug=true Normalerweise wird das Seiten- und Benutzer-CSS/JS sehr stark um Kommentare, Leerzeichen, Tabs und Zeilensprüngen reduziert – und damit für Menschen schwer lesbar – im Quelltext ausgeliefert. Mit &debug=true unterbleibt diese Reduzierung und der Quellcode wird dadurch lesbarer.
&safemode=1 verhindert das Einbinden zusätzlicher Skripte und Stylesheets, die über die globalen Standardeinstellungen hinausgehen.
&mobileaction=toggle_view_mobile

&mobileaction=toggle_view_desktop

schaltete die momentane Darstellung in oder von der Mobilgeräte-Ansicht um; jetzt: &useformat=
&useAgora=1 Das mittlerweile nicht mehr betriebene Agora-Projekt sollte aktiviert werden.

Externe Software

Es können beliebig viele URL-Parameter angehängt werden, und jede Fremdsoftware außerhalb von MediaWiki kann eigene Parameter definieren, anfügen und ihnen eine Bedeutung geben.

  • Einige Wikis haben URL-Parameter eingeführt, die nur dort für deren Gadgets gelten.
  • Benutzerskripte können URL-Parameter anfügen und auswerten.
Einige bekannte Parameter
Parameter Bedeutung
dontcountme=s Früheres Aufruf-Analysepaket „Webalizer“; heute sinnfrei.
oldformat=true Externe Wikipedia-Benutzeroberfläche Wikiwand für interne Zwecke; für uns bedeutungslos.