Benutzer:ZOiDberg/Vorlagen/Hilfe
Neue Sprachvorlagen
[Bearbeiten | Quelltext bearbeiten]Eines vorweg: SprachTupel (SBTs) sollten vollständig sein, also 12 Bausteine umfassen. Wenn Du keine Lust hast 12 Bausteine zu entwickeln, musst Du damit rechnen, dass andere Benutzer das SBT vervollständigen und neue Vorlagen im selben Namensraum erstellen, indem Du Deine angelegt hast (was meistens Dein Benutzernamensraum ist).
Das Anlegen der Bausteine
[Bearbeiten | Quelltext bearbeiten]Um die Arbeit zu erleichtern erstelle bevor Du anfängst unter Benutzer:ZOiDberg/Vorlagen ein neues SBT mit den Eigenschaften für die Sprache für die Du neue Bausteine entwickeln möchtest. Das hat den Vorlteil, dass Du nur noch auf die automatisch generierten roten Links klicken musst um die Bausteine anzulegen.
Das funktioniert wie im Folgenden am Beispiel der Auszeichnungssprache XSL gezeigt wird
=== XSL === {{Benutzer:ZOiDberg/Vorlage:SBT/Vorlage:Wunsch}} {{Benutzer:ZOiDberg/Vorlage:SBT/Vorlage:Standard|Benutzer:ZOiDberg/Vorlage:user_xsl}} {{Benutzer:ZOiDberg/Vorlage:SBT/Vorlage:Kat|Benutzer:ZOiDberg/Kategorie:user_xsl}}
- Die zweite Zeile kann dabei auch weggelassen werden, wenn Du vor hast das SBT sofort anzulegen.
- Der kursive unterstrichene Teil ist dabei der, der für das entsprechende SBT zu modifizieren ist.
„Ausfüllen“
[Bearbeiten | Quelltext bearbeiten]Die Vorlagen erzeugen bereits den Inhalt, Du musst dann nur noch die spezifischen Eigenschaften ausfüllen. Das ganze ist so entworfen dass das was immer gleich ist nicht mehr angegeben werden muss.
Bei den Vorlagen
[Bearbeiten | Quelltext bearbeiten]Bei dem Beispiel oben (für XSL) wirst Du auf eine Seite mit einem Editierfeld verwiesen welches etwa diesen Inhalt haben kann:
{{subst:Benutzer:ZOiDberg/Vorlage:user}}
Dort müssen jetzt nur noch 3 Parameter eingefügt werden. Undzwar als erstes der Inhalt des linken Feldes, als zweites der Name der Sprache und als drittes die Kategorie. Am Beispiel etwa:
{{subst:Benutzer:ZOiDberg/Vorlage:user|[[Extensible Stylesheet Language|XSL]]|XSL|Benutzer:ZOiDberg/Kategorie:user_xsl}}
Bei der Kategorie
[Bearbeiten | Quelltext bearbeiten]Wichtig, diese Kategorie nicht vergessen! Du landest auf folgender Seite, wenn Du den erzeugten Link folgst:
{{subst:Benutzer:ZOiDberg/Kategorie:user}}
Hier muss nur ein Parameter ergänzt werden, nämlich der zu dem „Namensraum“ der 12 Vorlagen. Am Beispiel sieht das so aus:
{{subst:Benutzer:ZOiDberg/Kategorie:user|Benutzer:ZOiDberg/Vorlage:user_xsl}}
Vorlagen für Vorlagen
[Bearbeiten | Quelltext bearbeiten]Für jeden der 12 (6 femininum, 6 maskulinum) Bausteintypen gibt es eine Vorlage, die nur zum erzeugen neuer Vorlagen dient. Diese wird mit subst:
eingebunden und erstellt einen normkonformen Baustein.
Vorlagen
[Bearbeiten | Quelltext bearbeiten]Einfach diese Vorlagen per subst:
einbinden.
Benutzer:ZOiDberg/Vorlage:user
|
|
Benutzer:ZOiDberg/Vorlage:user-w
|
| ||||
Benutzer:ZOiDberg/Vorlage:user-4
|
|
Benutzer:ZOiDberg/Vorlage:user-4-w
|
| ||||
Benutzer:ZOiDberg/Vorlage:user-3
|
|
Benutzer:ZOiDberg/Vorlage:user-3-w
|
| ||||
Benutzer:ZOiDberg/Vorlage:user-2
|
|
Benutzer:ZOiDberg/Vorlage:user-2-w
|
| ||||
Benutzer:ZOiDberg/Vorlage:user-1
|
|
Benutzer:ZOiDberg/Vorlage:user-1-w
|
| ||||
Benutzer:ZOiDberg/Vorlage:user-0
|
|
Benutzer:ZOiDberg/Vorlage:user-0-w
|
|
Und nicht die Kategorie vergessen: Benutzer:ZOiDberg/Kategorie:user
Parameter der Vorlage
[Bearbeiten | Quelltext bearbeiten]Parameterindex | Bedeutung | Beispiel |
---|---|---|
1 | Text (inklusive Link) der in dem quadratischen Fenster links erscheint. | [[C++|cpp]]
|
2 | Name der Sprache (taucht in dem Feld rechts auf. | C++
|
3 | Name der Kategorie (ohne eckige Klammern) | Benutzer:ZOiDberg/Kategorie:user_cpp
|
SBT
[Bearbeiten | Quelltext bearbeiten]Als SBT (SprachenBausteinTupel) wird die Ansammlung von 12 (bzw. 6) Bausteinen einer Sprache zu einem Verbund bezeichnet. Solche Verbunde kann man unter der Auflistung aller Sprachen in Benutzer:ZOiDberg/Vorlagen begutachten.
Erstellung von SBTs
[Bearbeiten | Quelltext bearbeiten]Zum Erstellen von Verbunden bei bereits existierenden Bausteinen ist allgemein folgendes Format zu verwenden.
=== === {{Benutzer:ZOiDberg/Vorlage:SBT|namespace= |m5=|f5= |m4=|f4= |m3=|f3= |m2=|f2= |m1=|f1= |m0=|f0= }} {{Benutzer:ZOiDberg/Vorlage:WhatLinksHere|Benutzer:/Kategorie:}}
Wie folgt sieht beispielsweise die Einbindung der C++ Vorlagen aus.
Es ist wichtig zu beachten, dass keine Leerzeichen auftauchen dürfen.
=== C++ === {{Benutzer:ZOiDberg/Vorlage:SBT|namespace=Benutzer:ZOiDberg/Vorlage:user_cpp |m5=|f5=-w |m4=-4|f4=-4-w |m3=-3|f3=-3-w |m2=-2|f2=-2-w |m1=-1|f1=-1-w |m0=-0|f0=-0-w}} {{Benutzer:ZOiDberg/Vorlage:WhatLinksHere|Benutzer:ZOiDberg/Kategorie:user_cpp}}
Normierung und Vereinfachung
[Bearbeiten | Quelltext bearbeiten]Liegen die Bausteine jedoch in dieser Namenskonvention vor, kann man sich die Arbeit mit folgendem Baustein sehr vereinfachen.
Im Allgemeinen
[Bearbeiten | Quelltext bearbeiten]=== === {{Benutzer:ZOiDberg/Vorlage:SBT/Vorlage:Standard|...|...}} {{Benutzer:ZOiDberg/Vorlage:WhatLinksHere|Benutzer:/Kategorie:}}
Am Beispiel C++
[Bearbeiten | Quelltext bearbeiten]=== C++ === {{Benutzer:ZOiDberg/Vorlage:SBT/Vorlage:Standard|Benutzer:ZOiDberg/Vorlage:user_cpp}} {{Benutzer:ZOiDberg/Vorlage:WhatLinksHere|Benutzer:ZOiDberg/Kategorie:user_cpp}}
PBT
[Bearbeiten | Quelltext bearbeiten]Da die SBTs ursprünglich nur für Programmiersprachen gedacht waren, hießen sie zunächst PBT. Der Allgemeingültigkeit halber wurden sie jedoch umbenannt. Jedes Autreten der alten Bezeichnung bitte schnell korrigieren.