passage à la v4.x.x

doc/00-commencer.md

@@ -0,0 +1,70 @@
+# KNACSS
+
+http://www.knacss.com
+
+KNACSS, c'est un peu comme une 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).
+
+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 !
+
+Conçu par l'agence web [Alsacreations.fr](http://alsacreations.fr) et pensé pour être couplé avec des préprocesseurs tels que LESS ou Sass, le micro-framework KNACSS est employé quotidiennement sur toute sorte de projets web quel que soit son type ou son envergure.
+
+## Installation
+
+La version courte est "il n'y a rien à installer".
+
+Selon votre environnement de travail vous suffit de récupérer la feuille de styles :
+
+- en version [CSS classique](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/css/knacss-unminified.css) (ou [minifié](vhttps://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/css/knacss.css))
+- en version [LESS](https://github.com/raphaelgoetter/KNACSS/tree/master/less)
+- en version [Sass](https://github.com/raphaelgoetter/KNACSS/tree/master/sass)
+
+_Les versions LESS et Sass seront bien évidemment plus malléables grâce à l'apport de variables et fonctions._
+
+À noter que KNACSS est basé sur un socle [Normalize.css](http://necolas.github.io/normalize.css/), célèbre - et éprouvé - reset CSS employé par Twitter, Github, Bootstrap, Guardian, etc.
+
+## Usage
+
+KNACSS n'est constitué que d'un seul fichier CSS (minifié ou non selon vos goûts), qu'il vous suffit d'ajouter à votre page HTML :
+
+    <link rel="stylesheet" href="knacss.css">
+
+Il est également possible de l'installer (toutes versions) via [Bower](http://bower.io/) : ```bower install knacss```
+
+## RTFM!
+
+KNACSS se veut être un outil simple (contrairement aux usines à gaz que sont Bootstrap ou Foundation), mais évolutif.
+La contrepartie est que cela nécessite de votre part de bonnes connaissances en CSS et un petit effort de compréhension et de d'apprentissage des mécanismes de l'outil.
+
+Une [**documentation**](https://github.com/raphaelgoetter/KNACSS/tree/master/doc) détaillée et illustrée est en cours de rédaction. Je vous invite vivement à la parcourir avant de vous jeter sur KNACSS.
+
+Sachez qu'un [pense-bête en PDF](http://knacss.com/KNACSS-cheatsheet.pdf) est également disponible pour vous rappeler des classes utiles de KNACSS.
+
+
+## Préprocesseurs
+
+KNACSS est conçu et pensé pour être adapté aux préprocesseurs que sont LESS et Sass. Nous employons LESS en interne, nos fichiers de travail sont donc des `.less` et non des `.css` (cela fonctionne aussi avec Sass).
+
+Si, comme nous, vous intégrez à l'aide de préprocesseurs, KNACSS va vous faciliter la vie dès le début du projet puisqu'un [fichier de configuration](https://github.com/raphaelgoetter/KNACSS/blob/master/less/_00-config.less) contenant toutes les variables du projet est intégré.
+Libre à vous de le modifier selon les contraintes de votre projet.
+
+**Attention**, si vous importez KNACSS automatiquement via Bower (par exemple dans un dossier `vendor`), ce fichier de configuration risque d'être écrasé à chaque mise à jour de KNACSS. Nous vous invitons à en faire une copie dans votre dossier de travail et à commenter l'appel au fichier de config de `vendor`.
+
+Dans le cas d'un usage via préprocesseur, vos deux fichiers de travail principaux seront :
+- le fichier `less/_00-config.less` contenant toutes les variables du projet à définir une fois pour toute au départ
+- le fichier `less/knacss.less` qui importe tous les fichiers que vous risquez d'employez dans votre projet (`layout.css`, `responsive.css`, `forms.css`, `print.css`, etc.).
+
+En cours de développement, il vous suffit de compiler ce fichier `less/knacss.less` (ou `less/knacss.scss`) pour obtenir vos fichiers CSS utiles.
+
+### Préfixes navigateurs
+
+Certaines fonctionnalités avancées de KNACSS nécessitent d'employer toute une panoplie de préfixes CSS (`-webkit-`, `-moz-`, `-ms-`, ...) pour être certain que les propriétés CSS fonctionneront partout.
+
+Au sein de la version classique CSS de KNACSS, l'ensemble des préfixes est présent, **vous n'avez donc pas à vous en soucier** (Autoprefixer réglé à "last 2 versions").
+
+**Par contre, dans les versions LESS et Sass de KNACSS, les préfixes n'apparaissent pas** pour ne pas polluer la lecture du fichier de travail. **Il vous sera donc nécessaire de les ajouter**, de préférence automatiquement grâce à un plugin ou aux excellents outils que sont [autoprefixer](https://github.com/postcss/autoprefixer) ou [pleeease](http://pleeease.io/).
+
+## Liens utiles
+
+* Site web de KNACSS : http://knacss.com
+* [**Documentation détaillée**](https://github.com/raphaelgoetter/KNACSS/tree/master/doc)
+* Sur Alsacreations.com : ["découverte du framework KNACSS"](http://www.alsacreations.com/tuto/lire/1577-decouverte-du-framework-css-KNACSS.html)

doc/01-typo-et-reset.md

@@ -0,0 +1,34 @@
+# Typographie
+
+Accessible avant tout, KNACSS propose une gamme de tailles de polices d'unités fluides (`em`, `rem`) plutôt que le pixel, figé et non malléable, donc moins accessible.
+
+En résumé, voilà les bases typographiques de KNACSS :
+
+- choix d'unités fluides (`em`, `rem`)
+- taille de police définie à 62.5% sur HTML (soit un équivalent de 10px, très pratique pour les conversions en rem)
+- taille de base des contenus de 1.4em (soit un équivalent de 14px) modifiable dans la configuration LESS / Sass
+- tailles de polices définies pour les niveaux de titres et des modificateurs tels que `.small`, `.smaller`, `.big`, `.bigger`, etc.
+
+## Reset "light"
+
+Le reset de KNACSS est volotairement minimal, le but n'étant pas de tout mettre à zéro pour le redéfinir par la suite.
+
+La feuille de style débute ainsi par une variante de l'incontournable `* {box-sizing: border-box}` afin d'imposer le très pratique modèle de boîte CSS3 à tous les éléments du document.
+
+S'en suivent quelques mises à zéro de marges, alignements par défaut des images, et quelques spécificités sur des élements tels que `blockquote`, `figure`, `canvas`, `video` ou autres `svg`.
+
+## Masquage
+
+À noter que KNACSS prévoit une classe dédiée aux éléments devant être masqués sur écrans graphiques tout en demeurant accessibles aux assistances techniques. Il s'agit de la classe `.visually-hidden`, où le choix des hideux mots-clés `!important` se justifie :
+
+```css
+.visually-hidden {
+  position: absolute !important;
+  border: 0 !important;
+  height: 1px !important;
+  width: 1px !important;
+  padding: 0 !important;
+  overflow: hidden !important;
+  clip: rect(1px, 1px, 1px, 1px) !important;
+}
+```

doc/02a-layout-alignements.md

@@ -0,0 +1,64 @@
+# Alignements
+
+Différentes classes utilitaires intégrées à KNACSS sont prévues pour gérer les alignements d'éléments.
+
+- les textes et contenus "inline" sont gérés via les classes `.txtleft`, `.txtright` et `.txtcenter` qui agiront sur la propriété CSS `text-align`
+- les blocs sont alignés avec les classes `.left`, `.right` et `.center` qui affectent la valeur `auto` à la propriété `margin`
+- les flottements sont gérés via les classes `.fl` (pour `float: left`) et `.fr` (pour `float: right`)
+
+## Cas des flottants et les .mod
+
+Le positionnement flottant compte parmi les plus employés mais n'est pas exempt d'inconvénients. Le principal étant d'être un positionnement hors du flux qui nécessitera des ajustements (clearfix et autres anti-débordements).
+
+KNACSS a prévu des classes spécifiques pour mieux vous en sortir avec les flottants :
+
+- **le super élément `.mod`**. Il a plein d'avantages: il contient les flottants (ils ne débordent pas) et il ne s'écoule pas autour d'un frère flottant (il s'affiche proprement à côté) et il crée un [contexte "BFC"](http://www.alsacreations.com/astuce/lire/1543-le-contexte-de-formatage-block-en-css.html)
+- `.clearfix`. Les éléments disposant de cette classe contiennent les flottants, tel les `.mod`
+- les éléments `.clear`, `.line` et `.row` bénéficient d'un autre pouvoir : celui de toujours se pousser sous un flottant précédent. Il sont dédiés aux empilements verticaux des contenus.
+
+## Concrètement : je veux faire quoi ?
+
+### Centrer horizontalement
+
+#### Du texte ou une image
+
+HTML :
+```html
+<div class="txtcenter">
+    <img src="licorne.png" alt="aïe ça pique">
+</div>
+```
+
+#### Un bloc
+
+HTML :
+```html
+<section>
+    <div class="center w50">centré horizontalement</div>
+</section>
+```
+
+### Centrer verticalement
+
+![centrer verticalement](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/02-layout.png)
+
+Version table-cell (HTML) :
+```html
+<section class="col">
+    <div class="w50 center">centré horizontalement et verticalement</div>
+</section>
+```
+
+Version table-cell (CSS) :
+```css
+section {
+    vertical-align: middle;
+}
+```
+
+Version flexbox (HTML):
+```html
+<section class="flexbox-v">
+    <div class="center w50">centré horizontalement et verticalement</div>
+</section>
+```

doc/02b-layout-positionnement.md

@@ -0,0 +1,172 @@
+# Positionnements avec KNACSS
+
+Au-delà des alignements d'éléments, KNACSS permet de positionner et d'architecturer vos gabarits à travers plusieurs solutions.
+
+Dans cette page de documentation, nous étudierons en détail chaque cas concret auquel vous risquez d'être confronté et proposerons une réponse adaptée.
+
+## Différents choix offerts
+
+Les types de positionnements inclus nativement dans KNACSS sont les suivants :
+
+- positionnement flottant
+- positionnement avec `display: inline-block`
+- positionnement avec `display: table-cell`
+- positionnement avec Flexbox
+
+Il n'y a pas de mystère : chaque type de positionnement est capable de répondre à différents types de contraintes. Il n'y a pas de meilleur choix qu'un autre.
+
+Votre décision pourra être guidée par les indices suivants :
+- il est généralement plus profitable de ne pas opter pour des positionnement hors-flux (`float`, `position: absolute`)
+- Flexbox est certainement le modèle le plus polyvalent et propre, mais n'est compatible qu'à partir de IE10+.
+
+## Concrètement : je veux faire quoi ?
+
+### Deux blocs voisins de largeur fixe
+
+![Deux blocs voisins de largeur fixe](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/03-layout1.png)
+
+Les choix offerts avec KNACSS :
+
+#### flottant et flottant
+
+La classe `.fl` pour `float: left` permet à un élément d'être flottant à gauche.
+
+Il vous suffit de faire flotter vos deux éléments et de leur attribuer la largeur souhaitée pour qu'ils s'affichent l'un à côté de l'autre :
+
+HTML :
+```html
+<div class="fl w400p">premier</div>
+<div class="fl w400p">deuxième</div>
+```
+
+- **Avantage :** simple, rapide, intuitif, hyper compatible
+- **Inconvénient :** positionnement hors du flux, nécessitera des ajustements (clearfix et autres anti-débordements)
+
+#### inline-block et inline-block
+
+La propriété `display: inline-block` (sous forme de classe `.inbl` chez KNACSS) permet à un élément de s'afficher tel un "inline" tout en étant dimensionné.
+
+HTML :
+```html
+<div class="inbl w400p">premier</div>
+<div class="inbl w400p">deuxième</div>
+```
+
+- **Avantage :** positionnement dans le flux, compatible dès IE8
+- **Inconvénient :** un espace "whitespace" apparaîtra entre les deux div et nécessitera de coller les balises ou de bidouiller en CSS pour être supprimé
+
+#### table-cell et table-cell
+
+HTML :
+```html
+<div class="row">
+    <div class="col w400p">premier</div>
+    <div class="col w400p">deuxième</div>
+</div>
+```
+
+- **Avantage :** positionnement dans le flux, compatible dès IE8
+- **Inconvénient :** Le positionnement tabulaire observe [des règles parfois complexes](http://www.alsacreations.com/tuto/lire/1522-le-modele-tabulaire-en-css.html) et surprenantes pour les non habitués.
+
+#### flexbox
+
+HTML :
+```html
+<div class="flexbox">
+    <div class="w400p">premier</div>
+    <div class="w400p">deuxième</div>
+</div>
+```
+
+- **Avantage :** fluide, propre, simple
+- **Inconvénient :** compatibilité IE10 minimum
+
+### Deux blocs voisins dont un fixe et un fluide
+
+![Deux blocs voisins de largeur fixe et fluide](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/03-layout2.png)
+
+Les choix offerts avec KNACSS :
+
+#### flottant et .mod
+
+HTML :
+```html
+<div class="fl w400p">premier</div>
+<div class="mod">deuxième</div>
+```
+
+#### inline-block et inline-block
+
+Pas possible [Résolu]
+
+#### table-cell et table-cell
+
+HTML :
+```html
+<div class="row">
+    <div class="col w400p">premier</div>
+    <div class="col">deuxième</div>
+</div>
+```
+
+#### flexbox
+
+HTML :
+```html
+<div class="flexbox">
+    <div class="w400p">premier</div>
+    <div class="flexitem-fluid">deuxième</div>
+</div>
+```
+
+### Deux blocs voisins de même hauteur
+
+![Deux blocs voisins de même hauteur](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/03-layout3.png)
+
+Les choix offerts avec KNACSS :
+
+#### flottant et flottant
+
+Pas possible [Résolu]
+
+#### inline-block et inline-block
+
+Pas possible [Résolu]
+
+#### table-cell et table-cell
+
+Par défaut, les éléments constituant des "cellules de tableau", donc `table-cell` ont automatiquement la même hauteur entre frères. Il n'y a donc rien à faire si l'on opte pour ce positionnement : ça marche tout seul.
+
+HTML :
+```html
+<div class="row">
+    <div class="col">premier</div>
+    <div class="col">deuxième</div>
+</div>
+```
+
+#### flexbox
+
+Là aussi c'est automatique : les enfants d'un conteneur `flexbox` ont tous par défaut la même hauteur.
+
+HTML :
+```html
+<div class="flexbox">
+    <div>premier</div>
+    <div>deuxième</div>
+</div>
+```
+
+### Plusieurs blocs voisins de même taille
+
+![grilles](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/03-layout4.png)
+
+Si vous souhaitez réaliser des constructions de plusieurs éléments de même taille (fixe ou fluide) avec ou sans espace entre les éléments (gouttière), je vous invite à prendre connaissance des possibilités de **grilles** offertes par KNACSS.
+
+Voir **[la Doc au point 03-grilles](https://github.com/raphaelgoetter/KNACSS/blob/master/doc/03-grilles.md)**.
+
+### Schnaps.it, générateur de templates KNACSS
+
+Alsacréations tient à jour un générateur de gabarits HTML/CSS basé sur le framework KNACSS, **[Schnaps.it](http://schnaps.it/)**, n'hésitez pas à en user et en abuser&nbsp;!
+
+![grilles](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/schnapsit.png)

doc/03-grilles.md

@@ -0,0 +1,222 @@
+# Grilles de mise en page
+Il existe deux types principaux de systèmes de grilles dans KNACSS :
+
+- Les grilles à colonnes égales
+- Les grilles à colonnes inégales
+
+Dans les deux cas, la technique associée depuis KNACSS v4 pour concevoir les grilles est **CSS3 Flexbox**, ce qui signifie que la compatibilité de **cette fonctionnalité sera réservée aux [navigateurs modernes](http://caniuse.com/#search=flexbox)** (IE10, Android 4.4+ et tous les autres).
+
+**NOTE pour les utilisateurs de LESS / Sass :** par défaut, les grilles sont activées dans KNACSS. Si vous avez le moindre souci, vérifiez que `@import "_03-grids";` est présent et non commenté dans votre fichier `less/knacss.less` ou `sass/knacss.scss`). 
+
+## Précautions à prendre
+
+Qui dit CSS3 dit précautions à prendre.
+La bonne nouvelle est que Flexbox est plutôt bien reconnu par l'ensemble des navigateurs de la planète; la mauvaise est que certains anciens navigateurs (Android par exemple) ne reconnaissent que certaines versions précédentes des spécifications. Il est donc encore nécessaire d'employer toute une panoplie de préfixes CSS (`-webkit-`, `-moz-`, `-ms-`, ...) pour être certain que vos grilles fonctionneront partout.
+
+Au sein de la version CSS de KNACSS, l'ensemble des préfixes est présent, **vous n'avez donc pas à vous en soucier**.
+
+**Par contre, dans les versions LESS et Sass de KNACSS, les préfixes n'apparaissent pas** pour ne pas polluer la lecture du fichier de travail. **Il vous sera donc nécessaire de les ajouter**, de préférence automatiquement grâce à un plugin ou aux excellents outils que sont [autoprefixer](https://github.com/postcss/autoprefixer) ou [pleeease](http://pleeease.io/).
+
+## Exemple concret
+
+Pour vous faire une idée, et jouer avec les valeurs possibles, vous trouverez [un exemple "bac à sable"](http://codepen.io/raphaelgoetter/pen/BybOag?editors=110) sur CodePen.
+
+**Exemple de grille de colonnes égales :**
+
+HTML :
+```html
+<div class="grid-4"> <!-- parent div (ou autre) de 4 colonnes -->
+    <div>un div ou n'importe quoi d'autre</div>
+    <div>un 2è div ou n'importe quoi d'autre</div>
+    <div>un 3è div ou n'importe quoi d'autre</div>
+    <div>etc.</div>
+</div>
+```
+
+Résultat :
+![grille de largeur égale](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/03-grid-even.png)
+
+**Exemple de grille de colonnes inégales (3/4 - 1/4) :**
+
+HTML :
+```html
+<div class="grid-3-1"> <!-- parent div (ou autre) de 3-1 colonnes -->
+    <div>un div ou n'importe quoi d'autre</div>
+    <div>un 2è div ou n'importe quoi d'autre</div>
+    <div>un 3è div ou n'importe quoi d'autre</div>
+    <div>etc.</div>
+</div>
+```
+
+Résultat :
+![grille de largeur inégale](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/03-grid-uneven.png)
+
+## Mise en oeuvre
+
+Il est très simple de construire une grille, il vous suffit :
+
+- D'un **conteneur**
+- D'autant **d'enfants** que vous souhaitez
+
+Le **conteneur** sera l'élément HTML que vous voulez (`div`, `section`, `ul`, ...). Il vous suffit simplement de le munir d'une classe selon votre choix de grille :
+
+- `.grid-2`, `.grid-3`, `.grid-4`, ... `.grid-12` pour les grilles de largeur égale
+- `.grid-2-1`, `.grid-1-2`, `.grid-3-1`, `.grid-1-3`, `.grid-3-2`, `.grid-2-3`, `.grid-4-1`, `.grid-1-4` pour les grilles de largeurs inégales (`.grid-2-1` vaut pour "2/3 - 1/3" par exemple).
+
+Par défaut, chaque colonne est séparée de sa voisine par une gouttière dont la largeur par défaut est `1em`. Pour modifier ce réglage, il sera nécessaire de passer par la version préprocesseur (LESS, Sass) de KNACSS (voir plus loin).
+
+Les **enfants** directs d'un conteneur, quels qu'ils soient, se répartissent automatiquement au sein de la grille formée par leur conteneur. Par exemple, 6 enfants contenus dans un parent de classe `.grid-3` se répartiront en 3 colonnes de 2 lignes.
+
+## Offsets 
+
+Il vous est très facile de "pousser" un élément à droite ou à gauche de sa ligne dans la grille, et créer ainsi un espacement volontaire, ce que l'on appelle "offset".
+
+Pour cela, appliquez simplement l'une ou l'autre de ces déclarations sur l'élément :
+
+- `margin-left: auto` pour le pousser à droite sur sa ligne (ou avec la classe `.left`)
+- `margin-right: auto` pour le pousser à gauche sur sa ligne (ou avec la classe `.right`)
+
+HTML :
+```html
+<div class="grid-4">
+    <div>un div ou n'importe quoi d'autre</div>
+    <div class="right">je suis poussé à droite</div>
+    <div>un 3è div ou n'importe quoi d'autre</div>
+    <div>etc.</div>
+</div>
+```
+
+Résultat :
+![offset](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/03-offset.png)
+
+## Mise en exergue
+
+Il est possible de mettre un élément particulier en exergue, en **doublant sa taille** par rapport aux autres, tout en conservant un agencement parfait de la grille.
+
+Pour ce faire, appliquez la classe `.flexitem-double` à cet élément.
+
+HTML :
+```html
+<div class="grid-4">
+    <div>un div ou n'importe quoi d'autre</div>
+    <div class="flexitem-double">je suis deux fois plus large que mes frères</div>
+    <div>un 3è div ou n'importe quoi d'autre</div>
+    <div>etc.</div>
+</div>
+```
+
+Résultat :
+![mise en exergue](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/03-double.PNG)
+
+## Pousser au début ou à la fin
+
+Vous pouvez modifier l'ordre d'affichage des éléments au sein d'une grille à l'aide des classes :
+
+- `.flexitem-first` (l'élément apparaîtra avant tous les autres) 
+- `.flexitem-last` (l'élément apparaîtra tout à la fin de la grille)
+
+HTML :
+```html
+<div class="grid-4">
+    <div>un div ou n'importe quoi d'autre</div>
+    <div class="flexitem-first">je m'affiche avant tous mes frères</div>
+    <div>un 3è div ou n'importe quoi d'autre</div>
+    <div>etc.</div>
+</div>
+```
+
+Résultat :
+![preums!](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/03-first.PNG)
+
+## Plus loin avec les préprocesseurs
+
+KNACSS est pensé pour être utilisé à l'aide de preprocesseurs tels que LESS ou Sass. Il existe par conséquent un fichier de variables de configuration et des mixins prévus pour étendre les possibilités des grilles notamment.
+
+### Modifier les variables globales
+
+Les variables de configuration des grilles se trouvent dans le fichier `less/_00-config.less` (pour les utilisateurs de LESS) et `sass/_00-config.scss` (en version Sass) :
+
+```css
+@gutter: 1em;
+@number: 4; // for equal columns
+@left: 2; // left side of uneven columns
+@right: 1; // right side of uneven columns
+```
+
+Il vous suffit de modifier les valeurs de ces variables de config pour répercuter vos préférences sur l'ensemble du projet dès que vos fichiers LESS/Sass seront compilés en CSS.
+
+### Générer des grilles personnalisées
+
+Indépendamment des variables de configuration, rien de vous empêche de créer une grille personnalisée en incluant directement l'un des deux mixins possibles dans vos éléments : 
+
+- `.grid(n)` pour personnaliser une grille de colonnes **égales**. Les arguments sont "n" = nombre de colonnes
+- `.uneven-grid(l,r)` pour personnaliser une grille de colonnes **inégales**. Les arguments sont "l" = pour le ratio de la colonne de gauche,  "r" = pour le ratio de la colonne de droite
+
+#### Grille de colonnes égales en LESS
+
+**Objectif : je souhaite que mon élément `.grid-container` crée une grille de 6 colonnes égales**
+
+LESS (fichier de développement) :
+```css
+.grid-container { 
+	.grid(6); 
+}
+```
+
+CSS compilé (sans Autoprefixer) :
+
+```css
+.grid-container {
+  display: flex;
+  flex-direction: row;
+  flex-wrap: wrap;
+  margin-left: -1em;
+}
+.grid-container > * {
+  flex: 0 0 auto;
+  width: 16.66666667%;
+  display: block;  /* IE fix */
+  border-left: 1em solid transparent;
+  background-clip: padding-box !important; /* no background on border */
+}
+...
+```
+
+#### Grille de colonnes inégales en LESS
+
+**Objectif : je souhaite que mon élément `.grid-truc` crée une grille de 2 colonnes réparties en 2/3 et 1/3.**
+
+LESS (fichier de développement) :
+
+```css
+.grid-truc { 
+	.uneven-grid(2, 1);
+}
+```
+
+CSS compilé (sans Autoprefixer) :
+
+```css
+.grid-truc {
+  display: flex;
+  flex-direction: row;
+  flex-wrap: wrap;
+  margin-left: -1em;
+}
+.grid-truc > * {
+  display: block; /* IE fix */
+  border-left: 1em solid transparent;
+  background-clip: padding-box !important; /* no background on border */
+}
+.grid-truc > *:nth-child(odd) {
+  width: 66.66666667%;
+}
+.grid-truc > *:nth-child(even) {
+  width: 33.33333333%;
+}
+...
+```
+
+## Article associé
+
+Si vous voulez comprendre dans le détail le fonctionnement des grilles Flexbox de KNACSS, je vous invite à suivre l'article d'Alsacréations ["Une grille responsive avec CSS3 Flexbox et LESS (ou Sass)"](http://www.alsacreations.com/tuto/lire/1659-une-grille-responsive-avec-flexbox-et-LESS.html).

doc/04-tableaux.md

@@ -0,0 +1,38 @@
+# Tableaux de données
+
+KNACSS propose une feuille de style minimale appliquée aux tableaux de données ainsi qu'aux éléments disposant d'une classe `.table`.
+
+Pour débuter, KNACSS impose un modèle d'affichage fixé à tous les tableaux via `table-layout: fixed;`. Ainsi, ce ne sera plus le contenu qui décidera de la largeur des cellules, mais ce que vous aurez spécifié dans les tailles CSS.
+
+```css
+table,
+.table {
+  width: 100%;
+  max-width: 100%;
+  table-layout: fixed;
+  border-collapse: collapse;
+  vertical-align: top;
+  border: 1px solid #ccc;
+}
+.table {
+  display: table;
+}
+table#recaptcha_table,
+table.table-auto {
+  table-layout: auto;
+}
+caption {
+  padding: 10px;
+  color: #555;
+  font-style: italic;
+}
+td,
+th {
+  padding: 0.3em 0.8em;
+  border: 1px #aaa dotted;
+  vertical-align: top;
+  min-width: 20px;
+  cursor: default;
+  text-align: left;
+}
+```

doc/05-formulaires.md

@@ -0,0 +1,12 @@
+# Formulaires
+
+Afin d'harmoniser l'affichage par défaut des éléments de formulaires au sein de l'ensemble des navigateurs, un certain nombre de styles est prévu dans KNACSS.
+Pour constituer cette base de "bonnes pratiques", les crédits reviennent notamment aux ressources suivantes :
+
+- [HTML5boilerplate](https://html5boilerplate.com/),
+- [github.com/nathansmith/formalize](http://github.com/nathansmith/formalize),
+- [sitepen.com](http://www.sitepen.com)
+
+Le reset "formulaire" de KNACSS tient compte des éléments suivants : `form`,  `input`,  `fieldset`,  `button`,  `select`,  `label`,  `legend`,  `textarea`,  etc.
+
+Notez également qu'en attribuant la classe `.btn` à un élément, vous le considérerez (et stylerez) tel un bouton de formulaire.

doc/06-helpers.md

@@ -0,0 +1,148 @@
+# Helpers
+
+Les "Helpers" sont des classes purement visuelles et utilitaires (non "sémantiques"), pas très jolie mais rudement pratiques en production pour alléger vos feuilles de styles.
+
+**Attention toutefois !** Ce type de classes conduit fréquemment [à des abus au sein de votre code HTML](http://blog.goetter.fr/2014/11/10/bien-utiliser-un-framework-css/).
+
+Par exemple, Si vous avez 20 images au comportement identique dans la page, ne les affublez pas de classes visuelles multiples telles que `img class="mod clearfix left inbl w200p pas mb1 large-mb2 small-mbn"` mais optez plutôt pour une classe personnalisée : `img class="media"` par exemple.
+
+**Méthode :** Limitez-vous à 4 noms de classes au grand maximum par élément HTML. Si vous pensez qu’il vous en faut davantage, il est temps d’envisager une classe personnalisée, ou de profiter des pré-processeurs CSS.
+
+_Les valeurs de helpers peuvent être modifiées au sein du fichier de configuration LESS / Sass._
+
+## les Helpers de largeur
+
+Largeurs fluides (en pourcentage) :
+
+```css
+.w10 {
+  width: 10%;
+}
+.w20 {
+  width: 20%;
+}
+.w25 {
+  width: 25%;
+}
+...
+.w100 {
+  width: 100%;
+}
+
+```
+
+Largeurs fixes (en pixel) :
+
+```css
+.w50p {
+  width: 50px;
+}
+.w100p {
+  width: 100px;
+}
+.w150p {
+  width: 150px;
+}
+...
+.w960p {
+  width: 960px;
+}
+.w1140p {
+  width: 1140px;
+}
+
+```
+
+Largeurs spéciales :
+
+```css
+.mw960p {
+  max-width: 960px;
+}
+.mw1140p {
+  max-width: 1140px;
+}
+.wauto {
+  width: auto;
+}
+```
+
+
+## les Helpers d'espacement
+
+Les herpers d'espacement comportent des classes dédiées aux marges externes (margin) et aux marges internes (padding).
+
+Leur nommage est assez intuitif :
+
+- p,m = padding, margin
+- a,t,r,b,l = all, top, right, bottom,left
+- s,m,l,n (ou 0) = small, medium, large, none (ou 0)
+
+Exemples :
+
+- `.prs` signifie "padding-right small" (où "small" est défini dans votre fichier de configuration, par défaut 5px)
+- `.man` signifie "margin all none" (fonctionne aussi avec la syntaxe `.ma0`)
+
+### les marges externes (margin)
+
+```css
+.man,
+.ma0 {
+  margin: 0;
+}
+.mas {
+  margin: 10px;
+}
+.mam {
+  margin: 20px;
+}
+.mal {
+  margin: 40px;
+}
+.mtn,
+.mt0 {
+  margin-top: 0;
+}
+.mts {
+  margin-top: 10px;
+}
+.mtm {
+  margin-top: 20px;
+}
+.mtl {
+  margin-top: 40px;
+}
+...
+```
+
+### les marges internes (padding)
+
+```css
+.ptn,
+.pt0 {
+  padding-top: 0;
+}
+.pts {
+  padding-top: 10px;
+}
+.ptm {
+  padding-top: 20px;
+}
+.ptl {
+  padding-top: 40px;
+}
+.prn,
+.pr0 {
+  padding-right: 0;
+}
+.prs {
+  padding-right: 10px;
+}
+.prm {
+  padding-right: 20px;
+}
+.prl {
+  padding-right: 40px;
+}
+...
+```

doc/07-responsive.md

@@ -0,0 +1,118 @@
+# Responsive Webdesign
+
+## Points de rupture
+
+Par défaut, KNACSS tient compte des valeurs de points de rupture suivants :
+
+- "tiny" : correspond à une fenêtre de 480px ou moins
+- "small" : correspond à une fenêtre entre 481px et 768px inclus
+- "medium"correspond à une fenêtre entre 769px et 1024px inclus
+- "large"correspond à une fenêtre entre 1025px et 1280px inclus
+- "extra-large"correspond à une fenêtre entre 1281px et 1600px inclus
+- "ultra-large"correspond à une fenêtre à partir de 1601px
+
+_Les valeurs des points de rupture peuvent être modifiées au sein du fichier de configuration LESS / Sass._
+
+## Préfixes de classe
+
+Pour les points de rupture "large", "medium", "small" et "tiny", des préfixes de classes ont été introduits dans KNACSS :
+
+- `.large-*` : préfixe KNACSS destiné aux styles sur écrans larges
+- `.medium-*` : préfixe KNACSS destiné aux styles sur écrans medium
+- `.small-*` : préfixe KNACSS destiné aux styles sur écrans small
+- `.tiny-*` : préfixe KNACSS destiné aux styles sur écrans tiny
+
+### Exemple : le point de rupture "tiny"
+
+Voici quelques-unes des classes dédiées aux écrans de très petite taille… Le mot-clé `!important` est nécessaire pour être certain que les styles écrasent bien les styles appliqués par défaut.
+
+Masquage / visibilité :
+
+```css
+.tiny-hidden {
+    display: none !important;
+}
+.tiny-visible {
+    display: block !important;
+}
+```
+
+Modèles d'affichage :
+
+```css
+.tiny-no-float {
+    float: none;
+}
+.tiny-inbl {
+    display: inline-block;
+    float: none;
+    vertical-align: top;
+}
+.tiny-row {
+    display: table !important;
+    table-layout: fixed !important;
+    width: 100% !important;
+}
+.tiny-col {
+    display: table-cell !important;
+    vertical-align: top !important;
+}
+```
+
+Largeurs :
+
+```css
+.tiny-w25 {
+    width: 25% !important;
+}
+.tiny-w33 {
+    width: 33.3333% !important;
+}
+.tiny-w50 {
+    width: 50% !important;
+}
+.tiny-w66 {
+    width: 66.6666% !important;
+}
+.tiny-w75 {
+    width: 75% !important;
+}
+.tiny-w100,
+.tiny-wauto {
+    display: block !important;
+    float: none !important;
+    clear: none !important;
+    width: auto !important;
+    margin-left: 0 !important;
+    margin-right: 0 !important;
+    border: 0;
+}
+```
+
+Marges :
+
+```css
+.tiny-man,
+    .tiny-ma0 {
+        margin: 0 !important;
+}
+.tiny-pan,
+.tiny-pa0 {
+    padding: 0 !important;
+}
+```
+
+
+## Règles de styles particulières
+
+```css
+@media (min-width: 1025px) {
+  /* rules for big resources and big screens like: background-images, font-faces, etc. */
+}
+```
+
+```css
+@media (-webkit-min-device-pixel-ratio: 2), (min-resolution: 192dpi), (min-resolution: 2dppx) {
+  /* style adjustments for high density devices */
+}
+```

doc/08-print.md

@@ -0,0 +1,77 @@
+# Styles d'impression
+
+KNACSS impose une mise en forme d'impression par défaut, à savoir :
+
+- suppression des couleurs de fond des éléments
+- suppression des ombrages de boîte et de texte
+- largeur automatique à la page (body)
+- couleur de texte #333, couleur de page blanche, taille de texte 12 points, etc.
+
+```css
+* {
+  background: transparent !important;
+  box-shadow: none !important;
+  text-shadow: none !important;
+}
+body {
+  width: auto !important;
+  margin: auto !important;
+  font-family: serif;
+  font-size: 12pt;
+  background-color: #fff !important;
+  color: #333 !important;
+}
+```
+
+KNACSS gère également les sauts de pages, les lignes veuves et orphelines :
+
+```css
+/* no orphans, no widows */
+  p,
+  .p-like,
+  blockquote {
+    orphans: 3;
+    widows: 3;
+  }
+  /* no breaks inside these elements */
+  blockquote,
+  ul,
+  ol {
+    page-break-inside: avoid;
+  }
+  /* page break before main headers */
+  h1,
+  .h1-like {
+    page-break-before: always;
+  }
+  /* no breaks after these elements */
+  h1,
+  .h1-like,
+  h2,
+  .h2-like,
+  h3,
+  .h3-like,
+  caption {
+    page-break-after: avoid;
+  }
+```
+
+Une classe spécifique permet d'afficher ou de masquer du contenu sur imprimante :
+
+```css
+.print {
+    display: block;
+}
+.no-print {
+    display: none;
+}
+```
+
+Bonus : par défaut, KNACSS décide de rendre toutes les images noir et blanc (sauvons les cartouches d'encre !) :
+
+```css
+img {
+    -webkit-filter: grayscale(100%);
+        filter: grayscale(100%);
+}
+```

doc/09-misc.md

@@ -0,0 +1,71 @@
+# Divers
+
+La feuille de style "fourre-tout" de KNACSS, où l'on retrouve des règles pratiques dans certains contextes, mais pas suffisamment universelles pour être appliquées par défaut dans un framework.
+
+## Liens d'évitement
+
+Les [liens d'évitement](http://www.alsacreations.com/tuto/lire/572-Les-liens-d-evitement.html) sont prévus pour faciliter la navigation au clavier, ils sont indispensable dans une optique de parfaite accessibilité.
+
+KNACSS propose des styles par défaut pour ces liens : masqués au départ, ils deviennent visibles lorsque la touche `tab` est utilisée.
+
+```css
+.skip-links {
+  position: absolute;
+}
+.skip-links a {
+  position: absolute;
+  overflow: hidden;
+  clip: rect(1px, 1px, 1px, 1px);
+  padding: 0.5em;
+  background: black;
+  color: white;
+  text-decoration: none;
+}
+.skip-links a:focus {
+  position: static;
+  overflow: visible;
+  clip: auto;
+}
+```
+
+## Césures
+
+KNACSS gère automatiquement les césures et les mots longs dès lors que le point de rupture "small" est atteint.
+
+```css
+@media (max-width: 768px) {
+  /* you shall not pass */
+  div,
+  textarea,
+  table,
+  td,
+  th,
+  code,
+  pre,
+  samp {
+    word-wrap: break-word;
+    -webkit-hyphens: auto;
+       -moz-hyphens: auto;
+        -ms-hyphens: auto;
+            hyphens: auto;
+  }
+}
+```
+
+## Google maps
+
+KNACSS règle les bugs d'affichage dans le cas spécifique des images google.
+
+```css
+.gm-style img {
+  height: 100%;
+}
+:not(.gm-style) img {
+  height: auto;
+}
+.gm-style img,
+.gmnoscreen img,
+.gmnoprint img {
+  max-width: none !important;
+}
+```

doc/10-styling.md

@@ -0,0 +1,11 @@
+# Décorations diverses
+
+Dans cette feuille de style, KNACSS apporte un minimum de décoration à divers éléments habituels.
+Il ne s'agit pas d'un "reset" mais bien d'une couche de design qu'il n'est bien entendu pas du tout indispensable de conserver.
+
+- les élements de code (`code`, `pre`)
+- le surlignement (`mark`)
+- les contenus en exposant ou en indice (`sup`, `sup`)
+- les citations (`q`, `blockquote`)
+- les séparateurs (`hr`)
+- les tableaux de données

doc/11-wordpress.md

@@ -0,0 +1,5 @@
+# Styles WordPress
+
+Cette feuille de style, exclusivement dédiée au CMS WordPress, constitue en un "reset" de base pour cet outil que nous employons fréquemment au sein de l'agence Alsacréations.fr.
+
+C'est Geoffrey Crofte qui a conçu ce fichier de bonnes pratiques (basée sur un socle proposé par Automattic), n'hésitez pas à le contacter sur son site perso [CreativeJuiz](http://www.creativejuiz.fr/) si vous avez la moindre question à son propos.