Préparation d'une référence CSS
Par Laurentj le samedi, septembre 17 2005, 09:05 - Projets - Lien permanent
Je suis en train de préparer un p'tit truc qui va plaire à pas mal de monde : une réference complète de CSS 1, CSS 2, CSS 2.1, CSS 3. Mais aussi une référence complète des styles spécifiques à Mozilla, qui sont indispensables dés lors que l'on fait du XUL (cette référence est en effet déstinée à l'origine au site xul-fr, mais après réflexion, elle pourrait aussi avoir sa place autre part..).
J'en suis pour l'instant à l'étape de rentrer en base de données les noms des propriétés et pour chacune d'elles, les mots clés possibles (ce qui va me faciliter la génération de la référence dans n'importe quel format). C'est long parce qu'il me faut lire en détails toutes les spécifications de CSS. Et j'ai du me faire un petit outil en PHP pour rentrer tout ça sans y passer l'année. Il ne me reste plus qu'à faire CSS3 (enfin, ce qui n'est pas encore à l'état de brouillon préliminaire dans les specs) et CSS-moz. Pour ce dernier, ça va être plus difficile : il n'y a aucune spec. Je vais devoir donc fouiller dans le code source de mozilla. Avoir la liste des propriétés et mots clés, c'est facile car c'est listé dans deux fichiers, mais avoir la correspondance entre les deux nécessite de plonger encore plus profond dans le code source.
Bien sûr, on pourra savoir si la propriété ou le mot clé est disponible dans Gecko 1.7 (Firefox/thunderbird 1.0), Gecko 1.8 (Firefox/Thunderbird 1.5) ou Gecko 1.9 (Firefox/Thunderbird 2.0). et si il fait parti de CSS1, CSS2 etc. Les pseudos classes et pseudo elements seront aussi référencés.
Une fois cette étape terminée, il me faudra ajouter une petite description pour chacune de ces propriétés, et à présenter cette référence dont la forme reste encore à définir. J'ai notamment en tête un espèce de wiki où chacun pourra compléter la description, commenter etc. Un peu comme ce que voulait le monsieur qui se plaignait du manque de documentation (mais dont il est inutile de rappeler son nom, et encore moins son blog vu qu'il n'assume absolument pas ses propos), un peu à la manière de http://www.php.net donc, car il est vrai que leur système de documentation est pas mal, même si un peu bordélique (les extensions sont classées par ordres alphabétiques, et non pas par domaine fonctionnel, et avec le temps ça devient le bazaaaare).
Bon, aller, j'y retourne..
Commentaires
Sur DevMo il y a la liste des propriétés CSS spécifiques à Mozilla avec une description, ça pourra peut être t'aider...
Il y a aussi une ébauche de référence CSS2 sur DevMo, pourquoi ne pas proposer de l'étoffer pour arriver (au moins) au niveau des références DOM et JavaScript ?
Je suis bien placé pour savoir que c'est toujours tentant de créer un nouveau site quand on a une nouvelle idée, mais ça contribue indirectement à l'éparpillement des ressources par la suite.
Ça c'est une très bonne idée, personnelement je vais apprécier la doc CSS-moz car ça va aider pour les applis XUL. Sinon pour t'aider avec CSS 1 & 2.0, il y a cette référence en français: http://fr.selfhtml.org/navigation/css.htm c'est plus digeste que les spéc du w3c.
David
Ce sera une ressource d'autant plus pertinente qu'elle ne sera ni théorique ni "la référence CSS de Mozilla". C'est à dire en effet ouverte sous forme de wiki, mais avec un projet collectif construit pour que les implémentations CSS de chaque navigateur puisse être renseignée. Ce qui suppose une motivation collective.
Excellente idée Laurent !
Hello Laurent,
Je pensais que la documentation de Mediabox pouvait être un intéressant point de départ : http://wiki.media-box.net/documentation/css
Qu'en penses-tu ?
Tu peux aussi jeter un oeil à http://fr.selfhtml.org/css/index.htm , la doc est pas mal.
a+
Ce qui serait bien ce serait aussi de regrouper les propriétés CSS spécifiques aux autres navigateurs, et pour chaque propriété indiquer son support. Ainsi on aurait une référence très utile.
Laurent,
c'est une très bonne idée et je t'encourage à contribuer au QA IG quand il va redémarré d'ici une semaine ou deux. je te tiens au courant bientôt.
Bonjour Laurent
Je passe en coup de vent (je n'ai plus internet) pour te signaler ces deux pages que j'ai écrites il y a quelquetemps mais que je n'ai pas eu le temps de finir : http://www.geckozone.org/wiki/wakka.php?wiki=StyleProperties et http://www.geckozone.org/wiki/wakka.php?wiki=StyleProperties-Exemples
N'hésite pas à l'utiliser ;)
En tant que webmaster d'un site naissant sur les CSS, j'avais pensé à un wiki du genre : chacun pourrait ajouter un élément, son type (sélecteur, propriété, etc.), le lien vers la documentation associée, la prise en charge par les navigateurs, mais aussi et surtout des exemples de son utilisation.
C'est vrai que ça manque et que ce serait très pratique ! Bon courage !
Pour ma part, pas de conseils mais un grand bravo d'avance :)
Et tous mes encouragements, je dois dire que j'attends le résultat avec impatience.
Excellente initiative Laurent, qui je pense dois aussi se préparer ailleurs... Aide toi effectivement des autres 'références' du web ou disponibles en livres ;-)
J'attends de voir le résultats ou encore les 1res ébauches pour contribuer ! Si tu (et vous autres) as des contributions à apporter pour l'initiative que je veux développer : "L'histoire des standards du web et des normes d'accessibilité" je suis également preneur !
Les petits râleurs vont voir si il manque réellement de la doc ;-)
Vous en réviez, Laurent jouanneau le fait ;-)
Ca fait quelques semaines que je pense créer la même chose (en incluant DOM, Javascript, HTML et SVG) car la disponibilité de ces références dans Dreamweaver (oui, y'a pas SVG et les références proposées sont pas tip-top) est une des features que j'utilise le plus lors du développement Web. Mais par manque de temps (et par fainéantise aussi, je l'admet), je n'ai pas démarré le projet.
Alors, évidemment, si tu nous ponds ça, Laurent, gloire à toi !
Super initiative...euh, mais ca en est où qu'on la trouve ?