web/README.md

45 lines
1.6 KiB
Markdown

Dépot git de mon site web. Contient des scripts permettant de générer les
fichiers html, à partir de fichiers ou org ainsi que de lier la partie annuaire
avec le reste.
**/!\ Le script `generate.sh` est pensé pour mon utilisation. /!\\** Vous pouvez
essayer de l'utiliser pour votre site mais c'est à vos risques et périles.
N'hésitez pas à utiliser `generate.sh -h` pour voir comment l'utiliser.
# Dépendances
* `htmlize` et `org` (par défaut dans Emacs).
* Docker si vous souhaitez tester le site en local avec les images.
Dans Emacs: `M-x` package-install `RET` htmlize `RET`
# Construire le site
`./generate.sh`
# Rajouter des liens / langues
## Langues
Pour rajouter des langues, il suffit de créer un dossier dans `lang`. Il faut
ensuite modifier le fichier `header.html` en rajoutant la langue dans la `div`
lang. La ligne doit ressembler à ceci (où `lang` est le nom de la nouvelle
langue) :
```html
<a href="/lang/%file%">LANG</a>
```
Le fichier `lang/links.config` contient des colognes indiquant les différents
noms de fichiers entre les différentes langues, permettant ainsi le bouton pour
changer de langue en haut à droite des différentes pages.
## Liens dans le menu
Pour rajouter des liens dans le menu principal, il faut écrire dans le fichier
`lang/<langue>/header.link`, dans la liste `%links`. Il est possible de mettre
une ligne en commentaire en la commencant avec `#`. Il faut sinon suivre cette
structure : `fichier.html : nom du lien dans le menu`.
Il est aussi possible de changer le sous-titre du site dans la balise
`%subtitle`.