Chill-manuals/README.md

66 lines
1.5 KiB
Markdown
Raw Permalink Normal View History

2021-08-26 13:25:24 +00:00
Manuels Vendée
==============
2021-07-26 13:11:23 +00:00
2022-03-27 17:13:14 +00:00
## LFS
:warning: Git LFS is activated on this report.
Ensure that `git lfs` is installed on your system. You can install git lfs with the command `git lfs install`.
Since you install it on your machine, no further step is required.
2021-07-26 13:11:23 +00:00
## Compilation
`docker-compose` est utilisé pour compiler le manuel.
Commande:
```bash
docker-compose up
```
2021-08-26 13:25:24 +00:00
Le fichier généré est `user-manual.pdf` et `admin-manual.pdf`
2021-07-26 13:11:23 +00:00
2022-03-11 13:25:09 +00:00
Si vous avez une (bonne) version de pandoc sur votre PC, on peut faire sans docker avec:
```bash
bash build-pandoc.sh
bash build-pandoc.sh pdf admin
```
` bash build-pandoc.sh` est par défaut équivalent à `bash build-pandoc.sh pdf user`.
2021-07-26 13:11:23 +00:00
### Utilisateur
L'utilisateur qui exécute la compilation est, par défaut, l'utilisateur ayant l'id `1000`.
## Dépendances latex
### Awesomebox
Pour créer des "box": https://www.ctan.org/tex-archive/graphics/awesomebox
2022-03-03 12:30:13 +00:00
2022-03-23 15:10:12 +00:00
### Taille des images
Pour changer la taille de toutes les images d'un coup, par ex. à 85%:
remplacer dans `eisvogel.tex` la ligne
```
\setkeys{Gin}{width=\maxwidth,height=\maxheight,keepaspectratio}
```
par
```
\setkeys{Gin}{width=.85\maxwidth,height=\maxheight,keepaspectratio}
```
Si on laisse les images à 100%, beaucoup de pages blanches apparaissent.
2022-03-11 13:25:09 +00:00
### Correcteur orthographiques
2022-03-27 17:13:14 +00:00
Please, utilisons un correcteur orthographique pour le français pour nous éviter toutes les fautes de frappes et autres. Ex: https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker-french