docs: update documentation with the list of nox commands available

This commit is contained in:
Adrien Allard 2025-07-15 11:06:12 +02:00
parent 9607ba8e5d
commit 6e5c008347
1 changed files with 23 additions and 3 deletions

View File

@ -43,25 +43,45 @@ Date used for the news is the date the file was created in git.
### HTML generation ### HTML generation
We use https://git.frog-collective.com/collectivit/jean-web to generate the We use <https://git.frog-collective.com/collectivit/jean-web> to generate the
website. Jinja2 templates are stored in the src directory, and use the content website. Jinja2 templates are stored in the src directory, and use the content
loaded from the 'content' folder to generate static pages. Content can be loaded from the 'content' folder to generate static pages. Content can be
markdown document with metadata, or json files. markdown document with metadata, or json files.
### CSS ### CSS
We use the BEM naming convention with the scheme We use the BEM naming convention with the scheme
```css ```css
.block--element__modifier .block--element__modifier
``` ```
See https://getbem.com/naming/ for insigths on the BEM naming convention. See <https://getbem.com/naming/> for insigths on the BEM naming convention.
We use SASS as a CSS extension language (https://sass-lang.com/). We use SASS as a CSS extension language (<https://sass-lang.com/>).
### Dev env ### Dev env
Install the following dependencies to be able to test the website locally: Install the following dependencies to be able to test the website locally:
```sh ```sh
npm install -g browser-sync npm install -g browser-sync
``` ```
Then it's possible to start a local server using the command:
```sh
browser-sync start --server build/ --watch
```
To extract localization messages:
```sh
nox -s extract_messages
```
Then to compile them once localization is done:
```sh
nox -s compile_messages
```