À propos du projet
Primer CSS est l'implémentation CSS du Primer Design System de GitHub, publiée sur npm sous le nom `@primer/css`. Il fournit la couche de stylisation de Primer : des classes utilitaires et des styles de composants que les équipes peuvent réutiliser pour maintenir une cohérence visuelle des interfaces.
Ce qu'il contient
- Des sources Sass écrites en syntaxe SCSS, importables dans leur ensemble ou par module.
- Des points d'entrée distincts pour différents contextes : `core`, `product` et `marketing`, afin qu'un projet puisse n'importer que le stylage dont il a besoin.
- Un ensemble de thèmes et de composants documentés, décrits sur le site de documentation du projet à l'adresse primer.style/css, qui couvre la prise en main, les composants, le thémage et les principes de conception.
Installation et utilisation
Après l'installation de npm, le package peut être ajouté à un projet avec `npm install --save @primer/css`. Comme les sources sont en SCSS, le répertoire `node_modules` du projet doit figurer dans les chemins d'inclusion (chargement) de Sass. À partir de là, la feuille de style complète peut être importée avec `@import "@primer/css/index.scss";`, ou des modules individuels peuvent être importés directement, par exemple `@import "@primer/css/core/index.scss";`, `@import "@primer/css/product/index.scss";` ou `@import "@primer/css/marketing/index.scss";`.
État du projet
Un avertissement dans le README indique que le dépôt est en mode KTLO ("keep the lights on"). La consigne est de continuer à utiliser les classes utilitaires existantes là où elles sont nécessaires, mais pour des modèles plus complets combinant stylisation et balisage, la recommandation est de passer à primer/react ou, si nécessaire, à primer/view_components. En d'autres termes, Primer CSS reste disponible et supporté pour ses classes utilitaires, tandis que le travail sur les nouveaux modèles est orienté vers les implémentations React et ViewComponents.
Développement et contribution
Le dépôt comprend un fichier DEVELOP.md pour la documentation du développement, et un fichier RELEASING.md couvrant le processus de publication pour le personnel de GitHub. L'intégration continue s'effectue via GitHub Actions, et les métadonnées de version sont exposées via des badges npm et GitHub (version du package, état du build, contributeurs, dernier commit et licence).
Licence
Le projet est publié sous la licence MIT, copyright GitHub.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.