Benutzer:Vlado/Sauberes Markup
Angelehnt an das erfolgreiche Projekt en:Wikipedia:WikiProject_Wiki_Syntax in der englischen Wikipedia soll auch das Markup der deutschen Wikipedia bereinigt werden.
Motivation
Die Fehlerlisten sind Nebenprodukt des Konverters WikiPress Publisher (WPP), mit dem die Wikimarkup-Daten für die Wikipedia-DVD und die WikiPress-Bände nach XML konvertiert werden. WPP bringt seinen eigenen alternativen Parser mit, d.h. der Parser basiert nicht auf der MediaWiki-Software.
In MediaWiki selbst ist jede Eingabe gültig, und mag sie noch so unsinnig sein - es gibt keine Syntaxfehler. Alternative Parser stehen vor dem Problem, den MediaWiki-Parser in möglichst vielen Verästelungen nachbilden zu müssen, d.h. genauso fehlertolerant zu sein und dabei möglichst den gleichen Output zu produzieren.
Die Komplexität alternativer Parser kann erheblich reduziert werden, wenn man davon ausgeht, dass das vorgefundene Wikimarkup in den meisten Fällen vernünftig ist: Geöffnete Elemente werden auch wieder geschlossen, Überschriftenebenen sind regulär, usw.
Neben diesen Fällen werden aber auch Listen von eindeutigen Fehlern erzeugt, wo selbst der MediaWiki-Output nicht erwünscht ist: Linkfehler, fehlende Vorlagen, fehlende Parameter, usw.
Mithelfen
- Wähle aus den Listen weiter unten eine Unterseite aus, die noch nicht durchgestrichen wurde.
- Such dir auf der Unterseite möglichst zufällig einen Block bestehend aus 5 Artikeln aus.
- Behebe nach Möglichkeit die Probleme der 5 Artikel und lösche dann den Block.
- Prüfe stets das Ergebnis nach dem Speichern visuell - es sollen weniger statt mehr Fehler werden!
- Bei Unklarheiten kommentiere das Problem im Block und lass ihn stehen, vielleicht hat ein anderer eine Idee.
- Die Prozentangabe bei jeder Stelle sagt in etwa, wo der Fehler im Quelltext ist.
- Schreibe
[[Benutzer:Vlado/Sauberes Markup|Sauberes Markup]]in die Kommentarzeile, was dann in der Historie als Link auf diese Seite erscheint.
- Wenn die Unterseite leer ist, streiche die Unterseite weiter unten durch. Wenn noch einzelne Problemstellen geblieben sind, evtl. mit Kommentaren, streiche die Unterseite durch und füge ein Sternchen * hinten an.
Noch zu tun
- Listengenerator: Die Prozenzangabe bei jeder Stelle stimmt nicht immer.
- Listengenerator: Einige Edit-Links funktionieren nicht.
- Tipps und Tricks, Fallbeispiele unten ergänzen, von en:Wikipedia:WikiProject_Wiki_Syntax lernen
Fehlerlisten
Die Fehlerlisten basieren auf dem Dump vom 2. Oktober 2005. Alle Korrekturen, die bis zum 19. Oktober 2005 vorgenommen werden, kommen auch der Wikipedia-DVD Herbst 2005 zu gute.
Für den Anfang wurden noch nicht alle Unterseiten gepostet, dies wird bei Bedarf und Erfolg der Aktion nachgeholt.
Inkonsistentes Inhaltsverzeichnis
Der Fehler wird gemeldet, wenn Unterüberschriften sich laut Markup nicht genau eine Ebene unterhalb des übergeordneten befinden.
- ...== Leben == ==== Jugend ====... wird dann zu ...== Leben == === Jugend ===...
Ungültige Überschrift
MediaWiki ist ziemlich tolerant, doch sollte eine Überschrift so aufgebaut sein, dass sie auf einer Zeile mit gleich vielen Gleichheitszeichen = beginnt endet.
00000
00100
00200
00300
00400
00500
00600
Parameter nicht gefunden
Drei geschweifte Klammern {{{ leiten einen Parameter für eine Vorlage ein. Stellt der Aufrufer der Vorlage den Parameter nicht zur Verfügung, wird dieser Fehler generiert.
Vorlage nicht gefunden
Zwei geschweifte Klammern {{ leiten einen Vorlagenaufruf ein. Wenn die Vorlage nicht gefundet wird, schreibt MediaWiki den Ausdruck hin, als ob es sich nicht um einen Vorlagenaufruf handelen würde.
- ...{{Geokoordiante|... wird dann zu ...{{Geokoordinate|...
- aber: ...zwei Klammern {{ bedeuten ... wird dann zu ...zwei Klammern <nowiki>{{</nowiki> bedeuten...
Kommentar nicht geschlossen
...<!--... muss mit :...-->... wieder geschlossen werden. <!--> kein gültiges Markup!
Linkfehler
Die Klassiker. Da auch Bots unterwegs sind, die manches prüfen, kann es sein, dass einige Fehler schon behoben sind.
00000
00100
00200
00300
00400
00500
00600
Klammern bei Parameter nicht geschlossen
Der Fehler erscheint, wenn drei geschweifte Klammern {{{ rekursiv bis zum Ende der Seite nicht wieder geschlossen werden.
Klammern bei Vorlage nicht geschlossen
Der Fehler erscheint, wenn zwei geschweifte Klammern {{ rekursiv bis zum Ende der Seite nicht wieder geschlossen werden.
Tabelle im Wikimarkup nicht geschlossen
Eine Tabelle im Wikimarkup ...{|... muss stets mit ...|}... geschlossen werden.
Leeres Element
Findet z.B. unsinnige ...<math></math>....
Ungültiger Tag
Diese Tags haben typischerweise syntaktisch ungültige Parameter, oft in Verbindung mit falschem Verständnis des style=".."-Paramters entstanden.
In anderen Fällen ist eine öffnende spitze Klammer nicht als < kodiert bzw. nicht von <nowiki> umschlossen.
Eine Besonderheit sind Stellen wie tr align="right" bgcolor="#ffffff" |. Intern wandelt der Parser die Piped-Syntax der Tabelle in HTML um und findet dann <tr align="right" bgcolor="#ffffff" |> vor, d.h. die falsch platzierte Pipe "|" am Ende der Zeile wird mit in den Tag übernommen. In diesem Fall muss sie im Quelltext gelöscht werden.
Tipps für ASCII-Pfeile:
- Ersetze --> und ---> durch → sieht so aus: →
- Ersetze <-- durch ← sieht so aus: ←
- Innerhalb von <math> ersetze <-- und --> mit \leftarrow beziehungsweise \rightarrow.
- Ersetze |--> durch: <math>\mapsto</math>; sieht so aus:
- Ersetze <---> durch <math>\leftrightarrow</math>; sieht so aus:
- Ersetze <---> durch ↔; sieht so aus: ↔
- Wenn nichts davon zutrifft, ersetze < durch <
00000 00100 00200 00300 00400 00500 00600 00700 00800 00900 01000 01100 01200 01300 01400 01500 01600 01700 01800 01900 02000 02100 02200 02300 02400 02500 02600 02700 02800 02900 03000 03100 03200 03300
Tag zweimal geöffnet
Der Fehler tritt meist auf, wenn der gleiche Tag vorher nicht geschlossen wurde. Dieser muss gefunden und an geeigneter Stelle geschlossen werden.
- ...<small>0</td><td><small>1</td>... wird dann zu ...<small>0</small></td><td><small>1</small></td>...
Manchmal wollte der Autor den Tag schließen und hat ihn aus Versehen zweimal geöffnet.
- ...<small>0<small>... wird dann zu ...<small>0</small>...
00000
00100
00200
00300
00400
00500
00600
00700
00800
00900
01000
01100
01200
01300
01400
01500
01600
01700
01800
Tag geschlossen aber nicht geöffnet
Typischerweise wird <sub> und <sup> verwechselt.
00000
00100*
00200
00300
00400
Tag nicht geschlossen
An bestimmten Stellen, z.B. vor Überschriften schließt MediaWiki automatisch alle Tags. Sauberer und nachvollziehbarer ist es, wenn diese Tags explizit geschlossen werden.
Unerwünschter Tag
Dieser Punkt ist möglicherweise umstritten. Obwohl HTML-Listenelemente erlaubt sind, sind Wiki-Listen im Wikimarkup viel besser zu lesen und weniger fehleranfällig. Deshalb sollten Konstruktionen mit <ul>, <ol> und <li> vermieden werden. Siehe aber auch die Diskussion dazu.
Fett nicht geschlossen
Drei Anführungszeichen ...'''... müssen wieder mit ...'''... geschlossen werden. MediaWiki schließt diese an manchen Stellen (zwei Leerzeilen, Listenpunkte, Überschriften, ...) automatisch, so dass der Fehler nicht immer sichtbar ist.
00000
00100
00200
00300*
00400
00500
00600
00700
00800
00900
01000
01100
01200
01300
01400
01500
Kursiv nicht geschlossen
Zwei Anführungszeichen ...''... müssen wieder mit ...''... geschlossen werden. MediaWiki schließt diese an manchen Stellen (zwei Leerzeilen, Listenpunkte, Überschriften, ...) automatisch, so dass der Fehler nicht immer sichtbar ist.
Desweiteren passiert Magie an folgender Stelle: ... auf dem Album ''Rolin''' des australischen DJs ... ergibt gerendert ... auf dem Album Rolin' des australischen DJs ... Das hat der Autor auch so gewollt (ohne groß darüber nachzudenken), für einen Parser sieht die Sache aber so aus: Erst wird kursiv geöffnet, dann kommt ein Wort, dann wird fett geöffnet (!) und am Ende der Zeile wundert er sich, warum beides immer noch offen ist. Die Zeile sieht dann so aus: ... auf dem Album Rolin des australischen DJs ... Damit auch alternative Parser ohne Magie Wikimarkup parsen können, muss er wohlgeformt sein sein. Die Lösung ist, den Apostroph ' am Ende des Wortes als <nowiki>'</nowiki> zu schreiben, oder den typografischen Apostroph ’ zu verwenden (ALT+0146).
00000
00100
00200
00300
00400
00500
00600
00700
00800
00900
01000
01100
01200
01300
01400
01500
01600
01700
01800
01900
02000
02100
02200
02300
02400
02500
02600
02700
02800
02900
03000
03100
03200
03300
03400
03500
03600
03700
03800
03900
04000
04100
04200
04300
04400
04500
04600
04700
04800
04900
05000
05100
05200
05300
05400
05500
05600
05700
05800
05900
Ich mache mit!
Ich weiß, dass Spaß etwas anderes ist, aber ich mache mit: Vlado, Mathias Schindler, jed, dbenzhuser, Michael, Qbi , Jensw, Avatar, Gnu1742, rdb?, Robot Monk, HaSee, Baikonur, Carl Steinbeißer, darina (wenn sie Zeit hat...), jpp, Trainspotter