KNACSS/README.md

76 lines
5.1 KiB
Markdown
Raw Normal View History

2015-03-06 16:03:28 +01:00
# KNACSS
2013-03-31 10:52:41 +02:00
http://www.knacss.com
2013-03-31 10:30:11 +02:00
2016-07-07 10:56:52 +02:00
KNACSS, c'est une sorte de feuille de style CSS "reset" sur-vitaminée qui permet de commencer un projet à partir de zéro tout en tenant compte de bonnes pratiques générales (accessibilité, performance, responsive webdesign).
2015-03-06 16:03:28 +01:00
2016-07-07 10:56:52 +02:00
KNACSS prend en charge les styles de base, mais également la typographie, les modèles de boîte, les alignements et positionnements d'éléments, les grilles de mise en page, dans l'esprit d'être adapté à toutes les tailles d'écran (reponsive). Le tout automatiquement !
2015-03-06 16:03:28 +01:00
2016-07-07 10:56:52 +02:00
Conçu par l'agence web [Alsacreations.fr](http://alsacreations.fr) et pensé pour être couplé avec des préprocesseurs tel que Sass, le micro-framework KNACSS est employé quotidiennement sur toute sorte de projets web quel que soit son type ou son envergure.
2013-03-31 10:32:01 +02:00
2017-10-02 15:40:56 +02:00
## Documentation
2015-03-30 16:48:01 +02:00
2017-10-02 15:40:56 +02:00
- [**Documentation et Guide de styles**](https://knacss.com/styleguide.html)
- [**Pense-bête en PDF**](http://knacss.com/KNACSS-cheatsheet.pdf)
- Site web de présentation de KNACSS : http://knacss.com
2015-03-06 16:22:20 +01:00
2017-10-02 15:40:56 +02:00
## Fonctionnalités
2013-03-31 10:30:11 +02:00
2017-10-02 15:40:56 +02:00
- reset
- typographie
- Responsive
- grille de mise en forme
- composants (formulaires, tableaux, boutons, flèches, onglets, checkbox, radio et bouton "switch" stylés)
- variables et mixin Sass
2013-03-31 10:30:11 +02:00
2017-10-02 15:40:56 +02:00
## Compatibilité
2015-04-26 16:12:24 +02:00
2017-10-02 15:40:56 +02:00
KNACSS est - dans sa grande majorité - compatible avec l'ensemble des navigateurs desktop et mobiles à partir d'IE10 inclus. Pour les détails, se référer à la documentation.
2015-04-26 16:12:24 +02:00
2017-10-02 15:40:56 +02:00
## Installation
2015-12-24 09:40:14 +01:00
2017-10-02 15:40:56 +02:00
Selon votre profil (débutant, utilisateur de Sass, adepte de Bower / npm / yarn), l'installation est différente.
2015-12-24 10:50:43 +01:00
2015-12-24 09:40:14 +01:00
2016-07-07 10:56:52 +02:00
## Comment débuter ?
2013-06-25 19:43:19 +02:00
2016-07-07 10:56:52 +02:00
Que vous ayez opté pour la version CSS simple ou la version Sass, il est vivement conseillé de parcourir la [**documentation**](https://github.com/raphaelgoetter/KNACSS/tree/master/doc) détaillée et illustrée avant de vous jeter sur KNACSS.
2016-07-07 10:56:52 +02:00
Sachez qu'un [**Pense-bête en PDF**](http://knacss.com/KNACSS-cheatsheet.pdf) et un [**Guide de styles**](http://codepen.io/raphaelgoetter/full/LNwOjz/) sont également disponibles pour vous souvenir des classes utiles de KNACSS.
2015-03-06 16:03:28 +01:00
2016-07-07 10:56:52 +02:00
Dans le cas d'un usage via Sass, vos deux fichiers de travail principaux seront :
2016-09-21 11:52:46 +02:00
- le fichier `sass/_config/_variables.scss` contenant toutes les variables du projet à définir une fois pour toute au départ
2016-07-07 10:56:52 +02:00
- le fichier `sass/knacss.scss` qui importe tous les autres fichiers que vous risquez d'employer dans votre projet.
2015-04-03 18:17:06 +02:00
2016-07-07 10:56:52 +02:00
En phase d'intégration, il vous suffit de compiler le fichier `sass/knacss.scss` pour obtenir votre fichier CSS final.
2015-09-09 12:42:31 +02:00
2016-05-16 15:46:48 +02:00
### Mise à jour depuis une version précédente de KNACSS ?
2016-09-21 13:43:36 +02:00
La version `6.*.*` de KNACSS est une version majeure, ce qui implique que certaines fonctionnalités ne sont plus forcément rétro-compatibles avec les versions précédentes `5.*.*`.
2016-09-21 11:52:46 +02:00
Voici les principales modifications dont il faudra tenir compte lors d'une bascule vers la version 6 de KNACSS :
#### Modifications majeures depuis la `5.*.*`
2016-05-16 15:46:48 +02:00
2016-09-21 11:52:46 +02:00
- le grille de mise en forme a été entièrement modifiée. Détails de modifications: https://github.com/alsacreations/KNACSS/issues/207
- les positionnements tabulaires. `.row`, `.col` et `.line`, devenus inutiles et confusants depuis Flexbox, ont été supprimés
- de nouvelles valeurs de breakpoints ont été définies. Détails: https://github.com/alsacreations/KNACSS/issues/210
- suppression de l'outils *include-media* (crée des bugs d'encodage, nécessite un temps d'apprentissage, et n'apporte pas grand chose au final)
2016-05-16 15:46:48 +02:00
#### Modifications majeures depuis la `4.*.*`
- suppression de la version LESS (à partir de la version KNACSS 5.0, seul le préprocesseur Sass est encore pris en charge)
- suppression des fallbacks pour IE8-IE9 (à partir de la version KNACSS 5.0, seul IE10 et supérieurs sont pris en charge)
- restructuration / renommage des fichiers avec préfixes `_config-`, `_layout-`, `_library-`, `_object-`, `_override-`
- renommage des éléments de grilles : `.flex-item-double` --> `.grid-item-double` (plus cohérent)
2016-05-16 15:46:48 +02:00
- ajout de la library include-media (http://include-media.com/)
- grille "grillade" à présent en mobile first
#### Modifications majeures depuis la `3.*.*`
2016-05-22 16:34:31 +02:00
- La rétrocompatibilité n'est pas préservée pour certains noms de classes ( `.left`, `.start`, `.fl`, `.table-`, `.flex-start`, `.flex-end`) : `.left` ne correspond plus à un `float: left` mais à un `margin-right: auto`, il faut dorénavant employer `.fl` pour obtenir un flottant à gauche; `.right` ne correspond plus à un `float: right` mais à un `margin-left: auto`, il faut dorénavant employer `.fr` pour obtenir un flottant à droite; `.start` et `.end` n'existent plus
- Les noms des conteneurs de grille ont changé et nécessitent systématiquement un trait d'union : ancien nommage : `.grid2`, `.grid1-3`; nouveau nommage : `.grid-2`, `.grid-1-3`
- Les classes relatives à flexbox ont été renommées pour ne pas entrer en conflit avec des outils tels que Modernizer (qui ajoutent aux-aussi ce genre de classes). Nouveau nommage :
`.flex-container, .flex-container-h`, `.flex-container-v`, `.flex-item-fluid`, `.flex-item-center`, `.flex-item-first, .flex-item-medium, .flex-item-last`