Commons:Kurzbeschreibungen

Kurzbeschreibungen

Kurzbeschreibungen sind Teil der strukturierten Daten. Sie sollen eine eine kurze, mehrsprachige Beschreibung über Dateien enthalten. Siehe Help:File captions für weitere Informationen. Die Funktion wurde im Januar 2019 auf Wikimedia Commons aktiviert.

Was macht eine gute Kurzbeschreibung aus?

Genaue Richtlinien für Kurzbeschreibungen werden noch entwickelt.

Es gibt technische Beschränkungen (Limitierung auf 255 Zeichen, kein Wikitextmarkup), die die Kurzbeschreibungen notwendigerweise kurz machen.

FAQ

Was ist der Unterschied zu Beschreibungen?

• Kurzbeschreibungen sollen einfach und kurz sein. Während Beschreibungen sehr lang sein können, sind Kurzbeschreibungen auf 255 Zeichen Länge limitiert und können kein Markup (Wikitext oder HTML) enthalten und unterstützen keine externen Links.
• Kurzbeschreibungen sind ein Teil der strukturierten Daten, während Beschreibungen dies nicht sind. Aus technischer Sicht sind Beschreibungen reiner Wikitext, der in eine Sprachvorlage gepackt ist, die in der Informationsvorlage liegt. Kurzbeschreibungen hingegen sind Wikibase Label, als solche sind sie über die API durchsuchbar, was es einfach macht, sie als Metadaten zu finden, zu filtern oder zu verändern.

In vielen Fällen werden die Kurzbeschreibungen genauso sein wie die Beschreibung oder sogar wie der Dateiname. Als Beispiel, File:Fire station Hallstatt - October 2017 - 02.jpg hat die englische Kurzbeschreibung „Hallstatt fire station in October 2017“.

Im Gegensatz dazu hat Pluto-01 Stern 03 Pluto Color TXT.jpg eine sehr lange Dateibeschreibung (858 Zeichen und Links) und die Kurzbeschreibung ist deutlich kürzer (Mehr oder weniger die gleiche Kurzbeschreibung, wie sie in Wikipediaartikeln für dieses Bild genutzt wird)

Kann ich (oder ein Bot) die Beschreibungen nicht einfach kopieren?

Als erstes sind Kurzbeschreibungen kürzer als viele Beschreibungen, sie können keine Links oder Wikitext enthalten.

Es ist möglich kurze Textstücke aus der Beschreibung in die Kurzbeschreibung zu kopieren, dafür ist aber eine manuelle Interpretation des Inhaltes nötig.

Nur Text, der so kurz ist, dass er nicht urheberrechtlich geschützt ist, sollte in die Kurzbeschreibung kopiert werden, da die Kurzbeschreibung als CC0 (Gemeinfrei) freigegeben sind.

Was sind die Vorteile der Kurzbeschreibungen?

Einer der wichtigsten Vorteile ist du Möglichkeit einer sprachübergreifenden Suche. Die klassischen Dateibeschreibungen sind im Wikitext und nur mit der Volltextsuche durchsuchbar, welche notwendigerweise durch den kompletten Seiteninhalt durchsucht, auch die Kategorien und Lizenzvorlagen. Es ist ebenfalls nicht möglich nach einer bestimmten Sprache zu suchen. Da die Kurzbeschreibungen durch eine API durchsucht werden können, ist es einfacher für Drittanwender die Dateien und die Kurzbeschreibungen zu finden und zu nutzen.

Andere mögliche Nutzungen könnten sein:

• Das Füllen von Infoboxen
• Abfragen von Dateien mit fehlenden Kurzbeschreibungen in einer bestimmten Sprache
• Bilden von Listen zur Übersetzung von wichtigen Dateien, die eine Kurzbeschreibung in der entsprechenden Sprache für ein Projekt oder eine Kampagne benötigen
• …

Wo werden die Kurzbeschreibungen gespeichert?

Kurzbeschreibungen werden auf Wikimedia Commons gespeichert, als Teil der Wikibase (und darum nicht als Teil von Wikitext). Sie werden nicht auf Wikidata gespeichert. Obgleich Wikibase Grundlage von Wikidata ist, wurde es auch hier auf Wikimedia Commons installiert.

Wie kann ich nach einer Kurzbeschreibung suchen?

Nutzende können nach den Dateien bei deren MediaInfo Kurzbeschreibungen genauso suchen, wie nach allem anderen auch. Als Beispiel: Eine Person lädt eine Foto des Eiffelturms hoch und gibt “Tour Eiffel“ (French) und „Eiffel Tower“ (English) als mehrsprachige Kurzbeschreibungen an, das Bild kann nun durch andere bei der Suche nach „Eiffel Tower“ oder „Tour Eiffel“ gefunden werden.

Warum werden mir die Sprachen X, Y und Z angezeigt?

Für eingeloggte basieren die angezeigten Sprachen auf den Babel boxes auf deiner Benutzerseite.

Wie kann ich die Anzeige von Kurzbeschreibungen verändern?

Die könntest die folgenden Helferlein in deinen Einstellungen (unter „Benutzeroberfläche: Dateien und Kategorien“) einschalten:

• Um den Kurzbeschreibungsblock einzuklappen und einen Link hinzuzufügen, um ihn auszuklappen, wenn Du ihn brauchst; : Collapse Captions (Code des Hauptskripts, zusätzliche Style-Code)
• Um die Kurzbeschreibungen kompakter zu machen: Compact Captions (Code)
• Um die Kurzbeschreibungen komplett zu verstecken: Hide Captions (Code)

Collapse Captions und Compact Captions können gern kombiniert werden.

Siehe auch Abschnitt Styling weiter unten.

Technisches

Wie kann ich die Kurzbeschreibungen über die API abfragen?

Die API-Unterstützung ist im Moment noch begrenzt, wird aber bald verbessert werden.

Du kannst Aussagen über das Modul wbgetentities mit der Datenobjekt-ID abrufen. Für jede Datei gibt es eine Wikibase-Datenobjekt-ID MXXXX, wobei XXXX die page_id ist. So hat beispielsweise File:Pluto-01 Stern 03 Pluto Color TXT.jpg die Seiten-ID 41837276, so dass die Datenobjekt-ID M41837276 ist, und Du kannst wbgetentities&ids=M41837276 abfragen. Eine einfache Möglichkeit, die M-Id zu erhalten, ist die Verwendung der API action=query&prop=info&titles=File:Pluto-01_Stern_03_Pluto_Color_TXT.jpg (die Seiten-ID wird durch das Feld pageid bereitgestellt).

Wie kann ich die Kurzbeschreibungenmit Lua/Vorlagen abfragen

Von Lua aus kannst du über die Funktion _SDC_Description in Module:Information auf diese zugreifen, die über eine Vorlagenschnittstelle durch die Vorlage {{File caption}} verfügt.

Wie kann ich Kurzbeschreibungen beim Hochladen setzen?

Hinzufügen von Kurzbeschreibungen mit dem Hochladeassistenten

Du kannst Kurzbeschreibungen bereits beim Hochladen mit dem Hochlade-Assistenten ausfüllen. Du kannst die Felder der Bildunterschrift mit den URL-Parametern caption und captionlang vorausfüllen, wenn du den Hochlade-Assistenten über einen Link aufrufst, z.B. im Kontext einer Hochlade-Kampagne.

Für andere Hochlade-Methoden wird es in Zukunft Unterstützung geben - Du kannst die Arbeit an verschiedenen Bugtrackern verfolgen, für Pywikibot, für die Commons Android-App oder für Pattypan.

Wie kann ich die Kurzbeschreibungen über die API bearbeiten?

Du kannst das API-Modul wbsetlabel mit der Wikibase-Entitäts-ID MXXXX verwenden (siehe den Abschnitt über die Abfrage für weitere Einzelheiten).

Gestaltung

Das Formularfeld für Beschriftungen kann mit Cascading Style Sheets formatiert werden. Füge die Regeln in deiner common.css-Seite oder einem Browser-Addon wie Stylus Userstyles Manager oder xStyle hinzu. Im letzteren Fall solltest du die vorgesehene Einschränkung auf die Commons-Domain commons.wikimedia.org verwenden.

Kurzbeschreibungen im zugeklappten Modus anzeigen

Mit dem Gadget Kurzbeschreibungen einklappen siehst du im eingeklappten Modus standardmäßig nur ein leeres Kästchen außer der Zeichenfolge Ausklappen. Das Folgende macht die Kurzbeschreibungen in diesem Zustand sichtbar (d.h. ⧼wikibasemediainfo-entitytermsforlanlanguagelistview-caption⧽ in deiner Sprache):

.mw-collapsible-content { display: initial !important; }
.mw-slot-header,
.wbmi-entityview-captionsPanel.mw-collapsed .mw-collapsible-content *:not(.wbmi-entityview-captions-header)
	{ display: none; }
.wbmi-entityview-captionsPanel.mw-collapsed .wbmi-entityview-captions-header	{
	display: block;
	border-bottom: none;
	margin-bottom: 0;
	padding-top: 0;
	font-style: italic;
	font-weight: normal;
}
.ltr .mw-collapsible-content .wbmi-entityview-captions-header { text-align: right; }
.rtl .mw-collapsible-content .wbmi-entityview-captions-header { text-align: left; }
.rtl .mw-collapsible-toggle { float: left; }

Hinweise:

• Aufgrund der Methode, wie die Zeilennummern hier in der Präsentation eingefügt werden, siehst du in der Kopie der Regeln, dass jede zweite Zeile leer ist. Du kannst diese leeren Zeilen sicher löschen, wenn du möchtest. Es gibt tatsächlich auch eine Einrückung mit einem Tabulatorzeichen, die hier ebenfalls nicht gezeigt wird.
  Das gilt auch für die folgenden Regeln mit darunter liegenden Zeilennummern.
• Zeile 1: In Tests war der Teil !important notwendig. Dies führt zu einer Warnung hier in Commons im Code-Editor von common.css. Vielleicht könnte sie sogar weggelassen werden, wenn diese Datei verwendet wird (getestet nur mit Browser-Addon).
• Zeile 2: Dies entfernt die Kopfzeile (Structured data in deiner Sprache). Wenn du ihn stattdessen angezeigt haben möchtest, lösche diese Zeile einschließlich des Kommas.
• Zeilen 10-12 dienen zur Formatierung der sichtbaren Beschriftung. Wenn du die standardmäßige aufrechte, fettgedruckte Zeichenfolge haben möchten, lösche diese Zeilen.
• Zeile 13-14: Du benötigst wahrscheinlich in den meisten Fällen nur eine dieser beiden Regeln, obwohl es egal ist, ob du beide kopierst. Um zu entscheiden, welche du in der Regel benötigst, siehe dir ihren Anfang an:
  • .ltr: von links nach rechts geschriebene Schriftsysteme wie die lateinische Schrift (z.B. Englisch).
  • .rtl: von rechts nach links geschriebene Schriftsysteme wie die arabische Schrift.

Wenn du die Standardzeichenfolge am Anfang haben willst (links für ltr, rechts für rtl-Systeme), lösche diese Zeilen.

• Zeile 15 wird nur für rtl-Systeme benötigt. Es verschiebt den Umschalter für das Ein- und Ausklappen auf die linke Seite der Seite. Diese Regel wird auch für jeden Umschalter auf allen anderen Commons-Seiten aktiv sein.

Weiteres Styling nur für das Aussehen, füge dies unterhalb der Regeln von oben hinzu:

.wbmi-entityview-captionsPanel.mw-collapsed .wbmi-entityview-captions-header::after { content: " …"; }
.wbmi-entityview-captionsPanel:not(.mw-collapsed) .wbmi-entityview-captions-header {
	border-bottom: none;
	text-decoration: underline;
}

Hinweise:

• Zeile 1: Wenn die ellipsis innerhalb von content: " ..."; nicht im üblichen Stil deiner Sprache ist, dann ersetze es nach deinem Geschmack, aber lasse die Anführungszeichen nicht weg! Wenn sich der hinzugefügte Inhalt in deinem Schriftsystem auf der falschen Seite befindet, ersetze after durch before.
• Zeilen 2-5 sind für die Bildunterschrift im nicht eingeklappten Modus. Wenn du nicht möchtest, dass sie unterstrichen wird, lösche Zeile 4.

Kompakter zusammengeklappter Modus

… aber nicht so kompakt wie bei dem Gadget Compact Captions

Bei niedrigeren Auflösungen stört dies bei allen Dateien, bei denen der MediaViewer nicht vorhanden ist (i. d.h. alle Dateien, die nicht vom Dateityp image sind), die vorhergehenden Vorschau- und Größenangaben. Siehe erster Hinweis unten.

.mw-slot-header { display: none; }
.wbmi-entityview-captionsPanel:not(.mw-collapsed) .wbmi-entityview-captions-header
	{ border-bottom: none; }
.wbmi-entityview-captionsPanel {
	border: none;
	margin-top: -1.5em;
}
.wbmi-entityview-captionsPanel .wbmi-entityview-captions-header {
	margin-bottom: 0;
	padding-top: 0;
}
.wbmi-entityview-captionsPanel .wbmi-entityview-entitycontent {
	padding: 0.3em 0;
}

Hinweise:

• Wenn der Block den vorhergehenden Textblock stört, dann lösche Zeile 6 oder reduziere zumindest den Betrag des Wertes. margin-top: -0.5em; scheint verwendbar zu sein.
• Die Zeilen 1-3 können weggelassen werden, wenn du die unveränderten Regeln von oben verwendest, aber es schadet nicht, wenn du sie zweimal hinzufügst, solange du dir dies bei zukünftigen Bearbeitungen merkst.

Weiteres Styling nur fürs Aussehen:

.wbmi-entityview-captions-header .wbmi-entityview-editButton { font-size: smaller; }
.ltr .wbmi-entityview-editButton { margin-left: 0.25em !important; }
.rtl .wbmi-entityview-editButton { margin-right: 0.25em !important; }
.wbmi-entityview-editButton::before { content: "("; }
.wbmi-entityview-editButton::after { content: ")"; }

Hinweise:

• Zeilen 2-3: Lese die Anmerkungen oben für .ltr und .rtl.
• Zeilen 4-5: Wenn du keine Klammern um den Text (Edit in deiner Sprache) haben möchtest, lösche entweder beide Regeln oder ersetze sie durch deine bevorzugten Zeichen innerhalb von content: "...";, aber lass die Anführungszeichen nicht weg!