Openweb.eu.org

Prendre des conventions en CSS et les documenter

Nicolas Hoffmann — 2018-06-12T08:29:03Z

Julie : il existe quelques solutions, comme KSS ou d'autres évoquées ici. Personnellement, mon graphiste utilise la même base en général qu'il adapte selon les sites, depuis Illustrator. Ceci dit, oui, c'est long à créer, il n'y a pas de miracles.

Prendre des conventions en CSS et les documenter

Chaumard Julie — 2018-06-11T19:20:59Z

Bonjour,
Cet article est très intéressant.
Je me demandais comment vous faisiez le document de guides de styles. Quel logiciel vous utilisez ?
Par exemple les schémas avec les layouts, ou bien les exemples avec le code écrit à côté.
De mon côté, je le fais sur un cahier. J'ai essayé de faire ces documentations avec des logiciels bureautiques classiques. Mais un rendu confortable à lire est long à créer.
Bien à vous,
Julie

Prendre des conventions en CSS et les documenter

Jérémy — 2014-05-23T10:58:34Z

En complément de mon commentaire précédent, je vous partage un article que j'ai écrit sur la "Génération de guide de styles avec Grunt" : https://medium.com/@JeremyRaffin/4abccdcbab29

Prendre des conventions en CSS et les documenter

Jérémy — 2014-05-11T19:57:18Z

Article très intéressant !

Les guides de styles tendent à se démocratiser surtout sur des projets ou plusieurs personnes interviennent.

Pour ceux qui utilise Grunt ou prévoit de l'utiliser je conseille grunt-styleguide (https://github.com/indieisaconcept/grunt-styleguide), permettant d'utiliser KSS ou Style Docco.

Je travaille actuellement sur le design et l'intégration d'une interface pour une plateforme d'affiliation et la génération automatique d'un styleguide (qui sera ensuite fourni aux équipes de développement) en prenant seulement quelques minutes pour commenter le CSS qu'on est en train de faire, c'est juste génial.

Prendre des conventions en CSS et les documenter

Nicolas Hoffmann — 2014-05-09T12:32:11Z

Ysabeau : oui, je vois pas ce qui l'empêcherait :)

Ch. Onze : de rien.

Nicolas : autant pour moi, le pire c'est que le lien indiqué juste en-dessous donne bien la bonne version. C'est corrigé merci :)

Prendre des conventions en CSS et les documenter

Nicolas — 2014-05-09T10:17:39Z

Super article merci Nicolas.

Par contre le modifieur est généralement introduit par '—' et non '__' comme tu l'indiques dans ton exemple :

.block{}
.block—element{}
.block__modifieur{}

Merci encore !

Prendre des conventions en CSS et les documenter

Ch. Onze — 2014-05-09T08:41:58Z

Très bonne piqûre de rappel. Et merci pour les liens, je les ajoute à ma file de lecture !

Prendre des conventions en CSS et les documenter

Ysabeau — 2014-05-08T18:52:10Z

Ce sont les miennes qui ne sont pas terribles de CSS.

J'imagine que je peux utiliser KNACSS avec SPIP sans autre forme de procès !