Newer
Older
# Pour créer un site web et ressources d'une UE avec Hugo
[La page de l'UE est ici](http://alexandre.meyer.pages.univ-lyon1.fr/lifapcd/)
Le site web est désormais fabriqué par ```Hugo``` (thème [congo](https://jpanther.github.io/congo/)). les sources se trouvent dans le répertoire ```web```. Le site web est mis à jour par intégration continue (CI/CD) à chaque fois que vous faites un push (rien besoin d'autre, à part attendre quelques secondes). Le script d'intégration continue est ```.gitlab-ci.yml```. Pour voir le résultat du script de génération, depuis l'interface allez dans Buil/CI/Jobs.
Le fichier ```site/config.toml``` permet de configurer la génération du site. Mais normalement il n'y a pas besoin d'y toucher.
* Les pages web sont générées à partir du répertoire ```web/content```.
* Par exemple ```web/content/doc``` peut contenir les documents généraux de l'UE (pdf);
* La page principale du site est ```web/content/_index.html```. Il faut bien laissé le ```_```, il indique qu'il y a des sous-répertoires
* ```web/static``` : les fichiers générales (images, icones, etc.) sont à ranger dedans. Par exemple, il y a
* Pour changer l'icone de la page web, il faut générer des icones avec un [flavicon générator](https://favicon.io/favicon-generator/), copier toutes les images dans le repertoire `static` et ajouter dans `config.toml` une ligne dans `param` avec `favicon = "favicon.ico"`.
Par défaut, gitlab ajoute des '-' un peu partout, vous pouvez changer l'adresse web dans Settings/General/Advanced/Change path.
# Si problème de thème non utilisé
Dans deploy/page il ne faut pas cocher "Use unique domain"
## Tester le site en local
Pour tester vos mises à jour en local :
* installer hugo : ```sudo apt install hugo```
* dans le répertoire web, faire ```hugo serve```
* dans votre navigateur, entrez l'url ```localhost:8000```
Vous pouvez aussi essayer de contruire le site en static en faisant juste ```hugo``` : le site sera constuit dans le répertoire public.
Pour convertir du DOKUWIKI en Markdown, on peut utiliser pandoc??? (todo) ou certains web en ligne.