WikiText Multimedia
1. Bilder und Screenshots einfügen
Bilder und Screenshots können in Wiki-Seiten eingefügt werden. Das ist besonders nützlich für Anleitungen, Fehlermeldungen und Oberflächen-Erklärungen.
Wichtig: Screenshots sollten nur verwendet werden, wenn sie wirklich helfen. Ein Screenshot ersetzt keine schriftliche Erklärung.
1.1 Bild oder Screenshot hochladen
Bilder müssen zuerst ins Wiki hochgeladen werden.
Typischer Ablauf:
- Im Wiki auf „Datei hochladen“ gehen.
- Datei auswählen.
- Einen sinnvollen Dateinamen verwenden.
- Eine kurze Beschreibung eintragen.
- Datei hochladen.
Die Upload-Seite heißt:
Spezial:Hochladen
Gute Dateinamen:
VPN-Client-Loginfenster.png Fehlermeldung-RDP-Verbindung.png Benutzerkonto-Anlegen-Schritt-1.png
Schlechte Dateinamen:
Screenshot.png Bild1.png Unbenannt.png image.png
1.2 Bild einfach einfügen
Ein Bild wird so eingefügt:
[[Datei:VPN-Client-Loginfenster.png]]
1.3 Bild mit Vorschau und Beschreibung einfügen
Für Dokumentation ist diese Schreibweise meistens am besten:
[[Datei:VPN-Client-Loginfenster.png|mini|VPN-Client mit markiertem Loginfenster]]
Das zeigt das Bild als kleine Vorschau mit Beschreibung.
1.4 Bildgröße festlegen
Man kann die Breite des Bildes festlegen:
[[Datei:TestKatze.jpg|200px|TestKatze]]
Mit Vorschau:
[[Datei:TestKatze.jpg|mini|400px|VPN-Client mit Loginfenster]]
Für interne Dokumentation sind oft 400px bis 800px sinnvoll.
Beispiele:
[[Datei:Fehlermeldung-RDP-Verbindung.png|mini|400px|Fehlermeldung bei fehlgeschlagener RDP-Verbindung]] [[Datei:Benutzerkonto-Anlegen-Schritt-1.png|mini|700px|Maske zum Anlegen eines neuen Benutzerkontos]]
1.5 Bild links, rechts oder zentriert anzeigen
Rechts ausgerichtet:
[[Datei:VPN-Client-Loginfenster.png|mini|rechts|VPN-Client mit Loginfenster]]
Links ausgerichtet:
[[Datei:VPN-Client-Loginfenster.png|mini|links|VPN-Client mit Loginfenster]]
Zentriert:
[[Datei:VPN-Client-Loginfenster.png|mini|zentriert|VPN-Client mit Loginfenster]]
In vielen Wikis funktionieren auch die englischen Begriffe:
right left center
Beispiel:
[[Datei:VPN-Client-Loginfenster.png|mini|right|VPN-Client mit Loginfenster]]
1.6 Nur auf eine Datei verlinken
Manchmal soll ein Bild nicht direkt angezeigt werden, sondern nur als Link erscheinen.
Dafür setzt man einen Doppelpunkt vor Datei::
[[:Datei:VPN-Client-Loginfenster.png]]
Mit sichtbarem Linktext:
[[:Datei:VPN-Client-Loginfenster.png|Screenshot des VPN-Loginfensters öffnen]]
Ohne Doppelpunkt wird die Datei normalerweise eingebettet. Mit Doppelpunkt wird nur darauf verlinkt.
1.7 Mehrere Screenshots in einer Anleitung
Bei Schritt-für-Schritt-Anleitungen sollte jeder Screenshot direkt beim passenden Schritt stehen.
Beispiel:
# VPN-Client öffnen. # Auf „Neue Verbindung“ klicken. [[Datei:VPN-Neue-Verbindung.png|mini|600px|Schaltfläche „Neue Verbindung“ im VPN-Client]] # Serveradresse eintragen. # Mit Benutzerkonto anmelden. [[Datei:VPN-Anmeldung.png|mini|600px|Anmeldemaske des VPN-Clients]]
Noch besser ist oft: Erst der Schritt, dann der Screenshot, dann ein kurzer Hinweis.
# Öffne den VPN-Client. # Klicke auf „Neue Verbindung“. [[Datei:VPN-Neue-Verbindung.png|mini|600px|Die Schaltfläche „Neue Verbindung“ befindet sich oben rechts.]] # Trage die Serveradresse ein.
1.8 Gute Regeln für Screenshots
- Verwende Screenshots nur, wenn sie den Text wirklich verständlicher machen.
- Entferne oder schwärze personenbezogene Daten, Kundendaten, IP-Adressen, Tokens und Passwörter.
- Benenne Dateien eindeutig.
- Schreibe eine kurze Bildbeschreibung.
- Zeige nur den relevanten Ausschnitt, nicht den ganzen Bildschirm.
- Vermeide Screenshots von Dingen, die sich häufig ändern.
- Aktualisiere Screenshots, wenn sich die Oberfläche stark geändert hat.
1.9 Häufige Fehler bei Bildern
Falsch:
[[Datei:Screenshot.png]]
Problem: Der Dateiname ist nicht aussagekräftig.
Besser:
[[Datei:VPN-Client-Loginfenster.png|mini|600px|Loginfenster des VPN-Clients]]
Falsch:
[[Datei:Fehler.png]]
Besser:
[[Datei:RDP-Fehlermeldung-Zeitueberschreitung.png|mini|500px|Fehlermeldung bei Zeitüberschreitung der RDP-Verbindung]]
Falsch:
Hier sieht man alles: [[Datei:Ganzer-Bildschirm.png]]
Besser:
Der relevante Fehler wird im unteren Bereich des Dialogfensters angezeigt: [[Datei:RDP-Fehlerdialog.png|mini|500px|Fehlerdialog bei fehlgeschlagener RDP-Verbindung]]