Hilfe:Medieneinbindung

aus Wikipedia, der freien Enzyklopädie
Wechseln zu: Navigation, Suche

Diese Hilfeseite beschreibt die vollständige Syntax zur Einbindung von Dateien in eine Seite und gibt weiterführende Hintergrundinformationen.

Zur praktischen Anwendung und Detailfragen bei einzelnen Medien siehe hingegen

Parameter[Bearbeiten | Quelltext bearbeiten]

Die Einbindung erfolgt mittels: [[Datei:Dateiname|Parameter|Parameter]]

  • Alle Parameter sind optional.
  • Die Kleinschreibung der Parameter ist zwingend. Damit lassen sie sich auch besser von einer zufällig gleichlautenden Bildlegende unterscheiden.
  • Der zuletzt angetroffene nicht erkannte Parameter wird als Bildlegende (caption) verwendet.

Einige Parameter bilden innere Gruppen, von denen nur eine Alternative möglich ist; etwa „links“ und „rechts“.

Generisch Alias Lokalisierung (=„deutsch“) alternativ Wert Bild Audio Video Dokument Info
alt   alternativtext   Beschreibender Text ×     × H:B
baseline   grundlinie   × × × × H:B/v
border   rand   ×     × H:B
bottom   unten   × × × × H:B/v
center centre zentriert   × × × × H:B
class       Selektor × × × ×
disablecontrols       Schaltelemente[1] × × H:A,H:V
framed frame enframed gerahmt   ×     × H:B
frameless   rahmenlos   ×     × H:B
lang     Sprachcode[2] × H:B
left   links   × × × × H:B
link   verweis   Seite/URL ×     × H:B
lossy       1, true, lossy, 0, false, lossless × s. u.
manualthumb[3]       Seite/URL × × × ×
middle   mitte   × × × × H:B/v
noicon[4]       × × H:A,H:V
none   ohne   × × × × H:B
noplayer[4]       × × H:A,H:V
page   seite   Zahl × s. u.
px       Abmessungen × × × × H:B
right   rechts   × × × × H:B
sub   tief tiefgestellt[5] × × × × H:B/v
super sup hoch hochgestellt[5] × × × × H:B/v
text-bottom   text-unten   × × × × H:B/v
text-top   text-oben   × × × × H:B/v
thumbnail thumb mini miniatur optional: Seite/URL[6] × × × × H:B
thumbtime       Zeitpunkt × H:V
top   oben   × × × × H:B/v
upright   hochkant   optional: Zahl ×     × H:B
  Legendentext × × × × H:B

Bedeutung der Symbole in der Tabelle:

  • ×     Parameter wirkt auf diese Medienart
  • –     Parameter für diese Medienart nicht sinnvoll
  • keine Angabe – Parameter für diese Medienart zurzeit wirkungslos; vielleicht zukünftig

Unerwünschte/veraltete Parameternamen in Normalschrift.

Parameter für Bilder können meist auch bei Audio und Video verwendet werden, da es um die Platzierung des Player-Symbols geht.

Aus den folgenden Gruppen ist jeweils nur ein Wert sinnvoll möglich:

  • links, rechts, zentriert, ohne
  • gerahmt, rahmenlos
  • mini ./. gerahmt, rand, rahmenlos
  • grundlinie, hoch, mitte, oben, text-oben, text-unten, tief, unten

Dokument[Bearbeiten | Quelltext bearbeiten]

Einzelseite (DjVu)

Bei den Dokumenteinbindungen geht es um paged media;[7] also um Dateien, die in Seiten eingeteilt sind und bei denen auf eine einzelne Seite zugegriffen werden kann. Das ist vorteilhaft, wenn Benutzer nur ein Blatt aus einem 700-seitigen Werk sehen möchten. Hierzu dient der Parameter page bei einigen Formaten, also etwa |page=123| usw. Zurzeit sind unter MediaWiki verfügbar:

Format Unterstützung für page
.djvu ×
.doc
.odt
.pdf × (mw:Extension:PdfHandler)
.tiff, .tif ×

Der Parameter lossy ist vorgesehen, um ein Zwischenbild mit reduzierter Auflösung generieren zu können. Siehe mw:Extension:PagedTiffHandler.

Im Übrigen wirken die Einbindungen bei mehrseitigen Dokumente wie solche auf ein entsprechendes Einzelbild, und alle anderen Bildparameter können sinngemäß benutzt werden.

Verlinkung[Bearbeiten | Quelltext bearbeiten]

  • Soll die Mediendatei nicht in die Seite eingebunden werden, sondern auf ihre Dateibeschreibungsseite verwiesen werden, so ist ein Doppelpunkt voranzustellen, und es entsteht ein normales Wikilink:
[[:Datei:Dateiname|Linktitel]]
  • Eine Direktverlinkung auf die Mediendatei (etwa für animierte Grafiken) ist möglich mit
[[Media:Dateiname|Linktitel]]

Alle vorgenannten Formate sind Wikilinks, und die Dateien erscheinen bei „Links auf diese Seite“. Ändert sich der Dateiname, kann dies automatisch aktualisiert werden, auch von Commons aus.

Weil sie nicht rückverfolgt und zentral berichtigt werden können, sollten URI vermieden werden wie etwa:

Weitere Informationen[Bearbeiten | Quelltext bearbeiten]

 MediaWiki: Help:Images – Technische Informationen (englisch)

Anmerkungen[Bearbeiten | Quelltext bearbeiten]

  1. disablecontrols ist eine Komma-getrennte Aufzählung von einem oder mehreren der Schlüsselwörter options, timedText, fullscreen und deaktiviert die entsprechenden Elemente (Juni 2013; Gerrit:57540).
    Inzwischen gilt dieser Parameter als „veraltet“, sein Einsatz wird nicht mehr empfohlen und dies wird vorausichtlich zukünftig nicht mehr unterstützt.
  2. lang ist ein Sprachcode nach ISO 639 oder Wiki-intern und kann ausschließlich bei SVG-Bildern benutzt werden, um eine von mehreren Textversionen zu aktivieren (Juni 2013; phab:T34987 (Bugzilla:32987)Gerrit:25838).
  3. Der Parameter manualthumb=linkziel wird nicht mehr benutzt; thumbnail=linkziel hatte (zwischenzeitlich) die gleiche Funktionalität. Mittlerweile ist keine Angabe eines Linkziels mehr möglich und verweis=linkziel zu benutzen.
  4. a b Die Parameter noicon und noplayer gehörten zu den Multimedia-Abspielmöglichkeiten und sind inzwischen funktionslos.
  5. a b Dieser Parameter wurde in der deutschsprachigen Wikipedia bisher nicht benutzt und könnte bald wieder entfernt werden.
  6. Früher sollte thumbnail=linkziel eine Verlinkung erlauben. Mittlerweile ist keine direkte Angabe eines Linkziels mehr möglich und es ist gesondert verweis=linkziel zu benutzen (WP:NEU 2008, phab:T36194 (Bugzilla:34194)).
  7. w3.org