cours/README.md
2023-09-28 20:40:45 +02:00

56 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 vous de licence Pro ADSILLH (*Administration et Développement
de Système d'Information sous Licences Libres et Hybrides*) puis continuent avec
le Master IDI (*Igénieurie de l'Informatique*)
Ces notes sont aussi remplie de coquilles, mais si vous me les sgnlez 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 project comporte un environement 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
```