Long live KNACSS Reborn

This commit is contained in:
Raphaël Goetter 2020-11-26 08:46:55 +01:00
parent 43ae752103
commit fa7b0853e7
37 changed files with 27 additions and 66 deletions

0
.editorconfig Normal file → Executable file
View File

0
.gitattributes vendored Normal file → Executable file
View File

0
.gitignore vendored Normal file → Executable file
View File

0
.sass-lint.yml Normal file → Executable file
View File

0
LICENSE Normal file → Executable file
View File

63
README.md Normal file → Executable file
View File

@ -4,65 +4,12 @@
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, grille de mise en forme).
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 projet web quel que soit son type ou son envergure.
**Né en 2012 et après près de 10 années de bons et loyaux services, le projet initial « KNACSS » d'Alsacréations laisse place à une toute nouvelle version, totalement remaniée : KNACSS Reborn.**
**Ce repo n'est plus maintenu est est dorénavant remplacé par celui de KNACSS Reborn : <https://github.com/raphaelgoetter/knacss-reborn>**
## Documentation
- [**Documentation et Guide de styles**](https://www.knacss.com/doc.html)
- [**Documentation KNACSS Reborn**](https://www.knacss.com/doc.html)
- [**Pense-bête en PDF**](https://www.knacss.com/assets/pdf/knacss7-cheatsheet.pdf)
- Site web de présentation de KNACSS : <http://knacss.com>
## Fonctionnalités
- 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
## Compatibilité
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.
## Installation
Voir la documentation.
## Mise à jour depuis une version précédente de KNACSS
La version `7.*.*` 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.
Voici les principales modifications dont il faudra tenir compte lors d'une mise à jour&nbsp;:
### Modifications majeures entre la v7 et la v6
- architecture globale revisitée (vendor, config, library, components)
- variables de projet modifiées et renommées
- refonte complète du système de grille (dorénavant basé sur Grid Layout)
- déplacement des variables de gouttières de grillade.scss vers variables.scss
- déplacement des variables de breakpoints de breakpoints.scss vers variables.scss
Pour tous détails, voir le fichier Changelog.
### Modifications majeures entre la v6 et la v5
- la 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'outil *include-media* (crée des bugs d'encodage, nécessite un temps d'apprentissage, et n'apporte pas grand chose au final)
### Modifications majeures entre la v5 et la v4
- 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 entre la v4 et la v3
- La rétrocompatibilité n'est pas préservée pour certains noms de classes ( `.left`, `.start`, `.fl`, `.table-`, `.flex-start`, `.flex-end`)&nbsp;: `.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`
- Site web de présentation de KNACSS : <http://knacss.com> (ancien)

0
bower.json Normal file → Executable file
View File

30
changelog.md Normal file → Executable file
View File

@ -1,11 +1,25 @@
# Changelog
## Changelog v7.1.3 (12 février 2020)
## Changelog 2020/11
- correctif :
- ce présent tag `7.1.3` corrige le tag précédent
- tag erroné : `7.1.2` (correspondant partiellement à la branche `v8` en développement) = ne pas utiliser !
- précédent tag correct : `7.1.0`
Né en 2012 et après près de 10 années de bons et loyaux services, le projet initial « KNACSS » d'Alsacréations laisse place à une toute nouvelle version, totalement remaniée : KNACSS Reborn.
## Changelog v8.0.0 (xxx 2019)
- Architecture : mise à jour du reset, suppression des reset vendors (Reboot de Boostrap)
- Architecture : renommage de dossiers à la "7-1 pattern": `_config` > `abstracts`, `_library` > `base`, et du fichier `_base.scss` en `_reset.scss`
- Architecture : modification de l'ordre d'import des fichiers : les utilitaires sont importées à la fin à présent
- Compatibilité : support passé de IE10 à IE11 (browserlist)
- Compatibilité : Browserslist devenu `.browserslistrc` et mise à jour du support à `>0.25% not op_mini all`
- Compatibilité : fichier gulpfile.js dorénavant compatible Gulp 4
- Compatibilité : versions exactes des dépendances dans package.json (pour éviter "latest")
- Grillade :renommage des classes `grid-` en `grillade-` pour éviter tout conflit
- Grillade : ajout du constructeur `medium-X` en plus de `small-X`
- Grillade : ajout des constructeus `-start`, `-end`, `-center`, `-space-between`, `-space-around`, `-space-evenly` pour l'alignement général de la grille
- Divers : ajout d'une variable pour supporter ou non IE11 : `$ie: true !default;`.
- Divers :ajout d'une variable pour supporter ou non WordPress : `$wordpress: false !default;`.
- Divers :`visually-hidden` devient un mixin
- Divers :corrections typo
## Changelog v7.1.2 (30 janvier 2019)
@ -57,7 +71,7 @@
## Changelog v7.0.1 (22 décembre 2017)
- meilleure gestion des hyphens
- mise en commentaire du fix SVG pour IE11
- mise en commentaire du fix SVG our IE11
## Changelog v7.0.0 (août - novembre 2017)
@ -185,7 +199,7 @@
## Changelog v4.4.2 (24 décembre 2015)
- correction d'un bug responsive des classes `.flex-item-double`
- création de la feuille de style dédiée aux grilles : *grillade.css* pour ceux qui souhaitent se contenter des grilles de KNACSS
- création de la feuille de style dédiée aux grilles : _grillade.css_ pour ceux qui souhaitent se contenter des grilles de KNACSS
## Changelog v4.4.0 (12 décembre 2015)
@ -295,7 +309,7 @@ Nouveaux noms :
## Vite fait
- grosse remise à jour, orientée vers les technos modernes (flexbox, rem, calc, ...) et moins de "bidouille"
- grosse remise à jour, orientée vers les technos modernes (flexbox, rem, calc, ...) et moins de "bidouille"
- fin du support d'IE6-IE8 Si vous souhaitez utiliser KNACSS sur d'anciens navigateurs, préférez la [Version 3](https://github.com/raphaelgoetter/KNACSS/tree/3.1.0)
- ajout du reset [normalize.css](http://necolas.github.io/normalize.css/)
- un grand merci à @7studio pour ses conseils et observations sur la version beta de KNACSS 4.0

0
css/grillade-flex.css Normal file → Executable file
View File

0
css/grillade-grid.css Normal file → Executable file
View File

0
css/knacss-unminified.css Normal file → Executable file
View File

0
css/knacss.css Normal file → Executable file
View File

0
gulpfile.js Normal file → Executable file
View File

0
package-lock.json generated Normal file → Executable file
View File

0
package.json Normal file → Executable file
View File

0
sass/_config/_mixins.scss Normal file → Executable file
View File

0
sass/_config/_variables.scss Normal file → Executable file
View File

0
sass/_library/_layout.scss Normal file → Executable file
View File

0
sass/_library/_print.scss Normal file → Executable file
View File

0
sass/_library/_responsive.scss Normal file → Executable file
View File

0
sass/_library/_utilities.scss Normal file → Executable file
View File

0
sass/_library/_wordpress.scss Normal file → Executable file
View File

0
sass/_library/grillade-flex.scss Normal file → Executable file
View File

0
sass/_library/grillade-grid.scss Normal file → Executable file
View File

0
sass/components/_alerts.scss Normal file → Executable file
View File

0
sass/components/_arrows.scss Normal file → Executable file
View File

0
sass/components/_badges.scss Normal file → Executable file
View File

0
sass/components/_buttons.scss Normal file → Executable file
View File

0
sass/components/_checkbox.scss Normal file → Executable file
View File

0
sass/components/_forms.scss Normal file → Executable file
View File

0
sass/components/_media.scss Normal file → Executable file
View File

0
sass/components/_skip-links.scss Normal file → Executable file
View File

0
sass/components/_tables.scss Normal file → Executable file
View File

0
sass/components/_tabs.scss Normal file → Executable file
View File

0
sass/components/_tags.scss Normal file → Executable file
View File

0
sass/knacss.scss Normal file → Executable file
View File

0
yarn.lock Normal file → Executable file
View File