Hugo - Intégration de Font Awesome

Mis à jour le 19/10/2022

Le thème Hugo Clarity utilisé par le présent site n'intègre pas nativement Font Awesome. Voici comment j'ai intégré Font Awesome aux sources de mon site.

La démarche qui suit reste valable pour d'autres thèmes Hugo, mais avec des adaptations.

  1. Récupérer l'archive au format zip depuis la page https://fontawesome.com/download, au moment où nous écrivons ces lignes c'est fontawesome-free-6.2.0-web.zip.

  2. Désarchiver le zip dans un répertoire temporaire pour obtenir le répertoire fontawesome-free-6.2.0-web/.

  3. Dans le répertoire source du site créer le répertoire static/fontawesome/css/ :

    mkdir -p static/fontawesome/css/

  4. Copier le fichier fontawesome-free-6.2.0-web/css/all.css dans static/fontawesome/css/.

  5. Dans le fichier layouts/_default/baseof.html ajouter avant la balise </head> la ligne :

    <link rel="stylesheet" type="text/css" href="{{ $baseurl }}/fontawesome/css/all.css">
    Remarque : si layouts/_default/baseof.html n'existe pas il faut le recopier (chemin layouts/_default/ compris) depuis le thème. Pour les sources de mon site cela revient à faire :
    mkdir -p layouts/_default
    cp themes/hugo-clarity/layouts/_default/baseof.html layouts/_default/

Pour faciliter l'utilisation des icônes de Font Awesome j'ai écrit un shortcode dédié, voir le billet suivant Hugo - Shortcode pour les icônes de Font Awesome.