Pour créer un site web et ressources d'une UE avec Hugo

La page de l'UE est ici

Explication de la génération

Le site web est désormais fabriqué par Hugo (thème 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
  • web/static/images pour les images du site;
• Pour changer l'icone de la page web, il faut générer des icones avec un flavicon générator, copier toutes les images dans le repertoire static et ajouter dans config.toml une ligne dans param avec favicon = "favicon.ico".

Si Fork

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.

Toutes les infos sont détaillées ici ! Pour convertir du DOKUWIKI en Markdown, on peut utiliser pandoc??? (todo) ou certains web en ligne.