diff --git a/doc/00-commencer.md b/doc/00-commencer.md deleted file mode 100644 index 2e8dfa9..0000000 --- a/doc/00-commencer.md +++ /dev/null @@ -1,129 +0,0 @@ -# KNACSS - -http://www.knacss.com - -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). - -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 tel que Sass, le micro-framework KNACSS est employé quotidiennement sur toute sorte de projets web quel que soit son type ou son envergure. - -## Compatibilité - -KNACSS est - dans sa grande majorité - compatible avec l'ensemble des navigateurs desktop et mobiles à partir d'IE10 inclus. - -## Installation - -Selon votre profil (débutant, utilisateur de Sass, adepte de Bower / npm), l'installation est différente. - -### Vous êtes débutant ou pressé ? - -La version courte est "il n'y a rien à installer". - -KNACSS n'est constitué que d'un seul fichier CSS (minifié ou non selon vos goûts) : - -- en version [CSS classique et lisible](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/css/knacss-unminified.css) -- ou en [version minifiée](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/css/knacss.css) - -Si vous ne comptez pas décortiquer le fichier CSS, il est préférable d'opter pour la version minifiée, plus légère. -Il vous suffit ensuite de l'insérer à votre page HTML, avant votre propre feuille de style, bien entendu : - -```HTML - - - - - Vive les knacks! - - - - - - - - -``` - -### Vous préférez Sass ? - -KNACSS est conçu et pensé pour être adapté au préprocesseur Sass. Nos fichiers de travail sont donc par défaut plutôt des `.scss` et non des `.css`. - -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 [dossier de configuration](https://github.com/alsacreations/KNACSS/tree/v6/sass/_config) contenant toutes les variables du projet, les breakpoints et les mixins est intégré. -Libre à vous de modifier ces fichiers selon les contraintes de votre projet. - -La version Sass, à compiler par vos soins, sera bien évidemment plus malléable grâce à l'apport de variables et fonctions. -Vous pouvez également inclure ou non les fichiers partiels qui vous intéressent (tableaux, formulaires, grilles, WordPress, classes utilitaires, etc.). - -Téléchargez [KNACSS complet](https://github.com/alsacreations/KNACSS/archive/master.zip) pour bénéficier de toute l'architecture de l'outil, avec les fichiers Sass, package.json et gulpfile.js si nécessaires. - -### Installation via Bower, npm ou yarn - -- via [Bower](http://bower.io/) : `bower install knacss` -- via [npm](https://www.npmjs.com/) : `npm install knacss` -- via [yarn](https://yarnpkg.com/) : `yarn install knacss` ou `yarn add knacss` - -**Attention**, si vous importez KNACSS automatiquement via Bower, npm ou yarn (par exemple dans un dossier `vendor` ou `node_modules`), les fichiers de configuration (variables par exemple) risquent d'être écrasés à 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`**. - - -## Comment débuter ? - -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. - -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. - -Dans le cas d'un usage via Sass, vos deux fichiers de travail principaux seront : -- le fichier `sass/_config/_variables.scss` contenant toutes les variables du projet à définir une fois pour toute au départ -- le fichier `sass/knacss.scss` qui importe tous les autres fichiers que vous risquez d'employer dans votre projet. - -En phase d'intégration, il vous suffit de compiler le fichier `sass/knacss.scss` pour obtenir votre fichier CSS final. - - - -### 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 la version 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 à l'excellent outil qu'est [autoprefixer](https://github.com/postcss/autoprefixer). - -### Mise à jour depuis une version précédente de KNACSS ? - -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.*.*`. - -Voici les principales modifications dont il faudra tenir compte lors d'une bascule vers la version 6 de KNACSS : - -#### Modifications majeures depuis la `5.*.*` - -- 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) - -#### 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) -- ajout de la library include-media (http://include-media.com/) -- grille "grillade" à présent en mobile first - -#### Modifications majeures depuis la `3.*.*` - -- 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` - -### Utilisateur de SPIP ? - -Le CMS SPIP impose une classe générique `.fr` sur l'élément ``, or cette classe est également employée pour les positionnements flottants dans KNACSS. - -Si vous êtes un utilisateur de SPIP, nous vous conseillons de modifier les fichiers CSS de KNACSS et de remplacer les classes `.fr` et `.fl` par `:not(html) .fr` et `:not(html) .fl` - -## 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) diff --git a/doc/01-typo-et-reset.md b/doc/01-typo-et-reset.md deleted file mode 100644 index 7f2568f..0000000 --- a/doc/01-typo-et-reset.md +++ /dev/null @@ -1,34 +0,0 @@ -# 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 volontairement 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; -} -``` diff --git a/doc/02a-layout-alignements.md b/doc/02a-layout-alignements.md deleted file mode 100644 index ce3705c..0000000 --- a/doc/02a-layout-alignements.md +++ /dev/null @@ -1,50 +0,0 @@ -# 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` bénéficient d'un autre pouvoir : celui de toujours se pousser sous un flottant précédent. Ils sont dédiés aux empilements verticaux des contenus. - -## Concrètement : je veux faire quoi ? - -### Centrer horizontalement - -#### Du texte ou une image - -HTML : -```html -
- aïe ça pique -
-``` - -#### Un bloc - -HTML : -```html -
-
centré horizontalement
-
-``` - -### Centrer verticalement - -![centrer verticalement](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/02-layout.png) - - -```html -
-
centré horizontalement et verticalement
-
-``` diff --git a/doc/02b-layout-positionnement.md b/doc/02b-layout-positionnement.md deleted file mode 100644 index 4d9ff77..0000000 --- a/doc/02b-layout-positionnement.md +++ /dev/null @@ -1,139 +0,0 @@ -# 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 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, il 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 -
premier
-
deuxième
-``` - -- **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 -
premier
-
deuxième
-``` - -- **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é - - -#### Flexbox - -HTML : -```html -
-
premier
-
deuxième
-
-``` - -- **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 -
premier
-
deuxième
-``` - -#### inline-block et inline-block - -Pas possible - - -#### Flexbox - -HTML : -```html -
-
premier
-
deuxième
-
-``` - -### 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 - -#### inline-block et inline-block - -Pas possible - - -#### Flexbox - -Là aussi c'est automatique : les enfants d'un conteneur `flexbox` ont tous par défaut la même hauteur. - -HTML : -```html -
-
premier
-
deuxième
-
-``` - -### 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 ! - -![grilles](https://raw.githubusercontent.com/raphaelgoetter/KNACSS/master/doc/illust/schnapsit.png) diff --git a/doc/03-grilles.md b/doc/03-grilles.md deleted file mode 100644 index d9c8fdb..0000000 --- a/doc/03-grilles.md +++ /dev/null @@ -1,25 +0,0 @@ -# Grilles de mise en page - -"Grillade" est un système de grille simple et élaboré avec CSS3 Flexbox. Il est intégré par défaut dans le micro-framework KNACSS d'Alsacréations mais peut être utilisé de manière autonome sans nécessiter KNACSS ou d'autre dépendance. - -Grillade a les caractéristiques globales suivantes : - -- Double système de grille : - - Mono-ligne : possibilité par défaut d'émuler [l'objet "autogrid"](http://codepen.io/raphaelgoetter/pen/KMgBJd?editors=1100) : `.grid` affiche sur une ligne autant d'enfants que nécessaires (et de taille identique) - - Multi-ligne : possibilité de passer en multi-lignes dès que l'on ajoute un suffixe numéroté (ex. `.grid-2`, `.grid-3` ... `.grid-12`) -- "Mobile-first" : par défaut une grille sera disposée sur une colonne, et ne s'active que lorsque l'écran dépasse le breakpoint `$tiny` -- Largeurs de colonnes fluides et égales par défaut, mais possibilité de définir individuellement la taille de chaque enfant si besoin (ex. `.one-half`, `.one-third`, `.one-quarter`, `.two-thirds`, etc.) -- Possibilité d'inverser toute la grille grâce au suffixe `--reverse` -- Possibilité de préciser le nombre de colonnes en taille d'écran "small" à l'aide du suffixe `-small-X` (X colonnes) -- Possibilité d'appliquer une gouttière entre les éléments -- Possibilité d'offsets (pull / push) -- Possibilité de réordonner les éléments (au début / à la fin) -- Possibilité de réaliser ses propres grilles multi-colonnes via un mixin Sass. ex. `.o-grid-perso { @include grid(4, 3rem); }` - -Spécificités techniques : - -- Grillade est basé sur CSS3 Flexbox, ce qui le rend incompatible avec les anciennes versions d'Internet Explorer (IE9 inclus) ainsi que certains anciens navigateurs (Android <4.4 par exemple) -- Les préfixes CSS3 (`-webkit-`, `-moz-`, `-ms-`, …) sont pris en charge au sein de la version CSS de Grillade, mais pas dans sa version Sass. Il vous sera donc nécessaire de les ajouter, de préférence automatiquement grâce à l'excellent outil autoprefixer. -- Les valeurs par défaut des points de rupture responsive (Breakpoints) de Grillade sont : `$tiny = 544px` et `$small = 768px`, vous pouvez modifier ou ajouter des valeurs dans la version Sass. - -**documentation complète, illustrée et détaillée sur le site http://grillade.knacss.com** diff --git a/doc/04-tableaux.md b/doc/04-tableaux.md deleted file mode 100644 index 48a71a2..0000000 --- a/doc/04-tableaux.md +++ /dev/null @@ -1,38 +0,0 @@ -# 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; -} -``` diff --git a/doc/05-formulaires.md b/doc/05-formulaires.md deleted file mode 100644 index e74af1e..0000000 --- a/doc/05-formulaires.md +++ /dev/null @@ -1,12 +0,0 @@ -# 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. diff --git a/doc/06-helpers.md b/doc/06-helpers.md deleted file mode 100644 index 1ffd655..0000000 --- a/doc/06-helpers.md +++ /dev/null @@ -1,148 +0,0 @@ -# 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 helpers 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; -} -... -``` diff --git a/doc/07-responsive.md b/doc/07-responsive.md deleted file mode 100644 index 30ccffa..0000000 --- a/doc/07-responsive.md +++ /dev/null @@ -1,198 +0,0 @@ -# Responsive Webdesign - -## Points de rupture - -Par défaut, KNACSS tient compte des valeurs de points de rupture suivants : - -``` -// breakpoints (choose unit you prefer) -$tiny: 480px; // or 'em' if you prefer, of course -$small: 576px; -$medium: 768px; -$large: 992px; -$extra-large: 1200px; -``` - -_Les valeurs des points de rupture peuvent être modifiées au sein du fichier de configuration LESS / Sass._ - -## Convention d'écriture - -### Choix des valeurs de breakpoints - -1. Choisir principalement des valeurs de breakpoints selon votre design, pas par rapport à des devices (se servir des variables de breakpoints fournies si l'on ne peut pas se baser sur son design) -2. En plus de vos propres valeurs, il est possible d'employer : - - les variables fournies (`$tiny`, `$small`, `$medium`, `$large`), - - mais aussi des alias qui représentent des intervalles et que l'on utilise sous forme de mixins (voi plus bas) -3. Éviter de multiplier les valeurs. Un maximum de 5 ou 6 breakpoints devrait suffire dans la grande majorité des projets -4. **Pour éviter les intervalles qui se chevauchent, ou des Media Queries trop variés, adopter la convention suivante pour définir les intervalles : -`(max-width: ($BP - 1)) and (min-width: $BP)`** - -Exemple : - -Non, pas bien : -``` -@media (min-width: 767px) {...} -@media (max-width: 768px) {...} -``` - -Oui, bien : -``` -@media (min-width: 768px) {...} -@media (max-width: 767px) {...} -@media (max-width: $small-screen) {...} -@media (min-width: $small-screen + 1) and (max-width: $large-screen) {...} -``` - -## Mixins "Alias" - -En addition aux variables, des mixins de breakpoints "utilitaires" (des "alias" des valeurs précédentes) liées aux tailles de devices (forcément indicatifs, mais simples à retenir) sont prévues. - -Les mixins sont activés à l'aide de l'instruction `respond-to()`. Exemple d'usage : - -``` -// styles -.when-tablet-up { - @include respond-to("small-up") { - background: green; - color: #fff; - } -} -.is-hidden-mobile { - @include respond-to("tiny") { - display: none; - } -} -``` - -``` -// Additionnal "utility" breakpoints aliases -// ex. @include respond-to("medium-up") {...} -@function breakpoint($bp) { - @if $bp == 'tiny' { - @return '(max-width: #{$tiny})'; - } - @else if $bp == 'small' { - @return '(max-width: #{$small})'; - } - @else if $bp == 'medium' { - @return '(max-width: #{$medium})'; - } - @else if $bp == 'large' { - @return '(max-width: #{$large})'; - } - @else if $bp == 'extra-large' { - @return '(max-width: #{$extra-large})'; - } - @else if $bp == 'tiny-up' { - @return '(min-width: #{$tiny + 1})'; - } - @else if $bp == 'small-up' { - @return '(min-width: #{$small + 1})'; - } - @else if $bp == 'medium-up' { - @return '(min-width: #{$medium + 1})'; - } - @else if $bp == 'large-up' { - @return '(min-width: #{$large + 1})'; - } - @else if $bp == 'extra-large-up' { - @return '(min-width: #{$extra-large + 1})'; - } - @else if $bp == 'retina' { - @return '(-webkit-min-device-pixel-ratio: 2), (min-resolution: 192dpi), (min-resolution: 2dppx)'; - } -} - -@mixin respond-to($value) { - $string: breakpoint($value); - @media screen and #{$string} { - @content; - } -} -``` - - - - -Voir le CodePen : http://codepen.io/raphaelgoetter/pen/EyRwAp/?editors=1100 - - -## 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; -} -``` - -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; -} -``` diff --git a/doc/08-print.md b/doc/08-print.md deleted file mode 100644 index ac19d9e..0000000 --- a/doc/08-print.md +++ /dev/null @@ -1,66 +0,0 @@ -# Styles d'impression - -KNACSS impose une mise en forme d'impression par défaut, à savoir : - -- suppression des ombrages de boîte et de texte -- largeur automatique à la page (body) - -```css -* { - background: transparent !important; - box-shadow: none !important; - text-shadow: none !important; -} - -body { - width: auto; - margin: auto; - font-family: serif; - font-size: 12pt; -} -``` - -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; -} -``` - diff --git a/doc/09-misc.md b/doc/09-misc.md deleted file mode 100644 index c75bdb2..0000000 --- a/doc/09-misc.md +++ /dev/null @@ -1,59 +0,0 @@ -# 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 "$tiny" est atteint. - -``` -// hyphens on tiny screens -@media (max-width: $tiny) { - /* you shall not pass */ - div, - textarea, - table, - td, - th, - code, - pre, - samp { - word-wrap: break-word; - hyphens: auto; - } -} - -// use .no-wrapping to disallow hyphens on tiny screens -@media (max-width: $tiny) { - .no-wrapping { - word-wrap: normal; - hyphens: manual; - } -} -``` diff --git a/doc/10-styling.md b/doc/10-styling.md deleted file mode 100644 index 8a36168..0000000 --- a/doc/10-styling.md +++ /dev/null @@ -1,11 +0,0 @@ -# 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`, `sub`) -- les citations (`q`, `blockquote`) -- les séparateurs (`hr`) -- les tableaux de données diff --git a/doc/11-wordpress.md b/doc/11-wordpress.md deleted file mode 100644 index 2a37e00..0000000 --- a/doc/11-wordpress.md +++ /dev/null @@ -1,5 +0,0 @@ -# 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. diff --git a/doc/illust/02-layout.png b/doc/illust/02-layout.png deleted file mode 100644 index 2ecf045..0000000 Binary files a/doc/illust/02-layout.png and /dev/null differ diff --git a/doc/illust/03-double.PNG b/doc/illust/03-double.PNG deleted file mode 100644 index 2e3da4c..0000000 Binary files a/doc/illust/03-double.PNG and /dev/null differ diff --git a/doc/illust/03-first.PNG b/doc/illust/03-first.PNG deleted file mode 100644 index f87b292..0000000 Binary files a/doc/illust/03-first.PNG and /dev/null differ diff --git a/doc/illust/03-grid-even.png b/doc/illust/03-grid-even.png deleted file mode 100644 index 929f32a..0000000 Binary files a/doc/illust/03-grid-even.png and /dev/null differ diff --git a/doc/illust/03-grid-uneven.png b/doc/illust/03-grid-uneven.png deleted file mode 100644 index e69d388..0000000 Binary files a/doc/illust/03-grid-uneven.png and /dev/null differ diff --git a/doc/illust/03-layout1.png b/doc/illust/03-layout1.png deleted file mode 100644 index 2b0061b..0000000 Binary files a/doc/illust/03-layout1.png and /dev/null differ diff --git a/doc/illust/03-layout2.png b/doc/illust/03-layout2.png deleted file mode 100644 index 777c2d6..0000000 Binary files a/doc/illust/03-layout2.png and /dev/null differ diff --git a/doc/illust/03-layout3.png b/doc/illust/03-layout3.png deleted file mode 100644 index 410993c..0000000 Binary files a/doc/illust/03-layout3.png and /dev/null differ diff --git a/doc/illust/03-layout4.png b/doc/illust/03-layout4.png deleted file mode 100644 index f0e567f..0000000 Binary files a/doc/illust/03-layout4.png and /dev/null differ diff --git a/doc/illust/03-offset.png b/doc/illust/03-offset.png deleted file mode 100644 index a35f4f2..0000000 Binary files a/doc/illust/03-offset.png and /dev/null differ diff --git a/doc/illust/breakpoints.png b/doc/illust/breakpoints.png deleted file mode 100644 index 97666f0..0000000 Binary files a/doc/illust/breakpoints.png and /dev/null differ diff --git a/doc/illust/imbriquee.png b/doc/illust/imbriquee.png deleted file mode 100644 index cc76705..0000000 Binary files a/doc/illust/imbriquee.png and /dev/null differ diff --git a/doc/illust/schnapsit.png b/doc/illust/schnapsit.png deleted file mode 100644 index 53a5945..0000000 Binary files a/doc/illust/schnapsit.png and /dev/null differ