Quelltext der Seite Benutzer:PerfektesChaos/js/WikiSyntaxTextMod/usage/Syntaxkorrektur

'''[[../../../WikiSyntaxTextMod/]]'''
→ [[../|Benutzung]]
→ Projekt Syntaxkorrektur
{{Überschriftensimulation|1|Text=Projekt Syntaxkorrektur}}

Das [[Wikipedia:WikiProjekt Syntaxkorrektur|Projekt Syntaxkorrektur]] soll vom Skript unterstützt werden.

Wo immer es möglich ist, erfolgt die Berichtigung automatisiert. Dies setzt aber voraus, dass der beabsichtigte Sinn zweifelsfrei erschlossen werden kann. Gerade schwere Syntaxfehler benötigen menschliche Interpretation; ein leeres Wikilink <code><nowiki>[[]]</nowiki></code> etwa kann nicht einfach eliminiert werden; es verweist auf eine beabsichtigte Verlinkung, ein fehlendes oder daneben stehendes Wort. Das Skript ändert oder löscht werksseitig grundsätzlich keine bedeutungstragenden Informationen.


__TOC__

== Zurzeit implementiertes Vorgehen ==

{| class="wikitable" border="1"
|+ Bereinigte Fehlertypen bei <code>Check Wikipedia</code>
|-
! ID !! priority !! Bezeichnung !! Einzelheiten
|-
| 8
|rowspan="10"| high || Überschrift keine eigene Zeile || [[../../flow/corr#headline|benutzerdefiniert]]
|-
| 30 || Bildbeschreibung fehlt ||
* Bild:, File: und Image: in <code>Datei:</code> [[../lang/dewiki|automatisch nebst Bildparametern]]
* Bildunterschrift – [[../replace/link#Bildbeschreibung|Benutzerdefinierten Kommentar]] als ersten Notbehelf
* Skalierung – manuelles Design
|-
| 70 || ISBN mit falscher Länge
|rowspan="2"| [[../../flow/corr#ISBN|auto/Standard]]<br />wenn durch ungeeignete Gliederungszeichen etc. verursacht
|-
| 69 || ISBN mit falscher Syntax
|-
| 46 || Anzahl öffnender eckiger Klammern nicht korrekt
| auto/Standard<br />wenn eine öffnende vorhanden ist und beide schließende Klammern nicht zu weit entfernt sind
|-
| 10 || Anzahl schließender eckiger Klammern nicht korrekt
| auto/Standard<br />wenn eine schließende vorhanden ist und beide öffnende Klammern nicht zu weit entfernt sind
|-
| 32 || Link mit doppeltem senkrechten Strich ||
* [[../../flow/link#Wikilink2Pipes|automatisch entfernt]], wenn unmittelbar folgend
* <code>|A|B|C</code> wird belassen; Klammern könnten gemeint sein
|-
| 80 || Weblink mit Zeilenumbruch&nbsp;<code>\n</code> ||
* [[../../flow/link#WeblinkNewline|automatisch entfernt]], wenn <code>\n</code> der URL unmittelbar folgend
* sonst belassen, da Ende der Linkbeschreibung nicht absehbar; häufig fehlt die schließende Klammer bis zum Ende des Absatzes
|-
| 86 || Weblink mit zwei eckigen Klammern || [[../../flow/link#Weblink2brackets|auto/Standard]]
|-
| 79 || Weblink ohne Beschreibung || [[../replace/link#WeblinkPlain|Benutzerdefiniert: Domain ergänzen als ersten Notbehelf]]
|-
| 57
|rowspan="4"| middle || Überschrift endet mit Doppelpunkt || [[../replace/plain/typogr#udef.headlinecolon|benutzerdefiniert]]
|-
| 44 || Fettdruck in Überschrift || [[../../flow/corr#HeadFat|auto/Standard]]
|-
| 48 || Selbstlink || [[../../flow/link#Wikilink auf sich selbst|auto/Standard]]
|-
| 66 || Bildbeschreibung mit &lt;small> || [[../replace/plain/typogr|&lt;small> in &lt;ref> und für ganze Bildbeschreibungen und Exponenten]]
|-
| 50
|rowspan="18"| low || &amp;ndash; oder &amp;mdash; || [[../../flow/format#Character Entities|auto/Standard]]<br /><div style="font-size:75%; line-height:1.1em;">''(alle Entities werden aufgelöst, wenn nichts dagegen spricht)''</div>
|-
| 63 || &lt;small> in Referenz, sub oder sup || [[../replace/plain/typogr|&lt;small> in &lt;ref> und für ganze Bildbeschreibungen und Exponenten]]
|-
| 26 || &lt;b>……&lt;/b>
|rowspan="2"| [[../../flow/format#udef.markup|benutzerdefiniert]]
|-
| 38 || &lt;i>……&lt;/i>
|-
| 11 || HTML-Zeichen benannt || [[../../flow/format#Character Entities|auto/Standard]]<br /><div style="font-size:75%; line-height:1.1em;">''(alle Entities werden aufgelöst, wenn nichts dagegen spricht)''</div>
|-
|  9 || Kategorie auf neue Zeile
|rowspan="3"| [[../../flow/format#Zeilenumbruch|auto/Standard]]
|-
| 22 || Kategorie mit Leerzeichen
|-
| 18 || Kategoriename kleingeschrieben
|-
| 21 || Category statt Kategorie || [[../lang/dewiki|auto/Standard]]<br /><div style="font-size:75%; line-height:1.1em;">''(Zu befürchten ist aber, dass die Kategorie selbst auch Englisch ist, weil dies aus einem anderen Projekt übernommen wurde.)''</div>
|-
| 76 || Wikilink mit %20 || [[../../flow/link#URL als Wikilink|auto/Standard]]<br /><div style="font-size:75%; line-height:1.1em;">''(alle %-Encodings werden aufgelöst, wenn nichts dagegen spricht)''</div>
|-
| 64 || Linkziel ist gleich dem Linktext || [[../../flow/link#Wikilink vereinfachen|auto/Standard]]
|-
|  6 || SORTIERUNG mit Sonderzeichen || [[../../flow/corr#Sortierschlüssel|auto/Standard]]<br /><div style="font-size:75%; line-height:1.1em;">''(alle lateinischen non-ASCII-Buchstaben)''</div>
|-
| 20 || &amp;dagger;
|rowspan="2"| [[../../flow/format#Character Entities|auto/Standard]]<br /><div style="font-size:75%; line-height:1.1em;">''(alle Entities werden aufgelöst, wenn nichts dagegen spricht)''</div>
|-
| 27 || &amp;#0000; oder &amp;#x0000;
|-
| 16 || Vorlageneinbindung mit Unicode-Kontroll-Zeichen || [[../../flow/char#lrm|Immer Umwandlung in &amp;lrm; /  &amp;rlm;]]<br />Am Ende des Vorlagen-Namens automatisch entfernt; sonst dem manuellen Löschen zugänglich gemacht; auch [[../replace/template#rtl|benutzerdefiniert automatisch]].
|-
| 59 || Zeilenumbruch &lt;br&nbsp;/> am Vorlagen-Wertende || [[../replace/template#BrTemplateVal|benutzerdefiniert]]
|-
|  2 || Zeilenumbruch &lt;BR> im Artikeltext || [[../../flow/tag|korrektes XHTML]]
|-
| 54 || Zeilenumbruch &lt;br&nbsp;/> am Ende eines Listenpunkts oder vor einem Listenpunkt || [[../../flow/corr#BrListitem|benutzerdefiniert]]
|}

Dies ist jedoch nur ein Teil der Gesamtfunktionalität des Skriptes, die Schnittmenge mit dem Fehlerkatalog des ''Projekt Syntaxkorrektur''.

== Nicht automatisierbar zu behebende Syntaxfehler ==

Nur durch menschliche Interpretation des Textes lassen sich Strukturfehler beheben, die so schwer sind, dass automatische Berichtigungsversuche ausscheiden:

{| class="wikitable" border="1"
|+ Unkorrigierbare Syntaxfehler bei <code>Check Wikipedia</code>
|-
! ID !! priority !! Bezeichnung
|-
| 74
|rowspan="11"| high || Link ohne Ziel
|-
| 14 || Source mit undefiniertem Ende
|-
| 15 || Undefiniertes Ende bei Code
|-
|  5 || Undefiniertes Ende bei Kommentar
|-
| 13 || Undefiniertes Ende bei Math
|-
| 23 || Undefiniertes Ende bei Nowiki
|-
| 24 || Undefiniertes Ende bei Pre
|-
| 28 || Undefiniertes Ende bei Tabelle
|-
| 47 || Vorlagenbeginn nicht korrekt
|-
| 43 || Vorlagenende nicht korrekt
|-
| 60 || Vorlagenparameter problematisch
|-
| 29
|rowspan="2"| low || Undefiniertes Ende bei Galerie
|-
| 36 || Weiterleitung nicht korrekt
|}

Genauso muss ausscheiden, wo Inhalte erst zu generieren sind oder inhaltliche Beurteilungen erforderlich sind:
{| class="wikitable" border="1"
|+ Inhaltsbezogene Fehlertypen bei <code>Check Wikipedia</code>
|-
! ID !! priority !! Bezeichnung
|-
| 84
|rowspan="4"| high || Abschnitte ohne Inhalt
|-
| 35 || Bildbeschreibung in Galerie fehlt
|-
| 71<br />72<br />73 || ISBN
|-
|  3 || Referenz-Tag fehlt
|-
| 62
|rowspan="13"| middle || Überschrift alleinstehend
|-
| 83 || Überschrift beginnt mit drei „=“, nachfolgende auf Ebene 2
|-
| 92 || Überschrift doppelt
|-
| 58 || Überschrift großgeschrieben
|-
| 19 || Überschriften beginnen mit höherer Ebene als 2
|-
|  7 || Überschriften beginnen mit tieferer Ebene als 2
|-
| 25 || Überschriftenstruktur fehlerhaft
|-
| 55 || &lt;small> doppelt
|-
| 82 || Link zu einem anderen Wikiprojekt
|-
| 68 || Link zu einer anderen Sprache
|-
| 56 || Pfeil als ASCII-Kunst
|-
| 81 || Referenz-Angabe mehrfach vorhanden
|-
|  4 || Weblink im Artikel ohne Überschrift
|-
| 77
|rowspan="5"| low || Bildbeschreibung mit teilweise &lt;small>
|-
| 85 || HTML-Tag ohne Inhalt<br />''(Inhalt steht ggf. daneben)''
|-
| 41 || &lt;big>
|-
| 78 || Referenz-Tag doppelt
|-
| 34 || Reste aus Vorlagenprogrammierung
|}

Bestimmte Fehler lassen sich zwar formal konvertieren, aber erfahrungsgemäß handelt es sich um Passagen, die aus HTML-Dokumenten kopiert wurden und unter verschiedenen Aspekten wikifiziert werden müssen. Für das seltene Vorkommen lohnen sich Automatisierungsversuche nicht.
{| class="wikitable" border="1"
|+ Besser manuell aufzuarbeitende Fehlertypen bei <code>Check Wikipedia</code>
|-
| 49
|rowspan="7"| low || Überschrift in HTML-Tags
|-
| 12 || HTML-Listenelemente
|-
| 31 || HTML-Tabellenelemente
|-
| 39 || HTML-Textformatierungselement &lt;p>
|-
| 51 || Interwikilink vor der letzten Überschrift
|rowspan="3"| Ließe sich automatisch verschieben, wenn wirklich Interwikilink. Problem: Es könnte <nowiki>[[:Kategorie:Rubrik]]</nowiki> oder <nowiki>[[:en:Lemma]]</nowiki> gemeint sein, dem irrtümlich der führende Doppelpunkt fehlt. Wird bereits erkannt, ggf. MessageBox anzeigen.
|-
| 52 || Kategorie vor der letzten Überschrift
|-
| 53 || Interwikilink vor der letzten Kategorie
|}

== Beispiel für benutzerdefinierte Ersetzungen ==

Die vorstehend erwähnten benutzerdefinierten Ersetzungen der Syntax zusammengefasst:
<syntaxhighlight lang="javascript">
mw.libs.WikiSyntaxTextMod.config.mod.plain  =  [
   // ID:8
   ["\n(==+) *([^ =\n][^=\n]*[^ =\n]) *\\1 *([^ =\n])",
    "\n$1 $2 $1\n$3"],
   // ID:16
   ["\\{\\{(Arabische Schrift|(Ar|ar|Fa|fa|Ps|ps|Ur|ur)[FS]?|He|he) *\\| *(&rlm;)?([^|}\n]+) *(&lrm;)? *\\|",
    "{{$1|$4|"],
   // ID:26
   ["([^'])<(em|i)>([^'<\n]+)</ *\\2>([^'])",
    "$1''$3''$4",
    "gi"],
   // ID:38
   ["([^'])<(strong|b)>([^'<\n]+)</ *\\2>([^'])",
    "$1'''$3'''$4",
    "gi"],
   // ID:54
   ["<br /> *(\n+[*#:;])",
    "$1"],
   ["(\n[*#:;].+) *<br /> *\n",
    "$1\n"],
   // ID:57
   ["\n(==+) *(.+): *\\1 *\n",
    "\n$1 $2 $1\n"],
   // ID:59
   ["(\\| *[A-Za-z_0-9]+ *=[^|=\n])<br /> *(\n? *\\| *[A-Za-z_0-9]+ *=)",
    "$1$2"]
                                               ];
</syntaxhighlight>
Hinzu kämen inhaltsbezogene Ersetzungen wie Bildbeschreibungen und Linktitel.

Zu technischen Einzelheiten siehe [[../replace|benutzerdefinierte Ersetzungen]].

== Ausblick: künftige Möglichkeiten ==

{| class="wikitable" border="1"
|+ Künftig automatisierbare Fehlertypen bei <code>Check Wikipedia</code>
|-
! ID !! priority !! Bezeichnung !! Kommentar
|-
| 45 || high || Interwikilink doppelt || [[../../flow/corr#Mehrfache Spezial-Links|machbar, gelegentlich]]
|-
| 65
|rowspan="4"| low || Bildbeschreibung mit &lt;br&nbsp;/> am Ende || selten; machbar; zunächst auch [[../replace/plain/typogr#udef.BrLinkEnde|benutzerdefiniert]]
|-
| 17 || Kategorie doppelt || [[../../flow/corr#Mehrfache Spezial-Links|machbar, gelegentlich]]
|-
| 37 || SORTIERUNG fehlt und Lemma mit Sonderzeichen || Ließe sich als Vorschlag generieren und vor die erste Kategorie setzen; neue Lösung (UCA) könnte dies 2012/2013 überflüssig machen.
|-
| 89 || SORTIERUNG mit Großbuchstaben im Wort || Neue Lösung (UCA) machte dies 2012 überflüssig.
|}