mirror of
https://github.com/locomotivemtl/locomotive-boilerplate.git
synced 2026-01-15 00:55:08 +08:00
[WIP] Start grid doc
This commit is contained in:
47
docs/grid.md
Normal file
47
docs/grid.md
Normal file
@@ -0,0 +1,47 @@
|
|||||||
|
# Grid system
|
||||||
|
|
||||||
|
* [Architectures](#architectures)
|
||||||
|
* [Styles](#styles)
|
||||||
|
* [Build tasks](#build-tasks)
|
||||||
|
* [Config file](#config-file)
|
||||||
|
* [Usage](#usage)
|
||||||
|
* [Example](#example-1)
|
||||||
|
* [Limitations](#limitations)
|
||||||
|
|
||||||
|
## Architectures
|
||||||
|
|
||||||
|
The Grid System is meant to be simple and easy to use. To goal is to obtain way to build light, flexible and reusable way to build layouts.
|
||||||
|
|
||||||
|
### Styles
|
||||||
|
|
||||||
|
Some styles are needed to make it work properly :
|
||||||
|
|
||||||
|
* [`o-grid.scss`](../assets/styles/objects/_grid.scss): Objecy file where the default grid styles are set. Column numbers, modifiers, options.
|
||||||
|
* [`u-grid-columns.scss`](../assets/styles/utilities/_grid-column.scss): Utility file where it generates every possible column styles based on an array of media queries and column numbers.
|
||||||
|
|
||||||
|
### Build tasks
|
||||||
|
|
||||||
|
The generation of columns adds a lot of styles in the css output file. To solve that, a build task is set up to purge unused css generated by [`u-grid-columns.scss`](../assets/styles/utilities/_grid-column.scss) using [PurgeCSS].
|
||||||
|
|
||||||
|
#### Config file
|
||||||
|
|
||||||
|
Depending on your project, you will need to specify all the files that will include the Grid System classes. These files will be parsed by [PurgeCSS] and then a "cleaned" css file will be generated. The styles should also compile everytime the following listed files are changed.
|
||||||
|
|
||||||
|
```json
|
||||||
|
// Charcoal project example
|
||||||
|
"purgeCSS": {
|
||||||
|
"content": [
|
||||||
|
"./www/**/*.html",
|
||||||
|
"./views/app/template/**/*.mustache",
|
||||||
|
"./src/App/Template/*.php",
|
||||||
|
"./assets/scripts/**/*" // use case: el.classList.add('u-gc-1/2')
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
Test
|
||||||
|
|
||||||
|
|
||||||
|
[purgecss]: https://purgecss.com/
|
||||||
Reference in New Issue
Block a user