Hilfe:Wikisyntax/Validierung
Die Linter-Erweiterung erkennt Wikitext-Muster, die problematisch sind und korrigiert oder entfernt werden sollten. Diese Seite zur Validierung gibt einen Überblick über die derzeit durch das Lintwerkzeug erkannten Muster und erklärt, welche Probleme auftreten können oder wie die Anpassung erfolgen sollte.
Diese Funktion dient dazu sicherzustellen, dass Seiteninhalte langfristig wie beabsichtigt gerendert und wiedergegeben werden (beispielsweise durch Software wie RemexHTML oder Parsoid).
Die Spezialseite Lint-Fehler gruppiert die Probleme nach Typen.
Das Angebot dieser Mitte 2017 eingeführten Erweiterung ist als Work In Progress eingestuft und derzeit (Stand Juni 2017) noch in der Entwicklungsphase.
Hinweise zur Korrektur
BearbeitenNamensräume und relevante Projektseiten
BearbeitenNur relevante Seiten sind zu bearbeiten. Das sind:
- Artikel (
namespace=0
) - Aktuelle Projekt- und Portalseiten.
- Nur vom jeweiligen Benutzer werden Benutzerseiten korrigiert.
Nicht bearbeitet werden:
- Archivierte Seiten.
- Diskussionsseiten bzw. analoge Plattformen.
Falsche Fehler
BearbeitenDie in den einzelnen Linter-Kategorien gelisteten Seiten können eventuell auch sogenannte „false-positives“ enthalten, also Seiten, auf denen irrtümlich Probleme erkannt wurden.
Nach der Freischaltung hatten sich eine Reihe praktischer Schwierigkeiten ergeben.
Beschreibung der Liste
BearbeitenSeitentitel | Lint-Fehler je nach Liste | Durch eine Vorlage? |
Lemma (bearbeiten | Versionsgeschichte) | BODY > SMALL |
Vorlage:Vorlagename |
Lemma (bearbeiten | Versionsgeschichte) | s |
--- |
Lemma (bearbeiten | Versionsgeschichte) | small |
Ausgabe nicht von einer einzelnen Vorlage |
Lemma
ist der Name der Seite, die einen Fehler enthält. Klickt man in der angezeigten Liste aufbearbeiten
so wird man in der Quelltextbearbeitung der Seite direkt zur fehlerbehafteten Zeile weitergeleitet, sofern dies dort lokalisierbar ist.- Der Klick auf
Versionsgeschichte
zeigt den Verlauf der Versionen der Seite an. - Falls möglich wird in der mittleren Spalte ein Hinweis auf die Art des Fehlers ausgegeben. Beispielsweise der Name des betroffenen Tags oder unbekannten Parameters
- Wurde der Fehler möglicherweise durch eine direkt eingebundene Vorlage ausgelöst, so ist in der rechten Spalte diese Vorlage verlinkt.
- Das Problem könnte in einem an diese Vorlage übergebenen Parameterwert liegen.
- Oder die Kombination dieser Parameterwerte mit der Vorlagenprogrammierung könnte Schwierigkeiten machen.
- Die Programmierung der Vorlage kann generell ungeschickt sein.
Die Listen können zur Abfrage auf einzelne Namensräume eingestellt werden, die Auswahl erfolgt über ein Dropdownmenü. Anschließend auf die Schaltfläche klicken, um die Liste zu aktualisieren. Ober- und unterhalb der Liste sind Schaltflächen, mit denen vor und zurück geblättert werden kann.
Quelltextexpansion
BearbeitenWenn eine Vorlage beteiligt ist, lässt sich aus dem Quelltext der dargestellten Seite nicht entnehmen, wie der resultierende Wikitext schließlich aussieht.
Es gibt zwei Möglichkeiten, sich den analysierten Text anzusehen, um die Fehlerwirkung zu verstehen:
- Über die Spezialseite Vorlagen expandieren
- Der verdächtige Quelltext wird in das Eingabefeld kopiert.
- Auf die Schaltfläche klicken.
- Im Feld „Ergebnis“ erscheint der ausgewertete Wikitext.
- Über die Wikipedia:Spielwiese:
{{#tag:syntaxhighlight|{{:
Seitenname}}}}
als Quelltext angeben.- Seitenvorschau ansehen.
- Der ausgewertete Wikitext von Seitenname erscheint.
Problemtypen
BearbeitenEs folgt die Beschreibung der einzelnen Abfragen; ggf. mit einem Codebeispiel.
Tabellen-Tag, das gelöscht werden soll
BearbeitenDiese Seiten haben Tabellen-Tags, die gelöscht werden sollen.
- Die Anpassung sollte wegen möglicher Darstellungsfehler umgehend erfolgen.
- Lint-Fehler: Tabellen-Tag (in Artikeln).
- Informationen bei MediaWiki (englisch).
- Vorlage:Phabricator
Beispiel (Anmerkungen farblich hervorgehoben):
vorgefundene Syntax |
---|
{| ← <Start-tag Tabelle>
| Zellentext1
|-
{| ← <Start-tag Tabelle 2 ="unnötige Verschachtelung entfernen">
|- ← <Trenner Tabelle 2>
| Zellentext2
|} ← <End-tag Tabelle 2 ="unnötige Verschachtelung entfernen">
|} ← <End-tag Tabelle>
|
bereinigte Syntax |
{| ← <Start-tag Tabelle>
|-
| Zellentext1
|-
| Zellentext2
|} ← <End-tag Tabelle>
|
Info: Einzelnstehende schließende Tabellentags |}
können im Seitenquelltext durch Vorlageneinbindungen entstehen, die oberhalb nicht sichtbar ein öffnendes Tabellentag {|
einbinden. Es ist immer zu prüfen, ob die Syntax tatsächlich überflüssig ist.
Workaround für einen Absatzumbruchfehler
BearbeitenDiese Seiten haben einen Absatzumbruchfehler, der umgangen werden könnte. Es geht um die Formatierung mit den Zeilenumbruch verhindernde nowrap
-Konstrukte.
- Die Anpassung sollte wegen möglicher Darstellungsfehler bald erfolgen.
- Lint-Fehler: Absatzumbruch (in Artikeln).
- Informationen bei MediaWiki (englisch).
- Vorlage:Phabricator
Drei Ursachen sind möglich:
- Die ohne Zeilenumbruch darzustellende Textpassage enthält bereits selbst einen Zeilenumbruch.
- Zeilenumbruch ais dem Text entfernen.
- Ein Element
<span style="white-space:nowrap">
enthält ein Block-Element.- Ggf. den Zeilenumbruch innerhalb des Block-Elements verhindern.
- Eine Tabellenzelle beginnt mit der fraglichen Textpassage oder besteht nur daraus.
- Gesamte Tabellenzelle mit
style="white-space:nowrap"
deklarieren. - Ggf.
<nowiki />
voranstellen.
- Gesamte Tabellenzelle mit
Die Vorlage:nowrap kann ebenfalls am Problem beteiligt sein.
Selbstschließendes Tag
BearbeitenDiese Seiten enthalten selbstschließende Tags. Tags, die beispielsweise der Formatierung dienen werden wie Klammern um den jeweiligen Abschnitt gelegt. Sie bestehen aus einem öffnenden und einem schließenden Tagelement <tag>…</tag>
. Sie dürfen nicht wie ein unary-Tag selbstschließend verwendet werden.
- Die Anpassung sollte wegen möglicher Darstellungsfehler umgehend erfolgen.
- Lint-Fehler: Selbstschließend (in Artikeln).
- Informationen bei MediaWiki (englisch).
- Vorlage:Phabricator
Beispiele:
vorgefundene Syntax |
---|
<b>Inhalt<b/>
<span>Inhalt<span/>
</div/>
<div style="clear:both;" />
<s>Inhalt<s/>
|
bereinigte Syntax |
'''Inhalt'''
<span>Inhalt</span> oder </span>
</div>
<div style="clear:both;"></div>
<s>Inhalt</s>
|
Fehlerhafte Dateioption
BearbeitenDiese Seiten haben Dateien mit fehlerhaften Optionen. So können beispielsweise Bildparameter doppelt, falsch benannt, unbekannt oder ein Pipe-Symbol |
zu viel vorhanden sein.
- Erkannte Darstellungsfehler sollten behoben werden.
- Lint-Fehler: Nicht erkannte Dateioptionen (in Artikeln).
- Informationen bei MediaWiki (englisch).
- Bekannte „falsche Fehler“; ignorieren:
baseline bottom middle sub super text-bottom text-top top
thumbtime
noicon
hochkant
-Variante mit Leerzeichen statt Gleichheitszeichen
Beispiele:
vorgefundene Syntax |
---|
[[Datei:Yellow card.svg|mini||Gelbe Karte]] ← Pipe-Symbol doppelt
[[Datei:Yellow card.svg|mini|mini|Gelbe Karte]] ← mini doppelt
[[Datei:Yellow card.svg|thumb|mini|Gelbe Karte]] ← thumb = mini
[[Datei:Yellow card.svg|mini|linkss|Gelbe Karte]] ← linkss „s“ doppelt
[[Datei:Yellow card.svg|mini|links|rechts|Gelbe Karte]] ← „links“ und „rechts“ widersprechen sich.
[[Datei:Yellow card.svg|mini|rahmenlos|Gelbe Karte]] ← „mini“ und „rahmenlos“ widersprechen sich.
[[Datei:Yellow card.svg|mini|links|hochkant|0,6|Gelbe Karte]] ← Parameter hochkant falsch
|
bereinigte Syntax |
[[Datei:Yellow card.svg|mini|Gelbe Karte]]
[[Datei:Yellow card.svg|mini|links|Gelbe Karte]]
[[Datei:Yellow card.svg|rahmenlos|Gelbe Karte]]
[[Datei:Yellow card.svg|mini|links|hochkant=0.6|Gelbe Karte]]
|
Falsch verschachtelter Inhalt
BearbeitenDiese Seiten haben falsch verschachtelte Inhalte.
- Erkannte Darstellungsfehler sollten behoben werden.
- Eine doppelt vorhandene Angabe ist hingegen unschädlich.
- Lint-Fehler: Verschachtelter Inhalt (in Artikeln).
- Informationen bei MediaWiki (englisch).
- HTML5 – fostered content (englisch).
- Hilfe:Tabellen – Syntaxbeispiele
Beispiel:
Der Inhalt befindet sich in einem nicht darstellbaren Bereich der Tabellenstruktur und kann so nicht innerhalb der Tabelle ausgegeben werden. In diesem Beispiel stünde der Text oberhalb der Tabelle. Möglicherweise fehlt ein Element für die Überschrift |+
, eine Tabellenzellenzuweisung |
oder die Kopfzeilensyntax !
.
vorgefundene Syntax | Ausgabe | |||
---|---|---|---|---|
{| class="wikitable"
|-
Textfragment
|-
| Zelleninhalt
|-
| Zelleninhalt
|}
|
Textfragment
| |||
bereinigte Syntax | Ausgabe | |||
{| class="wikitable"
|-
| Textfragment
|-
| Zelleninhalt
|-
| Zelleninhalt
|}
|
|
Falsch verschachtelte Tags, die ordnungsgemäß verschachtelt werden sollten.
BearbeitenDiese Seiten haben falsch verschachtelte Tags, die korrigiert werden könnten.
- Erkannte Darstellungsfehler sollten behoben werden.
- Lint-Fehler: Verschachtelte Tags (in Artikeln).
- Informationen bei MediaWiki (englisch).
- HTML5 – misnested tags (englisch).
- Hilfe:Textgestaltung – Formatierungsbeispiele
Beispiele:
vorgefundene Syntax | Ausgabe |
---|---|
''' fett '' Text ''' kursiv ''
* a
* b <small>(Anmerkung)
* c (Anmerkung)</small>
* d
<s>durch und <u>unterstrichen</s></u>
|
fett Text kursiv
|
bereinigte Syntax | Ausgabe |
'''fett''' Text ''kursiv ''
* a
* b <small>(Anmerkung)</small>
* c <small>(Anmerkung)</small>
* d
<s>durch und <u>unterstrichen</u></s>
|
fett Text kursiv
|
Fehlendes End-Tag
BearbeitenDiese Seiten haben fehlende End-Tags.
- Anpassung nach Bedarf, geringe Priorität.
- Lint-Fehler: Fehlendes End-Tag (in Artikeln).
- Informationen bei MediaWiki (englisch).
Beispiel (Anmerkungen farblich hervorgehoben):
vorgefundene Syntax |
---|
<small>Text ← <Info ein ="schließendes Tag fehlt">
<small>Text<small> ← <Info Slash =" / fehlt im schließenden Tag">
|
bereinigte Syntax |
<small>Text</small>
|
Ignoriertes Tag
BearbeitenDiese Seiten haben ignorierte Tags.
- Anpassung nach Bedarf, gerigne Priorität.
- Lint-Fehler: Ignoriert oder unvollständig (in Artikeln).
- Informationen bei MediaWiki (englisch).
Beispiel (Anmerkung farblich hervorgehoben):
vorgefundene Syntax |
---|
Text</small> ← <Info ein ="öffnendes Tag fehlt">
|
bereinigte Syntax |
<small>Text</small>
|
Veraltetes HTML-Tag
BearbeitenDiese Seiten verwenden veraltete HTML-Tags.
- Anpassung nach Bedarf, meist geringe Priorität.
- Lint-Fehler: Tags veraltet (in Artikeln).
- Informationen bei MediaWiki (englisch).
- HTML5 non-conforming-features (englisch)
- Unerwünschtes oder verbotenes HTML – Auflistung unerwünschter oder nicht unterstützter Tags
- Hilfe:Textgestaltung – Formatierungsbeispiele
Beispiele:
Als „obsolet“ oder „veraltet“ eingestufte Tags sind in der Tabelle gelistet.
Tag | Ersatz | im Artikelbestand | Funktion |
---|---|---|---|
<font>…</font> |
<span style="…"> |
immer entfernen oder ersetzten | Schrifteigenschaften zuweisen |
<center>…</center> |
style="text-align:center;" class="centered" class="center" |
möglichst ersetzen | Schrift, Tabellen oder Medien zentriert anordnen siehe Hilfe:Textgestaltung/Zentrieren |
<big>…</big> |
<style="font-size:larger;"> |
ersetzen oder entfernen | Text vergrößern[1] |
<strike>…</strike> |
<s>…</s> |
möglichst entfernen | Text durchstreichen[1] |
<tt>…</tt> |
<code>…</code> <code style="border:0; background:#FFFFFF;">…</code> <syntaxhighlight lang="text">…</syntaxhighlight> |
gelegentlich ersetzen | Einzelne Worte oder einen Textblock in Schreibmaschinenschrift darstellen
|
Weitere Informationen
Bearbeiten3=
, jetzt suffix=
- Spezial:LintErrors – Übersicht über die Spezialseiten, die Lintfehlermeldungen auflisten
- Parsoid/API #Wikitext to lint (englisch)