cours/README.md
2023-10-03 18:39:04 +02:00

55 lines
1.5 KiB
Markdown

Notes de cours
--------------
Dépôt git pour la construction d'un site statique avec [Hugo](https://gohugo.io)
reprenant l'ensemble de mes notes de cours et TD machine mises au propre (J'ai
toujours beaucoup de retard...). Ces notes commencent avec les cours de licence
Pro ADSILLH (*Administration et Développement de Système d'Information sous
Licences Libres et Hybrides*) puis continuent avec le Master IDI (*Ingénierie de
l'Informatique*)
Ces notes sont aussi remplies de coquilles, mais si vous me les signalez je me
ferai un plaisir de les corriger.
Le projet dispose d'un *Makefile* afin d'utiliser `make` pour la génération des
fichiers et le déploiement.
## Construction du site
Pour que la construction du site fonctionne, il faut installer Hugo et le thème
mainroad. Si vous utilisez *Nix* ce projet comporte un environnement déjà prêt,
il suffit de lancer la commande suivante pour l'activer :
```shell
nix-shell shell.nix
```
Pour activer le serveur web intégré à Hugo, il suffit de lancer la commande
(dans le répertoire racine du dépôt) :
```shell
$ make serve
```
Pour construire les fichiers statiques du site, il suffit de faire:
```
make build
```
## Déploiement
Une fois le site construit, il est possible de le déployer en utilisant la
cible `deploy`. Il faut auparavant créer le fichier `include.mk` à la racine de
projet avec les variables suivante:
```makefile
DEPLOY_SERVER=monserveur.example.com
DEPLOY_FOLDER=~/www/lpro/
```
Puis lancer la commande:
```
make deploy
```