Prendre des conventions en CSS et les documenter - commentaires

Prendre des conventions en CSS et les documenter

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

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

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

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

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

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

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

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 !