Hilfe:Medieneinbindung

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

• Hilfe:Bilder
• Hilfe:Audio #Einbinden in Wikipedia-Artikel
• Hilfe:Video #Einbinden in Wikipedia-Artikel

Keine gesonderte Hilfeseite gibt es zu „Dokumenten“.

Parameter

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.
• Es ist nur genau ein nicht erkannter Parameter zulässig, nämlich die Bildlegende (caption).

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		klasse		Selektor	×	×	×	×
disablecontrols				Schaltelemente	–	×	×	–	H:A,H:V
end				Zeitpunkt					H:A,H:V
framed	frame enframed	gerahmt		–	×			×	H:B
frameless		rahmenlos		–	×			×	H:B
lang		sprache		Sprachcode	×	–	–	–	H:B
left		links		–	×	×	×	×	H:B
link		verweis		Seite/URL	×			×	H:B
lossy				1, true, lossy, 0, false, lossless	–	–	–	×	s. u.
manualthumb				Seite/URL	×	×	×	×
middle		mitte		–	×	×	×	×	H:B/v
noicon				–	–	×	×	–	H:A,H:V
none		ohne		–	×	×	×	×	H:B
noplayer				–	–	×	×	–	H:A,H:V
page		seite		Zahl	–	–	–	×	s. u.
px				Abmessungen	×	×	×	×	H:B
right		rechts		–	×	×	×	×	H:B
start				Zeitpunkt					H:A,H:V
sub		tief	tiefgestellt	–	×	×	×	×	H:B/v
super	sup	hoch	hochgestellt	–	×	×	×	×	H:B/v
text-bottom		text-unten		–	×	×	×	×	H:B/v
text-top		text-oben		–	×	×	×	×	H:B/v
thumbnail	thumb	mini	miniatur	optional: Seite/URL	×	×	×	×	H:B
thumbtime				Zeitpunkt	–	–	×	–	H:V
top		oben		–	×	×	×	×	H:B/v
upright		hochkant		optional: Zahl	×			×	H:B
(caption)				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

Einzelseite (DjVu)

Bei den Dokumenteinbindungen geht es um paged media; 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 Dokumenten wie solchen auf ein entsprechendes Einzelbild, und alle anderen Bildparameter können sinngemäß benutzt werden.

Timed Media

Audio- und Videoformate sind zeitgesteuerte Medien.

• Zum Abspielen in der Wiki-Seite wurde und wird über die Jahre unterschiedliche Abspiel-Software angeboten, die ggf. spezifische Parameter ausnutzen.
• Allgemein funktionieren:
  • thumbtime (nur Video) – Bild zu diesem Zeitpunkt als Miniaturbild anzeigen
  • start Anfangszeitpunkt des Abspielens
  • end Endzeitpunkt des Abspielens
• Alle weiteren Parameter sind von der aktuellen Software abhängig.

Verlinkung

Beispiel für die Einbindung mit Media:… bei einer animierten SVG-Datei, empfohlener Text:
animiertes SVG, anklicken zum Start; funktioniert nicht in allen Browsern

• Soll die Mediendatei nicht in die Seite eingebunden werden, sondern auf ihre Dateibeschreibungsseite verwiesen werden, so ist ein Doppelpunkt voranzustellen, und es entsteht ein normaler Wikilink:
  [[:Datei:Dateiname|Linktitel]]
• Eine Direktverlinkung auf die Mediendatei (etwa für animierte Grafiken) ist möglich mit
  [[Media:Dateiname|Linktitel]]
  Zu beachten ist hier, dass aus Lizenzgründen weiterhin zusätzlich eine Verlinkung zur Dateibeschreibung notwendig ist, wenn die Datei nicht gemeinfrei ist.

Alle vorgenannten Formate sind Wikilinks, und die Dateien erscheinen bei „Links auf diese Seite“ bzw. Spezial:Globale Benutzung. Ä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:

• //upload.wikimedia.org/wikipedia/commons/…
• {{dateipfad:Dateiname}} oder {{filepath:Dateiname}}

Ebenso zu vermeiden sind Links, wie sie vom Medienbetrachter erzeugt werden:

• https://de.wikipedia.org/wiki/Beispiel#/media/Datei:Example_de.svg (Verlinkung aus Artikel heraus)
• https://commons.wikimedia.org/wiki/File:Example_de.svg#/media/File:Example_de.svg (Verlinkung aus der Dateibeschreibungsseite heraus)
• https://commons.wikimedia.org/wiki/Category:Example_images#/media/File:Example_de.jpg (Verlinkung aus einer Kategorie heraus, hier JPG-Datei statt SVG)

Stattdessen ist die Datei je nach Intention entsprechend einer der obigen Anweisungen einzubinden:

• [[Datei:Example de.svg|mini|alt=Abbildung enthält nur den Text „nur ein Beispiel“.|Beispielbild]]
• [[:Datei:Example de.svg|Beispielbild]]

Eine Einbindung wie [[Beispiel#/media/Datei:Example_de.svg|Beispielbild]] ist ebenfalls falsch, stellt sie doch nur die Wikilink-Variante des ersten falschen Beispiels dar. Unter Umständen kann hier völlig auf ein Bild verzichtet werden, sondern direkt auf den Artikel oder einen seiner Abschnitte verlinkt werden, siehe dazu Hilfe:Links.

Weitere Informationen

MediaWiki: Help:Images – Freie Wikisoftware (englisch)

• Wikipedia:Extended image syntax in der englischsprachigen Wikipedia
• mw:Extension:TimedMediaHandler #Syntax synopsis (englisch) zu Multimedia-Abspielmöglichkeiten