web/README.md

46 lines
1.6 KiB
Markdown
Raw Normal View History

2022-04-03 03:15:21 +02:00
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.
2023-02-14 23:18:17 +01:00
**/!\ Le script `generate.sh` est pensé pour mon utilisation. /!\\** Vous pouvez
2023-01-18 00:04:27 +01:00
essayer de l'utiliser pour votre site mais c'est à vos risques et périles.
2023-02-14 23:18:17 +01:00
N'hésitez pas à utiliser `generate.sh -h` pour voir comment l'utiliser.
2023-01-18 00:04:27 +01:00
2022-04-02 16:25:15 +02:00
# Dépendances
* `htmlize` et `org` (par défaut dans Emacs).
2023-01-18 00:04:27 +01:00
* Docker si vous souhaitez tester le site en local avec les images.
2022-04-02 16:25:15 +02:00
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`.