Hilfe:Bilder
Hinweis: Wenn Du diese Seite bearbeitest, stimmst Du zu, dass Dein Beitrag unter der [CC0] veröffentlicht wird. Mehr Informationen findest du auf der Public Domain Hilfeseite. |
Diese Seite erklärt die Syntax zum Einfügen von Bilddateien in ein Wiki. Normalerweise musst du oder ein anderer Nutzer ein Bild hochladen bevor es auf einer Seite benutzt werden kann.
Auf einem MediaWiki-Server gespeicherte Bilder werden normalerweise dargestellt, indem das File:
Namensraum-Präfix als Sprungziel eines MediaWiki Links verwendet wird. (Die alte Schreibweise Image:
wird ebenfalls noch unterstützt).
Das alternative Namensraum-Präfix Media:
kann ebenfalls genutzt werden, um auf den originalen Dateiinhalt zu verweisen (um ihn separat auf einer beliebigen MediaWiki Seite anzuzeigen oder herunterzuladen).
Voraussetzungen
Bevor Bilder im Wiki benutzt werden können, muss ein Wiki-Admin das Hochladen von Dateien freigeschaltet haben. Außerdem muss der Benutzer Dateien hochgeladen haben. Die Systemadministratoren können auch Dateien anderer Quellen wie Wikimedia Commons zulassen. Es ist notwendig, einen Bildskalierer (z.B. GD2, ImageMagick) für das Wiki zu installieren, falls die Bilder vom Server in verschiedenen Größen bereitgestellt werden sollen.
Unterstützte Bildformate
Die folgenden Formate werden standardmäßig unterstützt.
.jpg
oder.jpeg
- Bitmap-Bilder im Standard JPEG-Format komprimiert (dieses verlustbehaftete Format eignet sich am besten für Fotos)..png
- Bitmap-Bild im Portable Network Graphics Format (spezifiziert vom W3 Consortium)..gif
- Bitmap-Bild im alten Graphics Interchange Format..webp
- WebP unterstützt verlustbehaftete und verlustlose Kompression bei einer Reduzierung der Bildgröße um bis zu 45%.
Andere von Wikimedia verwendete Formate, die üblicherweise auch anderswo aktiviert sind (sie bedürfen möglicherweise einer über die gewöhnliche Aktivierung hinausgehenden Konfiguration):
.svg
- Skalierbare Bilddatei im "Scalable Vector Graphics"-Format (spezifiziert durch das "W3-Konsortium"). Siehe Manual:Image Administration#SVG..tiff
- Abkürzung für "tagged image format". Häufig verwendet für hochauflösende Archivbilder. Häufig verwendet mit Erweiterung:PagedTiffHandler ..ogg
,.oga
,.ogv
- Ogg-Multimedia-Dateien (Audio oder Video). Kein Bildformat, wird aber ebenso behandelt. Häufig verwendet mit Erweiterung:TimedMediaHandler.pdf
- mehrseitige Dokumente im Portablen Dokumenten Format (ursprünglich von Adobe spezifiziert). Oft in Verbindung mit Erweiterung:PdfHandler benutzt.djvu
- mehrseitige Bitmap-Dokumente im DejaVu-Format (meist Buchscans). Siehe Handbuch:Wie man DjVu mit MediaWiki verwendet- Von
.pdf
oder.djvu
Dateien wird immer nur eine einzelne Seite angezeigt.
- Von
Andere Medientypen können unterstützt werden, aber eventuell nicht deren Darstellung innerhalb des Fließtexts.
Anzeigen eines einzelnen Bildes
Syntax
Die vollständige Syntax für das Anzeigen eines Bildes ist:
[[File:Dateiname.Erweiterung|Optionen|Überschrift]]
Option muss nicht angegeben werden. Möglich sind folgende Optionen, jeweils kleingeschrieben und getrennt durch den vertikalen Strich (|):
- Format Option border und/oder eine der Folgenden: frameless, frame (bzw. framed), thumb (bzw. thumbnail). Note: border can be used in combination with frameless but will be ignored if used with one of the other options.
- Bestimmt wie das angezeigt Bild auf der Seite formatiert und eingebettet wird.
- Größe anpassen (resizing) Option: eine von
- {width}px — ändert die Bildbreite auf das angegebene Maximum, ohne die Höhe festzusetzen. (Es werden nur ganzzahlige Pixelwerte unterstützt. Ein Leerzeichen zwischen dem Wert für die Breite und "px" ist zulässig.)
- x{height}px — begrenzt die Bildhöhe auf die angegebene Pixelzahl, ohne die Breite zu beschränken. Es können nur ganzzahlige Pixelwerte angegeben werden. Ein Leerzeichen zwischen dem Wert für die Höhe und "px" ist zulässig.
- {width}x{height}px — ändert die Bildgröße so, dass mindestens einer der angegebenen Werte erreicht und der andere nicht überschritten wird. Es können nur ganzzahlige Pixelwerte verwendet werden. Ein Leerzeichen zwischen dem Wert für die Breite und "px" ist zulässig.
- upright — Ändert die Bildgröße im Verhältnis zur Vorschau-Bildgröße in den Benutzer-Einstellungen bzw. zur Standard-Größe bei nicht angemeldeten Nutzern. (Sinnvoll beispielsweise für Bilder mit größerer Höhe als Breite, die sonst relativ groß dargestellt würden.) Diese Option ist oft nützlich für Bilder, die höher sind als breit. Entweder thumb oder frameless ist erforderlich. Mit der Einstellung
|upright=1.0|
wird das Bild in der Standardbildbreite des Benutzers angezeigt.|upright=2.0|
zeigt das Bild in der doppelten Standard-Bildbreite des Benutzers an.
- Das Bild behält immer sein Seitenverhältnis bei.
- Bilder in nicht skalierbaren Medientypen (z.B. Bitmap-Bilder) können verkleinert, aber nicht vergrößert werden.
- Die Einstellung
upright
erfordert kein Gleichheitszeichen, d. h.|upright 2.0|
funktioniert ebenso wie|upright=2.0|
. - Bei Verwendung ohne Wert oder Gleichheitszeichen (z. B.
|upright|
) wird standardmäßig|upright=0.75|
verwendet (obwohl|upright=|
mit|upright=1.0|
identisch ist). - Die voreingestellte Maximalgröße hängt ab vom Format und den internen Bildmaßen (je nach Medientyp).
- Option zur horizontalen Ausrichtung: entweder left, right, center oder none. Wenn mehrere dieser Optionen vorhanden sind, wird nur die erste verwendet;
- Bestimmt die horizontale Ausrichtung (sowie die inline/block oder floating Varianten) des Bildes innerhalb eines Textabschnitts (keine Vorgabe).
- Option zur vertikalen Ausrichtung: entweder baseline, sub, super, top, text-top, middle, bottom oder text-bottom.
- Bestimmt die vertikale Ausrichtung eines non-floating inline Bildes relativ zu dem vor oder nach dem Bild stehenden Text innerhalb des selben Blocks (die vertikale Standardausrichtung ist middle)
- Link option: Eine von
- link={target} — Erlaubt das Ändern des erzeugten Linkziels (zu einem beliebigen Seitentitel oder URL), aktivierbar auf der angezeigten Bildfläche ; z.B.
[[File:Example.jpg|20px|link=http://www.wikipedia.org]]
wird dargestellt als (externer Link), oder[[File:Example.jpg|20px|link=MediaWiki]]
als (interner Link). - link= (mit einem Leerwert) — (MediaWiki 1.14+) Zeigt ein Bild ohne aktivierbaren Link; z.B.
[[File:Example.jpg|20px|link=]]
wird dargestellt als .
- Wenn zwischen
link
und dem Gleichheitszeichen ein Leerzeichen steht, wird die Link-Beschreibung als Beschriftung verwendet. - Das Einfügen einiger HTML-Zeichen-Äquivalente, wie
%22
für"
, kann dazu führen, dass die Link-Anweisung als Bildunterschrift behandelt wird (siehe phabricator:T306216). - ! für MW Version 1.24 und kleiner: Wenn
|link=|
angegeben ist, dann wird beim überfahren mit dem Mauszeiger abhängig vom benutzten Browser nicht zwingend ein Text angezeigt (siehe phabricator:T23454).
- link={target} — Erlaubt das Ändern des erzeugten Linkziels (zu einem beliebigen Seitentitel oder URL), aktivierbar auf der angezeigten Bildfläche ; z.B.
- Andere spezifische Optionen:
- alt={alternativer Text} — (MediaWiki 1.14+) spezifiziert alternativen Text (bezogen auf das HTML Attribut
alt="..."
des generierten<img />
Elements) eines Bilds, der angezeigt wird, wenn entweder das gewünschte Bild nicht heruntergeladen und angezeigt werden kann oder das anzeigende System diesen Text verwenden muss (z. B. wenn ein Braille-Leser eingesetzt wird oder der Nutzer den Browser entsprechend einstellt).
- Wenn zwischen
alt
und dem Gleichheitszeichen ein Leerzeichen steht, wird die alt-Anweisung als Beschriftung verwendet.
- page={number} — Zeigt die angegebene Seitennummer an (zur Zeit nur verwendbar, wenn eine .djvu- oder eine .pdf-Datei angezeigt wird).
- thumbtime={number} — Zeigt ein Vorschaubild des Videos bei der angegebenen Zeitmarke in Sekunden, im MM:SS- oder HH:MM:SS-Format (nur anwendbar beim Zeigen von Video-Dateien).
- start={number} — Beim Abspielen des Videos beginnt es bei der angegebenen Zeitmarke in Sekunden, im MM:SS- oder HH:MM:SS-Format (nur anwendbar beim Zeigen von Video-Dateien).
- muted — Wenn Medien abgespielt werden, wird der Ton stummgeschaltet.
- loop — Medien werden in einer Schleife wiedergegeben. (Nur anwendbar auf Audio und Video)
- lossy={false} — (PagedTiffHandler ) Um PNG- anstatt JPG-Vorschaubilder für Tiff-Bilddateien zu verwenden
- class={html class} — (MediaWiki 1.20+)Definiert die Klassen (spezifiziert das HTML-Attribut
class="..."
des generierten<span>...</span>
-Elements, welches das<img />
-Element umgibt). - lang={language code} — (MediaWiki 1.22+) Wählt bei SVG-Dateien mit <switch>-Anweisungen (die beim Attribut systemLanguage variieren) aus, in welcher Sprache die Datei dargestellt werden soll. Die Standardeinstellung ist die Sprache der Seite (bei den meisten Projekten ist die Standardsprache des Projekts voreingestellt).
- alt={alternativer Text} — (MediaWiki 1.14+) spezifiziert alternativen Text (bezogen auf das HTML Attribut
Wenn ein Parameter mit keiner der anderen Möglichkeiten übereinstimmt, wird davon ausgegangen, dass er der Beschriftungstext ist. Wenn mehr als eine Nicht-Parameter-Zeichenfolge vorhanden ist, wird die letzte Nicht-Parameter-Zeichenfolge als Beschriftung verwendet. Beschriftungstext wird unterhalb von Bildern im thumb und frame Format angezeigt oder als Tooltip-Text bei Bildern in jedem anderen Format. Der in den Formaten thumb und frame angezeigte Beschriftungstext kann Wiki-Links und andere Formatierungen enthalten. MediaWiki Erweiterungen können zusätzliche Optionen hizufügen.
Wenn "alt" nicht festgelegt ist und eine Beschriftung angegeben wird, wird der alternative Text automatisch aus der Beschriftung erstellt, allerdings ohne Formatierung. Außer im "thumb" oder "frame" Format, in denen die Beschriftung bereits für Screenreader lesbar ist.
Format
Die folgende Tabelle zeigt die Auswirkung aller verfügbaren Formate.
Beschreibung | Man tippt | Man erhält |
---|---|---|
Kein Format angegeben Rendered as a floating block: Nein Rendered inline: Ja Rendered caption: Nein |
... Text Text Text [[File:example.jpg|Überschrift]] Text Text Text ... |
... Text Text Text |
border ergibt einen sehr dünnen grauen Rand. Rendered as a floating block: Nein Rendered inline: Ja Rendered caption: Nein |
... Text Text Text [[File:example.jpg|border|Überschrift]] Text Text Text ... |
... Text Text Text |
frameless übernimmt (wie thumbnail) die User-Vorgabe für die Bildbreite, jedoch ohne Rahmen und ohne rechtes Umfließen des Textes Rendered as a floating block: Nein Rendered inline: Ja Rendered caption: Nein |
... Text Text Text [[File:example.jpg|frameless|Überschrift]] Text Text Text ... |
... Text Text Text |
frameless and border
frameless (Rahmenlos) und border (Begrenzung) |
... Text Text Text [[File:example.jpg|frameless|border|Überschrift]] Text Text Text ... |
... Text Text Text |
frame Rendered as a floating block: Ja Rendered inline: Nein Rendered caption: Ja |
... Text Text Text [[File:example.jpg|frame|Überschrift]] Text Text Text ... |
... Text Text Text
Text Text Text ... |
thumb oder thumbnail Rendered as a floating block: Ja Rendered inline: Nein Rendered caption: Ja |
... Text Text Text [[File:example.jpg|thumb|Überschrift]] Text Text Text ... |
... Text Text Text
Text Text Text ... |
Wenn die Höhe eines Bilds in der Miniaturansicht größer als seine Breite ist (d. h. Hochformat statt Querformat) und es zu groß dargestellt wird, kann die Option upright=N
verwendet werden, wobei N für das Seitenverhältnis des Bildes steht (Breite geteilt durch Höhe, standardmäßig 0,75).
Alternativ kann die gewünschte maximale Höhe (in Pixeln) direkt angegeben werden.
Beachte, dass Du durch Einfügen von thumb={filename}
ein anderes Bild für die Miniaturansicht verwenden kannst.
Größe und Rahmen
In verschiedenen Formaten kann die Wirkung des Größenparameters unterschiedlich ausfallen, wie unten gezeigt.
- Wie es angezeigt wird, wenn seine Größe nicht angegeben ist, findest Du im obigen Abschnitt Format.
- Wenn das Format nicht angegeben oder nur
border
enthält, kann die Größe auf jede angegebene Größe verkleinert und vergrößert werden. - In den folgenden Beispielen beträgt die Originalgröße des Bildes 400 × 267 Pixel.
- Ein Bild mit
frame
ignoriert immer die Größenangabe. Das Originalbild wird verkleinert, wenn es die in den Benutzereinstellungen festgelegte maximale Größe überschreitet und die Seiteninformation zeigt einen Linter-Fehler an. - Die Größe eines Bildes mit
thumb
oderframeless
kann reduziert, aber nicht über die Originalgröße des Bildes hinaus vergrößert werden.
Format | Verkleinert | Vergrößert |
---|---|---|
(nicht spezifiziert) |
[[File:example.jpg|50px]] |
[[File:example.jpg|500px]]
|
border |
[[File:example.jpg|border|50px]] |
[[File:example.jpg|border|500px]]
|
frame |
[[File:example.jpg|frame|50px]] |
[[File:example.jpg|frame|500px]]
|
thumb |
[[File:example.jpg|thumb|50px]] |
[[File:example.jpg|thumb|500px]]
|
frameless |
[[File:example.jpg|frameless|50px]] |
[[File:example.jpg|frameless|500px]] |
Horizontale Ausrichtung
Beachte, dass bei Verwendung der Formate frame
oder thumb[nail]
die horizontale Standardausrichtung right lautet, bei Sprachen von links nach rechts, und links bei Sprachen von rechts nach links.
Beschreibung | Eingabe | Ergebnis |
---|---|---|
Keine horizontale Ausrichtung angegeben oder Standardausrichtung Rendered as a floating block: Nein Rendered inline: Ja |
... Text Text Text [[File:example.jpg|100px|Überschrift]] Text Text Text ... |
... Text Text Text |
horizontale Ausrichtung angeben als: none Rendered as a floating block: Nein Rendered inline: Nein |
... Text Text Text [[File:example.jpg|none|100px|Überschrift]] Text Text Text ... |
... Text Text Text
Text Text Text ... |
horizontale Ausrichtung angeben als: center Rendered as a floating block: Nein Rendered inline: Nein |
... Text Text Text [[File:example.jpg|center|100px|Überschrift]] Text Text Text ... |
... Text Text Text
Text Text Text ... |
horizontale Ausrichtung angeben als: left Rendered as a floating block: Ja Rendered inline: Nein |
... Text Text Text [[File:example.jpg|left|100px|Überschrift]] Text Text Text ... |
... Text Text Text
Text Text Text ... |
horizontale Ausrichtung angeben als: right Rendered as a floating block: Ja Rendered inline: Nein |
... Text Text Text [[File:example.jpg|right|100px|Überschrift]] Text Text Text ... |
... Text Text Text
Text Text Text ... |
Vertikale Ausrichtung
Die vertikalen Ausrichtungsoptionen wirken sich nur aus, wenn das Bild als Inline-Element gerendert wird und nicht floatet. Sie ändern die Art und Weise, in der das eingeblendete Bild vertikal an dem Text ausgerichtet wird, der in demselben Block vor und/oder nach diesem Bild in derselben gerenderten Zeile vorhanden ist.
Beachte, dass die gerenderte Textzeile, in die Inline-Bilder eingefügt werden (und die nach der aktuellen Textzeile gerenderten Textzeilen) nach unten verschoben werden können (dies erhöht die Zeilenhöhe bedingt durch zusätzlichen Zeilenabstand, genau wie dies bei Text mit variablen Schriftgrößen oder mit Hoch- und Tiefstellungen sein kann), damit die Bildhöhe mit dieser Ausrichtungsbeschränkung vollständig angezeigt werden kann.
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''top:''' [[File:Example.jpg|20px|top]] [[File:Example.jpg|40px|top]] [[File:Example.jpg|100px|top]]
<del>text</del></u></span></p>
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-top:''' [[File:Example.jpg|20px|text-top]] [[File:Example.jpg|40px|text-top]] [[File:Example.jpg|100px|text-top]]
<del>text</del></u></span></p>
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sup>super:</sup> [[File:Example.jpg|20px|super]] [[File:Example.jpg|40px|super]] [[File:Example.jpg|100px|super]]
<del>text</del></u></span></p>
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''baseline:''' [[File:Example.jpg|20px|baseline]] [[File:Example.jpg|40px|baseline]] [[File:Example.jpg|100px|baseline]]
<del>text</del></u></span></p>
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sub>'''sub:'''</sub> [[File:Example.jpg|20px|sub]] [[File:Example.jpg|40px|sub]] [[File:Example.jpg|100px|sub]]
<del>text</del></u></span></p>
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''default:''' [[File:Example.jpg|20px]][[File:Example.jpg|40px]] [[File:Example.jpg|100px]]
<del>text</del></u></span></p>
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''middle:''' [[File:Example.jpg|20px|middle]] [[File:Example.jpg|40px|middle]] [[File:Example.jpg|100px|middle]]
<del>text</del></u></span></p>
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-bottom:''' [[File:Example.jpg|20px|text-bottom]] [[File:Example.jpg|40px|text-bottom]] [[File:Example.jpg|100px|text-bottom]]
<del>text</del></u></span></p>
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''bottom:'' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|100px|bottom]]
<del>text</del></u></span></p>
Um das Ausrichtungsergebnis klarer darzustellen, werden die Textbereiche über- und unterstrichen, die Schriftgröße auf 200% erhöht und der Absatzblock mit einem dünnen Rand versehen. zusätzlich werden Bilder unterschiedlicher Größe ausgerichtet:
Hinweise:
- Die "mittlere" vertikale Ausrichtungsposition des Bildes (die auch die Standardposition ist) bezieht sich normalerweise auf die Mitte zwischen der x-Höhe und der Grundlinie des Texts (an der die vertikale Bildmitte ausgerichtet wird und an der in der Regel der Text überschrieben sein kann), jedoch nicht in der Mitte der Zeilenhöhe der Schrifthöhe, die sich auf den Abstand zwischen den Positionen "Text oben" und "Text unten" bezieht; Die Schrifthöhe schließt aus:
- der zusätzliche Zeilenabstand, der normalerweise gleichmäßig in zwei Zeilenränder (hier 0,5em, entsprechend der auf 200% eingestellten Zeilenhöhe) oberhalb und unterhalb der Schrifthöhe aufgeteilt wird.
- der zusätzliche Zeilenabstand, der durch hochgestellte und tiefgestellte Zeichen hinzugefügt werden kann.
- Wenn jedoch die Bildhöhe dazu führt, dass die obere oder untere Position über oder unter der normalen vollen Zeilenhöhe des Texts liegt, wird die mittlere Position nach dem Erhöhen der oberen und/oder unteren Zeilenränder angepasst, damit das Bild angepasst und korrekt ausgerichtet angezeigt werden kann. Alle Bilder (einschließlich der Bilder mit kleineren Höhen) werden vertikal in der angepassten Mittelposition zentriert (zur Berechnung der effektiven Zeilenhöhe wird der Text jeder gerenderten Zeile mit der größeren Schrifthöhe berücksichtigt).
- Die Ausrichtungspositionen "Text oben" und "Text unten" schließen auch den zusätzlichen Zeilenabstand aus, der durch hochgestellte und tiefgestellte Zeichen hinzugefügt wird, jedoch nicht den zusätzlichen Zeilenabstand, der durch die Zeilenhöhe definiert wird.
- Die Ausrichtungspositionen "oben" und "unten" berücksichtigen all diese zusätzlichen Zeilenabstände (einschließlich hochgestellter und tiefgestellter Zeilen, wenn sie in einem gerenderten Zeilenbereich vorhanden sind). Wenn die Bildausrichtung das Bild so einschränkt, dass es über oder unter dem normalen Zeilenabstand hinausragt und das Bild nicht absolut positioniert ist, werden durch das Bild die Positionen "oben" und "unten" angepasst (genau wie bei Hoch- und Tiefstellungen). Daher ist die effektive Zeilenhöhe zwischen gerenderten Textzeilen höher.
- Die Textformatierungen "unterstrichen", "überstrichen" und "durchgestrichen" sollten irgendwo innerhalb dieser beiden Grenzen liegen und können von der Art und Höhe der verwendeten Schriftarten abhängen (die hochgestellten und tiefgestellten Stile können berücksichtigt werden) In einigen Browsern werden diese Stile jedoch normalerweise ignoriert und die Position dieser Textformatierungen möglicherweise nicht angepasst. Daher haben diese Formatierungen normalerweise keinen Einfluss auf die vertikale Position der Bilder relativ zum Text.
Textfluss stoppen
Gelegentlich ist es wünschenswert, zu verhindern, dass Text (oder andere nicht floatende Inline-Bilder) um ein floatendes Bild herumfließen.
Abhängig von der Bildschirmauflösung des Webbrowsers und dergleichen kann der Textfluss auf der rechten Seite eines Bildes dazu führen, dass rechts neben dem Bild eine Abschnittsüberschrift (z. B. == My Header ==) angezeigt wird, anstatt darunter, wie man es erwarten würde.
Der Textfluss kann gestoppt werden, indem <div style="clear: both"></div>
vor den Textabschnitt gesetzt wird, der unter dem floatenden Bild beginnen soll.
(Dies kann auch ohne eine Leerzeile geschehen, indem der Abschnitt mit den floatenden Bildern mit <div style="overflow: hidden">…</div>
umbrochen wird, wodurch alle Floats innerhalb des div
-Elements gelöscht werden.)
Alle Bilder werden als Blöcke gerendert (einschließlich zentrierter, nicht floatender Bilder,links oder rechts floatender Bilder sowie gerahmter Bilder oder floatender Vorschaubilder) unterbrechen implizit die umgebenden Textzeilen (beenden den aktuellen Textblock vor dem Bild und erstellen einen neuen Absatz für den Text danach). Sie werden dann vertikal entlang ihres linken oder rechten Ausrichtungsrandes (oder entlang der Mittellinie zwischen diesen Rändern von zentrierten Bildern) gestapelt.
Ändern des Standard-Link-Ziels
Die folgende Tabelle zeigt, wie das Linkziel (Standard ist die Bildbeschreibungsseite auf Commons) geändert oder entfernt werden kann. Durch Ändern des Links wird das in den vorherigen Abschnitten beschriebene Format nicht geändert.
Beschreibung | Du schreibst | Du erhältst |
---|---|---|
Interner Verweis (link) |
... Text Text Text [[File:example.jpg|link=Main Page|Überschrift]] Text Text Text ... |
... Text Text Text |
Externer Link |
... Text Text Text [[File:example.jpg|link=http://wikipedia.org/wiki/Test|Überschrift]] Text Text Text ... |
... Text Text Text |
kein Link (externe oder Dateiseite) |
... Text Text Text [[File:example.jpg|link=|Überschrift]] Text Text Text ... |
... Text Text Text
Text Text Text ... |
Warnung::
- Aufgrund der Lizenzanforderungen in Deinem Wiki kannst Du möglicherweise nicht alle Links zu der Beschreibungsseite entfernen, auf der die erforderlichen Autorenangaben, die Urheberrechtserklärungen, die geltenden Lizenzbestimmungen oder eine vollständigere Beschreibung des gerenderten Bildes (einschließlich des Änderungsverlaufs) angezeigt werden.
- Wenn Du den Ziellink eines Bildes änderst oder entfernst, musst Du an einer anderen Stelle auf Deiner Seite einen expliziten Link zu dieser Beschreibungsseite bereitstellen oder die Urheberrechts- und Autorenangabe sowie gegebenenfalls einen Link zur entsprechenden Lizenz anzeigen, falls sie sich von den Elementen unterscheiden, die für die Einbettungsseite selbst gelten.
- Möglicherweise schränkt Deine Wiki-Richtlinie die Verwendung des alternativen Link-Parameters ein oder erzwingt sogar ein Verbot alternativer Link-Parameter für eingebettete Mediendateien (in diesem Fall wird der Link-Parameter ignoriert) oder akzeptiert sie erst nach Überprüfung durch autorisierte Benutzer oder Administratoren.
Anzeigen einer Bildergalerie
Gallery syntax
Mit dem <gallery>
-Tag kannst Du ganz einfach eine Galerie mit Miniaturansichten erstellen.
Die Syntax ist:
<gallery>
File:file_name.ext|caption|alt=alt language
File:file_name.ext|caption|alt=alt language
{...}
</gallery>
Beachte, dass der Bildcode nicht durch Klammern eingeschlossen ist, wenn er in Galerie-Tags eingeschlossen ist.
Bildunterschriften sind optional und können Wiki-Links oder andere Formatierungen enthalten.
Einige der Parameter, die die Ausgabe der Vorschaubilder steuern, können auch hier verwendet werden, insbesondere diejenigen, die die Datei ändern (im Gegensatz zu denen, die steuern, wo auf der Seite das Bild abgelegt wird).
Bei mehrseitigen Medien wie pdfs kannst Du beispielsweise Code wie page=4
verwenden und bei Videos thumbtime=10
.
Das Präfix File:
kann weggelassen werden.
Es ist jedoch hilfreich, es als Hilfe zum schnellen Auffinden von Bildspezifizierern im Wikitext aufzunehmen (z. B. beim Aufräumen des Seitenlayouts).
Falls beim Klick auf das Bild eine externe Seite als Sprungziel vorgesehen ist, muss die Überschrift vor dem Link-Parameter definiert werden. Ansonsten würde die Überschrift nicht angezeigt.
Zum Beispiel:
<gallery>
File:Example.jpg|Item 1
File:Example.jpg|a link to [[Help:Contents]]
File:Example.jpg
File:Example.jpg|alt=An example image. It has flowers
File:Example.jpg|''italic caption''
File:Example.jpg|link=https://example.com|This text will not render because an external link came first
File:Example.jpg|Links to external website|link=https://example.com
File:Example.jpg|link=w:Main_Page|Internal link
Example.jpg|on page "{{PAGENAME}}"
File:Using Firefox.pdf|page=72
</gallery>
wird formatiert als:
-
Item 1
-
a link to Help:Contents
-
italic caption
-
Links to external website
-
Internal link
-
on page "Images/de"
mode-Parameter
MediaWiki Version: | ≥ 1.22 |
Ab Version 1.22 ist ein mode
-Parameter verfügbar, der über folgende Optionen verfügt:
traditional
ist der Orginal-Galerietyp, der von MediaWiki verwendet wird.nolines
ähnelttraditional
, hat jedoch keine Begrenzungslinien.packed
bewirkt, dass Bilder dieselbe Höhe, aber unterschiedliche Breiten haben, wobei zwischen den Bildern nur wenig Platz gelassen wird. Die Zeilen in diesem responsive Modus ordnen sich nach der Breite des Bildschirms.packed-overlay
zeigt die dem Bild überlagerte Beschriftung in einem halbtransparenten weißen Feld.packed-hover
ähneltpacked-overlay
, nur dass die Beschriftung und das Kästchen nur beim Mouse-over angezeigt werden.slideshow
erstellt eine Diashow der Bilder.
Zum Beispiel:
<gallery mode="packed-hover">
File:Astronotus_ocellatus.jpg|''[[commons:Astronotus ocellatus|Astronotus ocellatus]]'' (Oscar)
File:Salmonlarvakils.jpg|''[[commons:Salmo salar|Salmo salar]]'' (Salmon Larva)
File:Georgia Aquarium - Giant Grouper.jpg|''[[commons:Epinephelus lanceolatus|Epinephelus lanceolatus]]'' (Giant grouper)
File:Pterois volitans Manado-e.jpg|''[[commons:Pterois volitans|Pterois volitans]]'' (Red Lionfish)
File:Macropodus opercularis - front (aka).jpg|''[[commons:Macropodus opercularis|Macropodus opercularis]]'' (Paradise fish)
File:Canthigaster valentini 1.jpg|''[[commons:Canthigaster valentini|Canthigaster valentini]]'' (Valentinni's sharpnose puffer)
File:Flughahn.jpg|[[File:POTY ribbon 2007.svg|25px]] ''[[commons:Dactylopterus volitans|Dactylopterus volitans]]'' (Flying gurnard)
File:Fishmarket 01.jpg|''[[commons:Semicossyphus pulcher|Semicossyphus pulcher]]'' (California Sheephead)
File:Pseudorasbora parva(edited version).jpg|''[[commons:Category:Pseudorasbora parva|Pseudorasbora parva]]'' (Topmouth gudgeon)
File:MC Rotfeuerfisch.jpg|''[[commons:Category:Pterois antennata|Pterois antennata]]'' (Antennata Lionfish)
File:Cleaning station konan.jpg|''[[commons:Novaculichthys taeniourus|Novaculichthys taeniourus]]''
File:Synchiropus splendidus 2 Luc Viatour.jpg|''[[commons:Synchiropus splendidus|Synchiropus splendidus]]'' (Mandarin fish)
File:Psetta maxima Luc Viatour.jpg|''[[commons:Psetta maxima|Psetta maxima]]'' (Turbot)
File:Australian blenny.jpg|''[[commons:Category:Ecsenius|Ecsenius axelrodi]]''
</gallery>
Ergibt (Modus: packed-hover
):
-
Astronotus ocellatus (Oscar)
-
Salmo salar (Salmon Larva)
-
Epinephelus lanceolatus (Giant grouper)
-
Pterois volitans (Red Lionfish)
-
Macropodus opercularis (Paradise fish)
-
Canthigaster valentini (Valentinni's sharpnose puffer)
-
Dactylopterus volitans (Flying gurnard)
-
Semicossyphus pulcher (California Sheephead)
-
Pseudorasbora parva (Topmouth gudgeon)
-
Pterois antennata (Antennata Lionfish)
-
Synchiropus splendidus (Mandarin fish)
-
Psetta maxima (Turbot)
Beispiele für die anderen Modi:
mode="traditional"
-
Astronotus ocellatus (Oscar)
-
Salmo salar (Salmon Larva)
-
Epinephelus lanceolatus (Giant grouper)
mode="nolines"
-
Astronotus ocellatus (Oscar)
-
Salmo salar (Salmon Larva)
-
Epinephelus lanceolatus (Giant grouper)
mode="packed"
-
Astronotus ocellatus (Oscar)
-
Salmo salar (Salmon Larva)
-
Epinephelus lanceolatus (Giant grouper)
mode="packed-overlay"
mode="packed-hover"
-
Astronotus ocellatus (Oscar)
-
Salmo salar (Salmon Larva)
-
Epinephelus lanceolatus (Giant grouper)
MediaWiki Version: | ≥ 1.28 |
mode="slideshow"
Optionale Galerieattribute
Das Galerie-Tag selbst akzeptiert mehrere zusätzliche Parameter, die als attribute name-value pairs angegeben werden:
<gallery {parameters}>
{images}
</gallery>
caption="{caption}"
: (Beschriftungstext zwischen Anführungszeichen für mehr als ein Wort) legt eine Beschriftung fest, die über der Galerie zentriert wird. In der Beschriftung darf nur einfacher Text verwendet werden. Formatierungen, Vorlagen und ähnliches funktionieren nicht.widths={width}px
: Legt die (maximale) Breite der Bilder fest. Der Standardwert ist 120px. (Es hat keinen Effekt, wenn der Modus auf einen der folgenden gesetzt ist: packed, packed-overlay, packed-hover, slideshow.) Beachte den Plural: widths.heights={heights}px
: Legt die (maximale) Höhe der Bilder fest. Der Standardwert ist 120px. (Es hat keinen Effekt, wenn der Modus auf slideshow gesetzt ist.)perrow={integer}
: bestimmt die Anzahl der Bilder pro Reihe. (Es hat keinen Effekt, wenn der Modus auf einen der folgenden gesetzt ist: packed, packed-overlay, packed-hover, slideshow.) 0 bedeutet, dass die Einstellung automatisch an die Bildschirmbreite angepasst wird.showfilename={anything}
: Zeigt die Dateinamen der Bilder in den einzelnen Bildunterschriften für jedes Bild an (1.17+).mode={traditional|nolines|packed|packed-hover|packed-overlay|slideshow}
: Siehe oben (1.22+; 1.28+ für "slideshow").showthumbnails
: Zeigt im "Diashow" -Modus standardmäßig den Streifen mit den Miniaturbildern unter der Diashow an (1.29+).- Jedes html-Attribut, das bei einem
<ul>
-Tag erlaubt ist (z.B.id
,title
,class
)
- Beispiel 1
Syntax:
<gallery widths=300 heights=200>
File:Example.jpg|Lorem ipsum
File:Example.jpg|Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
</gallery>
Ergebnis:
-
Lorem ipsum
-
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
- Beispiel 2
Syntax:
<gallery widths=60 heights=60 perrow=7 caption="sunflowers are groovy">
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
</gallery>
Ergebnis:
Reihe von Bildern, die auf die Browserbreite angepasst wird
Eine Möglichkeit, die für eine Reihe von Bildern mit unterschiedlichen Breiten funktioniert, besteht darin, nicht "Vorschaubilder" oder "Seitenangabe links" oder "keine" zu verwenden. Wenn "mini" nicht verwendet wird (und somit keine Bildunterschriften), wird eine Reihe von Bildern auf die Breite des Browsers angepasst. Wenn nötig, verkleinere das Browserfenster, damit Du siehst, wie die Bilder in die nächste Zeile umgebrochen werden.
[[File:Example.jpg|220px]] [[File:Example.jpg|100px]] [[File:Example.jpg|150px]] [[File:Example.jpg|250px]] [[File:Example.jpg|200px]] [[File:Example.jpg|50px]] [[File:Example.jpg|220px]] [[File:Example.jpg|175px]]
Um Bilder unterschiedlicher Breite mit Beschriftungen zu versehen, ist es erforderlich, div HTML für eine ungeordnete Liste zu verwenden. Zusammen mit style="display: inline-block;"
. Weitere Informationen und Anregungen findest Du unter: Geben Sie Floats den Flick in CSS-Layouts.
<div><ul>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>
Um den oberen Rand von Bildern auszurichten, den Befehl vertical-align hinzufügen
<div><ul>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>
Einige Wikis verfügen nicht über alle Galerieoptionen (z. B. "widths"). Manchmal möchte man auch unterschiedliche Breiten für Bilder in einer Reihe. Außerhalb einer Galerie oder des div-HTML-Codes ist es nicht möglich, einzelne Beschriftungen für Bilder in einer Reihe von Bildern zu erstellen, die sich an die Breite des Browsers anpassen. Probiere es aus und schaue es Dir an. Sonst funktioniert Wikitext nicht richtig. Die Bilder überlappen sich entweder rechts oder erzwingen eine horizontale Bildlaufleiste.
Die Verwendung einer linken Floats ("left") für einige Bilder, kombiniert mit "none" für einige der Bilder, funktioniert ebenfalls nicht konsistent, insbesondere wenn es auch eine rechte Seitenleiste von Bildern gibt. Es werden seltsame Dinge passieren. Bei schmaleren Browser- oder Bildschirmbreiten wird möglicherweise ein Bild aus der Zeile ganz unten auf der Seite nach dem Ende der rechten Bildseitenleiste angezeigt.
Verhalten von Links
Standardmäßig verlinkt ein Bild auf seine Dateibeschreibungsseite. Die Option "link=" ändert dieses Verhalten, um eine Verknüpfung zu einer anderen Seite oder Website herzustellen oder das Verknüpfungsverhalten des Bildes zu deaktivieren.
Alternativ kannst Du einen Textlink zu einer Dateibeschreibungsseite oder zur Datei selbst erstellen. Siehe Help:Linking to files .
Bild anzeigen, auf eine andere Seite oder Website verlinken
Verwende die Option "link=", um ein Bild mit einer anderen Seite oder Website zu verknüpfen:
Wenn Du auf das folgende Bild klickst, gelangst Du nach MediaWiki:
[[File:MediaWiki-2020-logo.svg|50px|link=MediaWiki]]
Wenn Du auf das Bild unten klickst, gelangst Du nach example.com:
[[File:MediaWiki-2020-logo.svg|50px|link=http://example.com]]
Bild anzeigen, Verlinkung deaktivieren
Verwende die Option "link=" ohne zugewiesenen Wert, um den Link vollständig zu deaktivieren. Das folgende Bild ist kein Link:
[[File:MediaWiki-2020-logo.svg|50px|link=]]
Link zu einem Bild
Füge dem zu erstellenden Link :
als Präfix hinzu.
[[:File:MediaWiki-2020-logo.svg]]
[[:File:MediaWiki-2020-logo.svg|Wiki]]
Direkter Link zu einem Bild
Die Beispiele oben verweisen auf die Seite mit der Bildbeschreibung.
Um direkt auf ein Bild zu verlinken, kann auf MediaWiki-Seiten der Pseudo-Namensraum Media:
verwendet werden:
[[Media:MediaWiki-2020-logo.svg]]
Direkte Links von externen Web-Sites
Eine andere Möglichkeit ist die Verwendung der Seite Special:Redirect/file (oder deren Alias Special:Filepath). Im Gegensatz zum oberen Beispiel kann sowohl von externen Websites als auch von MediaWiki-Seiten darauf verlinkt werden.
[[Special:Redirect/file/Wikipedia.png]]
Die Parameter height
und width
können auch hinzugefügt werden, um eine bestimmte Größe des Bildes anzugeben.
Das Bildseitenverhältnis bleibt immer erhalten.
https://www.mediawiki.org/w/index.php?title=Special:Redirect/file/Wikipedia.png&width=100&height=100
Abrufen der vollständigen URL eines Bildes
Um den vollständigen Pfad eines Bildes zu erhalten (ohne Weiterleitungen zu durchlaufen, wie oben gezeigt), können einige Magische Wörter verwendet werden.
{{filepath:MediaWiki-2020-logo.svg}}
Wird zu:
- //upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg
Falls dies aus einer Vorlage verwendet wird, in der der Namensraum Datei:
entfernt werden muss, kann {{PAGENAME}}
dies tun:
{{filepath:{{PAGENAME:File:MediaWiki-2020-logo.svg}}}}
Wird zu:
- //upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg
Dateien anderer Webseiten
Du kannst mit derselben Syntax, die für das Verknüpfen mit einer externen Webseite verwendet wird, auf eine online verfügbare externe Datei verweisen. Mit diesen Syntaxen wird das Bild nicht gerendert, sondern nur der Text des Links zu diesem Bild angezeigt.
[http://url.for/some/image.png]
Oder mit einem anderen angezeigten Text:
[http://url.for/some/image.png verlinke den Text hier]
Zusätzliches MediaWiki-Markup oder HTML / CSS-Formatierung (für Inline-Elemente) ist in diesem angezeigten Text zulässig (mit Ausnahme eingebetteter Links, die den umgebenden Link beschädigen würden):
[http://www.example.com/some/image.png Beispiel '''<del>rich</del>''' ''<ins>link-text</ins>'' hier.]
was wiedergegeben wird als: Beispiel rich link-text hier.
Wenn es in Deinem Wiki aktiviert ist (siehe Handbuch:$wgAllowExternalImages ), kannst Du auch externe Bilder einbetten. Füge dazu einfach die URL des Bildes ein:
http://url.for/some/image.png
Derzeit können eingebettete Bilder nicht in der Größe verändert werden, sie können jedoch durch umgebendes MediaWiki-Markup oder HTML/CSS-Code formatiert werden.
Wenn diese Wiki-Option nicht aktiviert ist, wird das Bild nicht eingebettet, sondern wie oben als Textlink zur externen Site angezeigt.
Es ist auch möglich, InstantCommons (Standardeinstellung) oder andere Datei-Sammlungen zu verwenden, um Dateien aus Schwesterprojekten zu laden, die dann wie lokale Dateien behandelt werden.