Hilfe:URL-Parameter

aus Wikipedia, der freien Enzyklopädie
(Weitergeleitet von Hilfe:URL-P)
Zur Navigation springen Zur Suche springen

Ü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.

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, also etwa yes und no.

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

Die allgemeine Struktur bei Verwendung von URL-Parametern lautet:

https://de.wikipedia.org/w/index.php?title=Seitenname&action=Aktionsname

(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.
    • /w/rest.php stellt einige REST-API-Funktionen bereit
  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

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 alle URL auf https:// umgestellt werden.

canonicalurl etc.

[Bearbeiten | Quelltext bearbeiten]

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}}

Parameter-Index

[Bearbeiten | Quelltext bearbeiten]

Zu /w/index.php? sind eine Vielzahl von Parametern definiert: action ajax bcache bot collection_id create ctype curid debug diff diffmode diffonly direction dontcountme dtenable dtnewcommentssince editintro externaledit feed from fromrc fromsection gen internaledit limit lintid liveupdate markasread markasreadwiki maxage minervanightmode mode namespace offset oldformat oldid page pagefrom pageuntil papersize preload preloadparams[] preview printable rdfrom redirect redlink safemode section setlang shownotice smaxage sortcat stable summary templates title tour undo undoafter until useformat uselang usemsgcache useskin variant veaction vectornightmode vesection visualdiff withgadget wpReason writer

Seite identifizieren

[Bearbeiten | Quelltext bearbeiten]

Siehe grundlegend: Seitenname.

Parameter Bedeutung
&title=Seitenname öffnet den angegebenen Seitennamen
&oldid=n ruft eine bestimmte Versionsnummer n eines Artikels auf, die Nummerierung erfolgt über die Parserfunktion {{REVISIONID}} Nur reguläre Seiten (keine Spezialseiten)
&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 bei Weiterleitungsseiten, dass die Weiterleitungsseite aufgerufen, jedoch keine Weiterleitung durchgeführt wird; ansonsten ignoriert.

Möglichkeiten je nach Namensraum

[Bearbeiten | Quelltext bearbeiten]

Parameter für reguläre Seiten

[Bearbeiten | Quelltext bearbeiten]

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

[Bearbeiten | Quelltext bearbeiten]

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; mit konfiguriertem VisualEditor wird möglicherweise auch dieser gestartet
&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. Wird weiterhin bei Versionslöschungen verwendet.
&action=info öffnet eine Informationsseite mit verschiedenen Detailinformationen
&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=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=dtunsubscribe Abonnierten Abschnitt abbestellen
&action=deletetrackback diese Funktionalität ist standardmäßig in der DefaultSettings.php deaktiviert
&action=print bewirkt das Gleiche wie &action=view
action=cirrusdump Durchsuchbarer Inhalt für eine Seite.
&action=parsermigration-edit Quelltext-Bearbeitung mit aktiviertem Migrationswerkzeug (2017/2018)
&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.
&action=ajax Vorgänger der heutigen API; wurde entfernt

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

Seitenbearbeitung

[Bearbeiten | Quelltext bearbeiten]

Reguläre Seiten (keine Spezialseiten) können bearbeitet, also ihr Inhalt verändert werden. Dabei sind die nachstehenden Parameter relevant; meist nur bei &action=edit wirksam.

Parameter Bedeutung
&section=n öffnet einen bestimmten Abschnitt einer Seite im Bearbeitungsmodus
&section=new öffnet einen neuen Abschnitt am Ende einer Seite zur Bearbeitung
&preview=no unterdrückt die Funktion „Vorschau anzeigen, wenn mit der Bearbeitung begonnen wird“, sofern diese in der
– Einstellung
aktiviert ist
&preview=yes es wird direkt die Vorschau der Seite angezeigt
&undo=id öffnet eine Seite und macht die (letzte) Bearbeitung rückgängig
&undo=id1&undoafter=id2 öffnet eine Seite zur Bearbeitung und macht alle Bearbeitungen zwischen id2 und id1 rückgängig
&lintid=Linter-DB-ID Wikisyntax-Validierung; beanstandeten Bereich markieren
&summary=Bearbeitungskommentar Bearbeitungskommentar vorbelegen (gilt auch für einige Logbuch-Aktionen)
&preload=Seitenname kopiert dabei den Wikitext-Inhalt von Seitenname in den Bearbeitungsbereich; siehe Hilfe:Preload
&preloadparams[]=Parameterwert1 adaptiert den Wikitext aus preload, indem Platzhalter $1 und $2 usw. ersetzt werden (kann ausnahmsweise mehrfach angegeben werden)
&section=new&preloadtitle=Überschrift übergibt beim Erstellen eines neuen (Diskussions-)Beitrages die Überschrift des neuen Abschnittes
&editintro=Vorlage der Seiteninhalt der Vorlage wird als Erläuterung vor dem Bearbeitungsbereich dargestellt
&bot=0 ermöglicht Bots gezielt pro Bearbeitung das Botflag auszuschalten (phab:T14574 (Bugzilla:12574))
&veaction=edit aktiviert den VisualEditor
&veaction=editsource öffnet den VisualEditor zur Quelltextbearbeitung
&vesection=n Nummer eines Abschnitts bei veaction=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.
&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

Alle Namensräume und Seiten

[Bearbeiten | Quelltext bearbeiten]

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

Parameter Bedeutung
&sortcat=1 Darstellung der Kategorien einer Seite in alphabetischer Reihenfolge (seit September 2024)
&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

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.

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

[Bearbeiten | Quelltext bearbeiten]

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

PDF-Erstellung (Buchfunktion)

[Bearbeiten | Quelltext bearbeiten]
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

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.
&vectornightmode=1 Anzeige im Dark Mode (Skin Vector-2022).
&minervanightmode=1 Anzeige im Dark Mode (Skin MinervaNeue).
&withgadget=gadget-ID Hierfür konfiguriertes Gadget starten.
&tour=Tour-Name Name einer „Guided Tour“ und diese starten.
&wpReason=Freigabe Löschgrund
&dtnewcommentssince=Datum DiscussionTools
&markasread=1234567890 DiscussionTools
&markasreadwiki=dewiki DiscussionTools
&ajax ruft eine Ajax-Funktion für Erweiterungen auf, falls $wgUseAjax gesetzt ist
&feed Feed-Modus, für Beobachtungsliste usw.
&useAgora=1 aktivierte Agora-Skin-Projekt

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
  • 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.
&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.

Siehe: Hilfe:Spezialseiten/Parameter #URL-Format

Situationsunabhängig

[Bearbeiten | Quelltext bearbeiten]

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

Parameter Bedeutung
&uselang=de das Benutzerinterface dieser Seite wird in der Sprache des angegebenen Sprachcodes angezeigt, beispielsweise die Statistik der chinesischen Wikipedia (nicht mit render oder raw)
&setlang=de Sprache der Benutzeroberfläche permanent auf die Sprache des angegebenen Sprachcodes umstellen; 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)
&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=

Externe Software

[Bearbeiten | Quelltext bearbeiten]

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.