Benutzer:PerfektesChaos/js/filesMetaData

JavaScript-Benutzerskript – zeige textliche Informationen über Mediendateien bzw. ihre Beschreibungsseiten.

Insbesondere soll vermieden werden, Hunderte von Miniaturbildern herunterzuladen und anzuzeigen, wie es bei den regulären Darstellungen durch MediaWiki erfolgt, und die Details sollen als sortierbare Tabelle aufgegliedert dargestellt werden – was mit den Galerie-Darstellungen nicht möglich ist.

Einbindung

Wenn das Projekt dieses Gadget bereits registriert haben sollte, genügt ein Häkchen auf der Seite Einstellungen („Helferlein“).
Sonst wären die folgenden Zeilen in die persönlichen JS-Einstellungen einzufügen:

if ( mw.config.get( "wgCanonicalSpecialPageName" ) === "Blankpage"  &&
     mw.config.get( "wgTitle" ).indexOf( "/filesMetaData" ) > 0 ) {
   mw.loader.load( "https://en.wikipedia.org/w/index.php?title=User:PerfektesChaos/js/filesMetaData/r.js&action=raw&bcache=1&maxage=86400&ctype=text/javascript" );
}

Verhalten

Nach der Installation

besuche Spezial:Leere Seite/filesMetaData,
woraufhin bald eine kurze Antwort sichtbar werden sollte,
warte ein Weilchen; die Ressourcen brauchen mehrere Sekunden, um OOjs bereitzustellen (wie beim Start des VisualEditor),
wähle aus dem Formular aus, was du gezeigt bekommen möchtest,
benutze schließlich den Button Ausführen zur Analyse.

Bleibe auf dieser Seite, um die gesammelten Ressourcen und Mediendaten weiternutzen zu können. Alle Verlinkungen werden in frischen Browser-Tabs aufgebaut.

Datenherkunft

Es gibt drei Grundtypen, um bestimmte Dateien zu liefern.

Kategorie

Wähle den Kategorie-Modus aus und spezifiziere den Titel der Kategorie im Eingabefeld.

Beachte, dass nicht notwendigerweise eine Kategoriebeschreibungsseite existieren muss, damit die Kategorisierung funktioniert.

Später kannst du auch auf Unterkategorien navigieren oder zu Oberkategorien, was automatisch das Eingabefeld befüllen wird.

Die Mediendateien in der jeweiligen Kategorie werden dann aufgelistet.

Spezialseiten

Einige Spezialseiten listen Datei-Galerien. Wenn eine API-Schnittstelle dafür definiert ist, kann ihr Inhalt analysiert werden.

Verfügbar: Meistverwendete Dateien; Nicht kategorisierte Dateien; Verwaiste Dateien
Zurzeit keine API: Dateiliste; Neue Dateien

Siehe mw:API:Querypage zum aktuellen Stand.

Freie Liste und Wikitext

Wenn du diesen Modus auswählst, bekommst du ein großes Feld zur Texteingabe.

Grundsätzlich wird eine Liste von Medienbezeichnern erwartet, jeder auf einer eigenen Zeile.

Eine durch Pipes getrennte Liste von Medienbezeichnern ist auch in Ordnung.

Medieneinbindungen oder verlinkte Dateien in doppelten eckigen Klammern werden überall erkannt.

Es sollte eigentlich funktionieren, den Inhalt einer Galerieseite aus dem Commons-Hauptnamensraum in dieses Feld zu kopieren, und die auftretenden Medien werden aufgelistet.

Verlasse das Eingabefeld, um die Eingabe zu beenden.

Verfeinerung

Die gewünschte Ausgabe kann angepasst werden.

Spalten

Wähle die Arten der Information, für die du dich interessierst. Jede wird in einer eigenen Tabellenspalte dargestellt, sofern verfügbar. Wenn es sinnvoll ist, kannst du später nach dieser Spalte auch sortieren.

Miniaturbilder und der Inhalt von Dateibeschreibungsseiten werden nicht sofort abgerufen, aber wenn du dich für eine einzelne Datei interessierst, kannst du dies individuell anfordern.

Informationen über Dateibeschreibungsseiten sind nur im lokalen Projekt zugänglich; wenn du in einer Wikipedia arbeitest, sind die Dateibeschreibungen auf Commons nicht vorhanden, wohl aber die Eigenschaften existierender und geteilter Medien.

Filtern

Die Medienbezeichner (vor dem Punkt) können durch eine beliebige Zeichenkette eingeschränkt werden, die darin enthalten sein muss.

Ein regulärer Ausdruck kann dafür ebenfalls verwendet werden, im üblichen RegExp-Dialekt von JavaScript. Das Muster ist in / einzuschließen und ein i für ignorierte Groß- und Kleinschreibung kann angehängt werden.

Beispiel: /[hm]aus/i erlaubt haus, Haus, maus an beliebiger Stelle, aber unterdrückt alle Dateien, in denen das nicht vorkommt.

Die „Dateinamenserweiterungen“ können gleichfalls genutzt werden, um die Auflistung zu begrenzen. Eine durch Leerzeichen getrennte Liste ist anzugeben.

Die folgenden Gruppen werden ähnlich wie MIME-Spezifikationen unterstützt:

`pixel/*`	Pixel-Grafiken
`vector/*`	Vectorgrafiken
`image/*`	`pixel/` + `vector/`
`audio/*`	Audio-Dateien
`video/*`	Videos
`paged/*`	Seitenweise Medien (Text-Dokumente)

Beide Bedingungen können invertiert werden.

Optionen

Vier Zahlenwerte können angepasst werden.

Sie wirken sich sofort und auch auf laufende Abfragen aus.

Mindestzahl der Tabellenzeilen.
- Wenn eine hinreichende Anzahl von Einträgen verfügbar ist, wird die Tabelle um diese Zahl der Zellen erweitert.
- Wenn Filterbedingungen gesetzt sind, könnten einige zusätzliche Zeilen angehängt werden, falls bereits ein begonnener Block vorliegt. Es werden Blöcke abgerufen, bis die gewünschte Mindestzahl erreicht wurde, aber ein angefangener Block wird dann vollständig umgesetzt.
Blockgröße der API-Abfragen, für erfahrene Benutzer.
Größe der Miniaturbilder.
Begrenzung der anfänglich angezeigten Größe des Wikitextes von Dateibeschreibungsseiten.

Fortsetzung

So lange weitere Einträge erwartet werden können, erlaubt ein Button die Erweiterung der Tabelle um einen Block weiterer Zeilen.

Andernfalls kann das Anforderungsformular wieder geöffnet werden und ein neuer Lauf kann spezifiziert und gestartet werden.

Einmal abgerufene Daten werden in einem Cache gesammelt. Aufeinander folgende Anfragen nach denselben Dateien werden versuchen, bereits bekannte Informationen wiederzuverwenden. Wenn durch die Aktivitäten die Dateien verändert wurden, können diese Eigenschaften veralten. Für diesen Fall wird ein Button angeboten, um den Cache zurükzusetzen.

Codes

Zu technischen Einzelheiten siehe englischsprachige Dokumentationsseite.