Quelltext der Seite Hilfe:Medieneinbindung

<!-- ohne Shortcut; selten besuchte Seite -->
{{Hilfe|1=
* [[Hilfe:Bild und Ton]]
* [[Hilfe:Wikisyntax]]
}}

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:
<code><nowiki>[[</nowiki>Datei:</code>''Dateiname''<code>|</code>''Parameter''<code>|</code>''Parameter''<code>]]</code>
* 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“.
{| class="wikitable"
|-
! Generisch !! Alias !! [[Lokalisierung (Softwareentwicklung)|Lokalisierung]] („deutsch“) !! alternativ
! Wert
! Bild !! Audio !! Video !! [[#Dokument|Dokument]]
! Info
|-
| <code>alt</code> || &nbsp; || <code>alternativtext</code> || &nbsp;
| Beschreibender Text
| × || &nbsp; || &nbsp; || ×
| [[Hilfe:Bilder#Bildlegende und Alternativtext|H:B]]
|-
| <code>baseline</code> || &nbsp; || <code>grundlinie</code> || &nbsp;
| –
| × || × || × || ×
| [[Hilfe:Bilder/vertikale Ausrichtung#grundlinie / baseline|H:B/v]]
|-
| <code>border</code> || &nbsp; || <code>rand</code> || &nbsp;
| –
| × || &nbsp; || &nbsp; || ×
| [[Hilfe:Bilder#Rand|H:B]]
|-
| <code>bottom</code> || &nbsp; || <code>unten</code> || &nbsp;
| –
| × || × || × || ×
| [[Hilfe:Bilder/vertikale Ausrichtung#unten / bottom|H:B/v]]
|-
| <code>center</code> || <code>centre</code> || <code>zentriert</code> || &nbsp;
| –
| × || × || × || ×
| [[Hilfe:Bilder#Ausrichten im Text|H:B]]
|-
| <code>class</code> || &nbsp; || <code>klasse</code> || &nbsp;
| [[Hilfe:Tags#class|Selektor]]
| × || × || × || ×
| 
|-
| <code><s>disablecontrols</s></code> || &nbsp; || &nbsp; || &nbsp;
| Schaltelemente<ref name="disablecontrols" />
| – || × || × || –
| [[Hilfe:Audio#Einbinden in Wikipedia-Artikel|H:A]],[[Hilfe:Video#Einbinden in Wikipedia-Artikel|H:V]]
|-
| <code>end</code> || &nbsp; || &nbsp; || &nbsp;
| Zeitpunkt
| &nbsp; || &nbsp; || &nbsp; || &nbsp;
| [[Hilfe:Audio#Einbinden in Wikipedia-Artikel|H:A]],[[Hilfe:Video#Einbinden in Wikipedia-Artikel|H:V]]
|-
| <code>framed</code> || <code>frame</code> <code>enframed</code> || <code>gerahmt</code> || &nbsp;
| –
| × || &nbsp; || &nbsp; || ×
| [[Hilfe:Bilder#Originalgröße|H:B]]
|-
| <code>frameless</code> || &nbsp; || <code>rahmenlos</code> || &nbsp;
| –
| × || &nbsp; || &nbsp; || ×
| [[Hilfe:Bilder#Thumbnails|H:B]]
|-
| <code>lang</code> || &nbsp; || <code>sprache</code> || &nbsp;
| Sprachcode<ref name="lang" />
| × || – || – || –
| [[Hilfe:Bilder#SVG-Dateien|H:B]]
|-
| <code>left</code> || &nbsp; || <code>links</code> || &nbsp;
| –
| × || × || × || ×
| [[Hilfe:Bilder#Ausrichtung links|H:B]]
|-
| <code>link</code> || &nbsp; || <code>verweis</code> || &nbsp;
| Seite/URL
| × || &nbsp; || &nbsp; || ×
| [[Hilfe:Bilder#Von der Dateibeschreibungsseite abweichendes Linkziel|H:B]]
|-
| <code>lossy</code> || &nbsp; || &nbsp; || &nbsp;
| 1, true, lossy, 0, false, lossless
| – || – || – || ×
| [[#Dokument|s.&nbsp;u.]]
|-
| <code><s>manualthumb</s></code><ref name="manualthumb" /> || &nbsp;
| &nbsp; || &nbsp;
| Seite/URL
| × || × || × || ×
|
|-
| <code>middle</code> || &nbsp; || <code>mitte</code> || &nbsp;
| –
| × || × || × || ×
| [[Hilfe:Bilder/vertikale Ausrichtung#mitte / middle|H:B/v]]
|-
| <code><s>noicon</s></code><ref name="noicon-noplayer" /> || &nbsp; || &nbsp; || &nbsp;
| –
| – || × || × || –
| [[Hilfe:Audio#Einbinden in Wikipedia-Artikel|H:A]],[[Hilfe:Video#Einbinden in Wikipedia-Artikel|H:V]]
|-
| <code>none</code> || &nbsp; || <code>ohne</code> || &nbsp;
| –
| × || × || × || ×
| [[Hilfe:Bilder#Ausrichten im Text|H:B]]
|-
| <code><s>noplayer</s></code><ref name="noicon-noplayer" /> || &nbsp; || &nbsp; || &nbsp;
| –
| – || × || × || –
| [[Hilfe:Audio#Einbinden in Wikipedia-Artikel|H:A]],[[Hilfe:Video#Einbinden in Wikipedia-Artikel|H:V]]
|-
| <code>page</code> || &nbsp; || <code>seite</code> || &nbsp;
| Zahl
| – || – || – || ×
| [[#Dokument|s.&nbsp;u.]]
|-
| <code>px</code> || &nbsp; || &nbsp; || &nbsp;
| Abmessungen<ref>Vermutlich jedes Wort, das auf <code>px</code> endet, wird zunächst als Bildgröße zugeordnet, aber ggf. erst in einem späteren Schritt verworfen.</ref>
| × || × || × || ×
| [[Hilfe:Bilder#Bilder skalieren|H:B]]
|-
| <code>right</code> || &nbsp; || <code>rechts</code> || &nbsp;
| –
| × || × || × || ×
| [[Hilfe:Bilder#Ausrichten im Text|H:B]]
|-
| <code>start</code> || &nbsp; || &nbsp; || &nbsp;
| Zeitpunkt
| &nbsp; || &nbsp; || &nbsp; || &nbsp;
| [[Hilfe:Audio#Einbinden in Wikipedia-Artikel|H:A]],[[Hilfe:Video#Einbinden in Wikipedia-Artikel|H:V]]
|-
| <code><s>sub</s></code><ref>[[Spezial:LintErrors/bogus-image-options|Fehlerauslösend]]</ref> || &nbsp; || <code>tief</code> || tiefgestellt<ref name="dewiki-0" />
| –
| × || × || × || ×
| [[Hilfe:Bilder/vertikale Ausrichtung#tief / tiefgestellt / sub|H:B/v]]
|-
| <code>super</code> || <code>sup</code> || <code>hoch</code> || hochgestellt<ref name="dewiki-0" />
| –
| × || × || × || ×
| [[Hilfe:Bilder/vertikale Ausrichtung#hoch / hochgestellt / sup / super|H:B/v]]
|-
| <code>text-bottom</code> || &nbsp; || <code>text-unten</code> || &nbsp;
| –
| × || × || × || ×
| [[Hilfe:Bilder/vertikale Ausrichtung#text-unten / text-bottom|H:B/v]]
|-
| <code>text-top</code> || &nbsp; || <code>text-oben</code> || &nbsp;
| –
| × || × || × || ×
| [[Hilfe:Bilder/vertikale Ausrichtung#text-oben / text-top|H:B/v]]
|-
| <code>thumbnail</code> || <code>thumb</code> || <code>mini</code> || miniatur
| ''optional:'' Seite/URL<ref name="thumbnail=" />
| × || × || × || ×
| [[Hilfe:Bilder#Thumbnails|H:B]]
|-
| <code>thumbtime</code> || &nbsp; || &nbsp; || &nbsp;
| Zeitpunkt
| – || – || × || –
| [[Hilfe:Video#Einbinden in Wikipedia-Artikel|H:V]]
|-
| <code>top</code> || &nbsp; || <code>oben</code> || &nbsp;
| –
| × || × || × || ×
| [[Hilfe:Bilder/vertikale Ausrichtung#oben / top|H:B/v]]
|-
| <code>upright</code> || &nbsp; || <code>hochkant</code> || &nbsp;
| ''optional:'' Zahl
| × || &nbsp; || &nbsp; || ×
| [[Hilfe:Bilder#Automatische Skalierung|H:B]]
|-
| ''(caption)''
|colspan="3"| &nbsp; || Legendentext<ref name="caption" />
| × || × || × || ×
| [[Hilfe:Bilder#Bildlegende und Alternativtext|H:B]]
|}

Bedeutung der Symbole in der Tabelle:
* × &nbsp; &nbsp; Parameter wirkt auf diese Medienart
* – &nbsp; &nbsp; 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 ==

[[Datei:Kreisbewegungen-Coppernicus-0.djvu|seite=9|mini|Einzelseite (DjVu)<!--<hr />Quelltext für dieses Beispiel:<br /><code><nowiki>[[Datei:Kreisbewegungen-Coppernicus-0.djvu|seite=9|mini|Einzelseite (DjVu)]]</nowiki></code>-->]]

Bei den Dokumenteinbindungen geht es um ''paged media'';<ref>[http://www.w3.org/TR/2004/WD-SVG12-20041027/multipage.html w3.org]</ref> 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 <code>page</code> bei einigen Formaten, also etwa <code>|page=123|</code> usw. Zurzeit sind unter MediaWiki verfügbar:
{| class="wikitable"
|-
! Format
! Unterstützung für <code>page</code>
|-
| <code>[[DjVu|.djvu]]</code>
| ×
|-
| <code>[[Microsoft Word|.doc]]</code>
|
|-
| <code>[[OpenDocument|.odt]]</code>
|
|-
| <code>[[Portable Document Format|.pdf]]</code>
| × ([[mw:Extension:PdfHandler]])
|-
| <code>[[Tagged Image File Format|.tiff]]</code>, <code>.tif</code>
| ×
|}

Der Parameter <code>lossy</code> 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:
** <code>thumbtime</code> (nur Video) – Bild zu diesem Zeitpunkt als Miniaturbild anzeigen
** <code>start</code> Anfangszeitpunkt des Abspielens
** <code>end</code> Endzeitpunkt des Abspielens
* Alle weiteren Parameter sind von der aktuellen Software abhängig.

== Verlinkung ==
[[Datei:Rolling circle optical illusion.svg|mini|''Beispiel für die Einbindung mit <code>Media:…</code> bei einer animierten [[Scalable Vector Graphics|SVG]]-Datei, empfohlener Text:''<br/>[[Media:Rolling circle optical illusion.svg|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:<br /> <code><nowiki>[[</nowiki>:Datei:</code>''Dateiname''<code>|</code>''Linktitel''<code>]]</code>
* Eine Direktverlinkung auf die Mediendatei (etwa für animierte Grafiken) ist möglich mit<br /> <code><nowiki>[[</nowiki>Media:</code>''Dateiname''<code>|</code>''Linktitel''<code>]]</code><br /> 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 [[Uniform Resource Identifier|URI]] vermieden werden wie etwa:
* <code>//upload.wikimedia.org/wikipedia/commons/…</code>
* <code><nowiki>{{dateipfad:</nowiki>''Dateiname''<nowiki>}}</nowiki></code> oder <code>[[Hilfe:Parserfunktionen/Seite und URL#filepath|<nowiki>{{filepath:</nowiki>''Dateiname''<nowiki>}}</nowiki>]]</code>

Ebenso zu vermeiden sind Links, wie sie vom [[Hilfe:Medienbetrachter|Medienbetrachter]] erzeugt werden: 
* <code><nowiki>https://de.wikipedia.org/wiki/Beispiel#/media/Datei:Example_de.svg</nowiki></code> (Verlinkung aus Artikel heraus)
* <code><nowiki>https://commons.wikimedia.org/wiki/File:Example_de.svg#/media/File:Example_de.svg</nowiki></code> (Verlinkung aus der Dateibeschreibungsseite heraus)
* <code><nowiki>https://commons.wikimedia.org/wiki/Category:Example_images#/media/File:Example_de.jpg</nowiki></code> (Verlinkung aus einer Kategorie heraus, hier JPG-Datei statt SVG)

Stattdessen ist die Datei je nach Intention entsprechend einer der obigen Anweisungen einzubinden:
* <code><nowiki>[[Datei:Example de.svg|mini|alt=Abbildung enthält nur den Text „nur ein Beispiel“.|Beispielbild]]</nowiki></code>
* <code><nowiki>[[:Datei:Example de.svg|Beispielbild]]</nowiki></code>

Eine Einbindung wie <code><nowiki>[[Beispiel#/media/Datei:Example_de.svg|Beispielbild]]</nowiki></code> 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]].

{{Hilfe/Weitere Informationen|Liste=
{{MediaWiki|Help:Images}}
* ''[[:en:Wikipedia:Extended image syntax|Wikipedia:Extended image syntax]]'' in der englischsprachigen Wikipedia
* [[mw:Extension:TimedMediaHandler #Syntax synopsis (englisch)]] zu [[#Timed Media|Multimedia-Abspielmöglichkeiten]]
}}

== Anmerkungen ==

<references>
<ref name="caption">
Dieser Parameter ist die erste nicht erkannte Zuweisung und sollte immer als allerletzte stehen.<br />
Bis Anfang 2022 wurde dieser Text sowohl für die Legende eines Miniaturbilds, sonst für Tooltips, technisch (noch) nicht darstellbare Grafiken und als alternative Bildbeschreibung für blinde Menschen genutzt.<br />
Seitdem ist er ausschließlich für Miniaturbilder zulässig, sonst nur in Kombination mit dem Parameter <code>alt=</code>. Dabei darf <code>|alt=|</code> eine leere Zuweisung sein.
</ref>
<ref name="dewiki-0">
Dieser Parameter wurde in der deutschsprachigen Wikipedia bisher nicht benutzt und könnte bald wieder entfernt werden.
</ref>
<ref name="disablecontrols">
<code>disablecontrols</code> ist eine Komma-getrennte Aufzählung von einem oder mehreren der Schlüsselwörter <code>options</code>, <code>timedText</code>, <code>fullscreen</code> und deaktiviert die entsprechenden Elemente (Juni 2013; [[Gerrit:57540]]).<br />
Inzwischen gilt dieser Parameter als „veraltet“, sein Einsatz wird nicht mehr empfohlen und dies wird voraussichtlich zukünftig nicht mehr unterstützt.
</ref>
<ref name="lang">
<code>lang</code> ist ein [[Wikipedia:Technik/MediaWiki/Sprachen|Sprachcode]] nach [[ISO 639]] oder Wiki-intern und kann ausschließlich bei [[Scalable Vector Graphics|SVG]]-Bildern benutzt werden, um eine von mehreren Textversionen zu aktivieren (Juni 2013; {{Phab|Bugzilla=32987}} → [[Gerrit:25838]]).
</ref>
<ref name="manualthumb">
Der Parameter <code>manualthumb=</code>''linkziel'' wird nicht mehr benutzt; <code>thumbnail=</code>''linkziel'' hatte (zwischenzeitlich) die gleiche Funktionalität. Mittlerweile ist keine Angabe eines Linkziels mehr möglich und <code>verweis=</code>''linkziel'' zu benutzen.
</ref>
<ref name="noicon-noplayer">
Die Parameter <code>noicon</code> und <code>noplayer</code> gehörten zu den Multimedia-Abspielmöglichkeiten und sind inzwischen funktionslos.
</ref>
<ref name="thumbnail=">
Früher sollte <code>thumbnail=</code>''linkziel'' eine Verlinkung erlauben. Mittlerweile ist keine direkte Angabe eines Linkziels mehr möglich und es ist gesondert <code>verweis=</code>''linkziel'' zu benutzen ([[WP:Projektneuheiten/Archiv/2008-1#8. April|WP:NEU 2008]], {{Phab|Bugzilla=34194}}).
</ref>
</references>
<noinclude>
[[Kategorie:Hilfe:Bild und Ton]]
[[Kategorie:Hilfe:Wikisyntax]]
</noinclude>