Referenz - Seiten für den schnellen Überblick

[Matthias Scharwies]

Servus!

@Rolf B hatte mir vor einiger Zeit geschrieben, dass er die HTML-Element-Referenz um ein Feld "Zusatztext" erweitert hat. Trotzdem möchte ich erst einmal die CSS-Referenz vorstellen und dann diskutieren:

CSS/Eigenschaften/border

• die erste Zeile {{CSS-Referenz-Eigenschaft| …}} ruft eine Vorlage mit vielen Parametern auf. Die ist geschützt, da sie mehr als 250mal aufgerufen wird. Änderungen müssen vorher im Team besprochen werden.
• eine kurze Einführung erklärt, was die Eigenschaft macht.
• dann folgt eine Tabelle mit …
  • den möglichen Werten
  • einer Zeile für die Vererbung steuernden Werte
  • einer Zeile mit dem Defaultwert
• auf welche Elemente die Eigenschaft anwendbar ist
• ob sie vererbbar ist
• ob sie animierbar ist
• einer möglichen Angabe von caniuse

1. Sollte man die Tabelle evtl. in eine dl umwandeln?
   • wie sollte man mehrere Zeilen dd einbauen - wohl eher nicht mit <br>, oder?

2. Der Satz mit den Vererbung steuernden Werten sollte nur dort stehen, wo ge- und vererbt werden kann, oder?

3. Wie kann man den Default-Wert stärker hervorheben? (Früher war es eine eigene Spalte; jetzt geht er imho unter.)

Konsens ist wohl, dass dieser Bereich frei von Problemen mit Browser-Unterstützung, etc bleibt.

Danach folgt:

Dort haben wir die Tabellen schon entfernt.

Das Beispiel soll sehr kurz sein. In der Erklärung kann man schon mögliche Probleme beim Einsatz aufwerfen.

Für Hinweise gibt es die 2 Parameter Hinweis =und Tipp = . Hier sollte eigentlich ein Satz stehen. Bei einer Liste in Mediawiki-Syntax * wird das erste li nicht gerendert, sondern als * dargestellt. Das habe ich hier mit einem vorangestelllten <br>gelöst.

Wichtig: kurze Best practice-Tipps und Warnungen sind ok, optimalerweise verlinken wir auf ein Tutorial mit Live-Beispielen!

Evtl. sollte man das Siehe_auch, das auf eins oder mehrere Tutorials verlinkt vor die Weblinks stellen.

Ich habe mal einen Versuch mit dl erstellt: CSS/Eigenschaften/border-versuch. Ich persönlich würde zuerst das Wiki-Makeover abschließen, stelle das Projekt so aber schon mal vor.

HTML-Referenz

Hier ein Beispiel für die HTML-Referenz: HTML/Elemente/option

Ich weiß nicht, warum die Tabelle nach unten bis hinter die Weblinks gerutscht ist. Evtl lag es an der Länge des ganzen Tabellenblocks, der dann das Beispiel ganz nach unten verschoben hätte.

Hier würde ich auch versuchen wollen, die obere Tabelle durch dl zu ersetzen.

Bei der Syntax würde ich nur Start- und End-Tag darstellen, bei optional einen Link auf das entsprechende Tutorial. Die beiden Code-Beispiele würde ich weglassen, bei body gab's schon mal einen der behauptete, dass wir so den Einsatz mehrerer body-Elemente propagieren würden.

Die zweite Tabelle table.attribute-reference hatte bis eben nur eine Breite von 60%; habe ich gerade auf 100% geändert. Evtl. sollte man hier wie bei den Universalattributen einen Verbergen-Modus einbauen.

tl;dr

Was haltet ihr davon, das irgendwann so umzusetzen?

Herzliche Grüße

Matthias Scharwies