Forum:Verbindliche Richtlinien für die Vorlagen-Programmierung

Forum > Verbindliche Richtlinien für die Vorlagen-Programmierung

Hinweis: Dieser Fred wurde seit 5244 Tagen nicht bearbeitet. Dieser Fred ist offiziell versandet - die Diskussion damit Geschichte. Bitte nichts mehr hinzufügen.
Bei Bedarf dann halt einen neuen Fred starten oder diesen notfalls reanimieren.

Moin,

wie hier schonmal kurz angesprochen, wäre es vielleicht sinnvoll, die Vorlagen-Programmierung richt zu linien. Oder nicht? Senf wird erbeten.
Jedenfalls sind unsere Vorlagen das reinste Chaos, bzw. jedes Programmier-Kamel hat halt seine eigenen Methoden und seinen eigenen Stil (wo man ja nix gegen sagen kann), aber das merkt man eben. Mal ein paar Beispiele, was man vielleicht verbindlich regeln sollte (kann gerne erweitert werden):

• Ein quasi "globaler" Parameter für das Deaktivieren der Autokategorien wäre hilfreich ({{{kat = }}}, oder so.). Derzeit ist das in vielen Vorlagen (fallso überhaupt vorhanden) oft ein unbenannter (also nummerischer) Parameter, was Probleme mit sich bringt, wenn eine Vorlage um zusätzliche Funktionen erweitert wird. (fiktives) Beispiel: {{Begraben|}} kommt nicht in die Bestattungs-Kategorie, weil da ein "|" hinten dran ist. Nun kommt Kamel aber auf die Idee, einen neuen Parameter einzubauen, z.B. um den Seitentitel in der Vorlage manuell angeben zu können – geht aber nicht richtig, da dafür nur {{{2}}} in Frage käme, oder man macht möglicher Weise zig Seiten kaputt ... hoffe, das war verständlich.

• Parameter-Namen:
  • mal verbindlich klären, wann numerische und wann benamte (blödes Wort, aber mir fällt kein besseres ein) verwendet werden sollten
  • englische oder deutsche Parameter-Namen?
  • am wichtigsten: groß- oder kleingeschriebene Parameter?; oder gar {{{Parameter|{{{parameter|}}}}}} in allen Vorlagen einbauen, und das ganze damit case-insensitive machen?

• Vorlagen-Namen:
  • auch hier: Englisch oder Deutsch?
  • wie die sub-Vorlagen benennen? Ein einheitliches System wäre hilfreich, also Vorlage/dpl-Gedöhnse/Übersichtsseite oder Vorlage.dpl-Gedöhnse.Übersichtsseite, usw.
  • Bindestrich (Text-Farbe) oder nicht (Textfarbe), oder beides?

nervt jedenfalls tierisch, immer nachsehen zu müssen, wie 'ne Vorlage funktioniert ... könnte ja auch bei allen Vorlagen gleich sein

• Farb- und Größenangaben:
  • grundsätzlich: relative oder absolute Größenangaben? Und wenn ja, dann wie (.em oder %, bzw. px oder pt oder cm)?
  • hexadezimale (#XXXXXX) oder rgb (r:X g:X b:X) Angaben, oder Farbnamen, oder gar nur bestimmte Farben zulassen ("websichere" Farben, "Wüstenfarben")?

• standard-Konformität: wäre nett, wenn wenigstens unsere Vorlagen xhtml-konform wären, das heißt nicht nur <br /> statt <br> usw., sondern ich würde mir auch wünschen, dass keine deprecateden Sachen mehr verwendet werden sollten, z.B. <center>, ja, wirklich, <center>! Stattdessen: textalign = center, align = center und v.a. margin = auto.

• Quelltext und Kommentare: wie die doch immer komplizierter werdenden Vorlagen im Quelltext strukturieren und kommentieren? Html-Kommentare durchnummerieren? Zeilenweise kommentieren? Komentar-Blöcke? Verschachtelte Strukturen ({{#if: ... | {{#switch: | ... {{#dpl: | ... }} }} }} einrücken? Und wenn ja, wieviel?

• Wie die Vorlagen dokumentieren? Da bin ich gerade fleißig am arbeiten dran, 'ne entsprechende Vorlage zu bauen ... bin auch schon recht weit, mach' das aber lieber mal bei mir zuhause; kann man dann Zerreden, wenn's fertig ist ...

• usw. mir fällt bestimmt noch mehr ein; und auch ihr könnt gerne erweitern.

Das soll jetzt alles kein Vorwurf sein, wie gesagt, hat halt jedes Programmier-Kamel so seine Vorlieben, wäre aber vielleicht sinnig, sich wenigstens in groben Zügen auf irgendwas zu einigen. Oder einfach jeden machen lassen, wie er mag? Wäre auch 'ne Möglichkeit, solange alles funzt wie's soll ...? Jedenfalls, muss hier jetzt nix über's Knie gebrochen werden, und 'ne Anpassung der alten Vorlagen können wir ggf. auch nach und nach machen.

Grüße, --WiMu 11:21, 7. Jul. 2010 (NNZ)