Installation: Étendre le thème

Généralités#

Comme tous les autres thèmes Hugo, il est possible d’étendre et modifer le thème Shadocs pour des besoins spécifiques

Pour plus d’information, se référer à la documentation Hugo sur les templates .

Personnalisation HTML#

Plusieurs fichier de mise en page spécifique sont disponibles dans le thème.

Ces fichiers sont vides par défaut, mais ils peuvent être défini dans un site web spécifique (en utilisant l’ordre de recherche des fichier Hugo ), pour inclure du code spécifique à un endroit spécifique, directement dans la mise en page HTML globale, sans avoir à modifier la mise en page par défaut du thème.

Les fichiers suivants sont gérés dans le thème:

  • layouts/partials/custom/custom-head.html pour insérer du code juste avant le tag de fin
    custom-head.html
    <html>
    <head>
        [...]
        {{- partial "custom/custom-head.html" .root -}}
    </head>
</html>
  • layouts/partials/custom/custom-footer.html pour insérer du code juste avant le tag de fin
    custom-footer.html
    <html>
    <body>
    [...]
    {{- partial "custom/custom-footer.html" .root -}}
    </body>
</html>
  • layouts/partials/custom/custom-info.html pour insérer du code dans la fenêtre modale d’information
    Pour plus d’information, se référer au fichier du site de documentation custom-info.html

Personnalisation SASS#

La mise en page CSS du thème est implémentée en utilisant le langage SASS .

Tout comme les fichiers de mise en page spécifique HTML, des fichiers de mise en page spécifique SASS sont disponibles dans le thème.

Les fichiers suivants sont gérés dans le thème:

Pour plus d’information, se référer au fichier du site de documentation custom_variables.sass et example.sass , pour implémenter un comportement CSS spécifique:

Couleur de titre spécifique pour exemple de personnalisation SASS#