Comment modifier ces pages

Le site est statique, généré automatiquement avec le framework Hugo à partir de fichiers au format Markdown. Le site utilise le thème tout fait Relearn.

Utilisation de Hugo

La totalité du contenu du site est modifiable en éditant seulement les fichiers des dossiers content et static :

  • Les pages sont des fichiers textes au format Markdown, situé dans le dossier content. Le menu est généré automatiquement à partir de l’arborescence des dossiers et des fichiers dans ce dossier.
  • Les images insérées dans les pages sont à mettre dans le dossier static.

Hugo transforme ce contenu en un site statique. Il faut faire appel à l’exécutable hugo ou hugo.exe pour créer les fichiers du site final. Ceux-ci sont créés dans le dossier public. Il suffit donc de copier le contenu du dossier public sur l’hébergement web.

Attention

Dans le fichier de configuration hugo.toml, il est important de préciser l’URL finale du site pour le paramètre baseURL.

Exemple: baseURL = 'https://crucifor.me/babbage'

Il est possible de lancer un serveur local pour tester les modifications en local avec la commande hugo.exe server. Le site est alors déployé à l’URL http://localhost:1313 ou http://localhost:1313/babbage selon le format du paramètre baseURL.

Syntaxe des pages

La syntaxe des principaux éléments est détaillée ci-après, pour tout le reste, vous pouvez vous référez aux ressource suivantes :

Syntaxes de base les plus utilisées sur ce site

  • Liens : [Nom affiché](URL)
  • Images : ![Texte alternatif](chemin relatif vers le fichier)
  • Notes de bas de page : [^Code] placé après le texte ; [^Code]: Explication placé à la fin du fichier

Extensions utilisées

Prendre des extraits de vidéos

Les extraits vidéos sont issus de vidéos Youtube téléchargées au format MP4 avec NoTube. Il faut cependant demander l’autorisation aux auteurs avant d’utiliser leurs vidéos (ce qui n’a pas encore été fait ici…).

Les portions souhaitées sont extraites avec l’outil Kdenlive. L’extrait sélectionné est enregistré au format GIF pour pouvoir être intégré plus facilement sur ce site web.