web-dev-qa-db-fra.com

Pourquoi Hugo sert-il des pages blanches?

Je crée un site Web personnel en utilisant Hugo Static Page Generator, mais quand je le fais hugo serve, Je ne vois plus de page, mais simplement une page vierge à localhost:1313.

J'ai tout supprimé et fait une nouvelle installation. Mais encore, Hugo sert des pages blanches.

Dans la page blanche, je vois le Favicon du projet de site précédent que j'avais, même si j'ai tout supprimé du thème précédent. J'ai effacé le navigateur dans Chrome et j'ai essayé un autre navigateur également, mais cela ne fonctionne toujours pas.

Je ne sais pas quelles informations je peux fournir, car il n'y a aucun message d'erreur. Comment puis-je réparer cela?

hugo
22
maximusdooku

Le problème est probablement le thème - il est manquant ou cassé. Hugo ne propose pas de thème par défaut/de secours si vous ne parvenez pas à en fournir un qui fonctionne.

Guide de débogage:

  1. Vérifiez le dossier themes et suivez le quickstart .
  2. Essayez d'utiliser un autre thème plus simple.
  3. Il ne peut s'agir que de configurer le thème, vous pouvez également lire la documentation du thème hugo .
17
jediz

Veuillez vérifier que votre fichier config.toml pointe vers le bon thème.

Si vous suivez le didacticiel de démarrage rapide, vous avez peut-être oublié d'exécuter

echo 'theme = "ananke"' >> config.toml
5
bhar1red

J'ai rencontré le même problème après avoir suivi le guide hugo getting-started/quickstart mais au lieu d'utiliser un thème existant, j'ai créé un thème très basique:

  1. Installer hugo j'ai choisi installer hugo sur windows
  2. Créer un nouveau site hugo new site quickstart
  3. Ajouter un thème
    • le clonage d'un thème (par exemple ananke-theme ) est plus facile <-- this is what the quickstart does and what i left out
    • à la place, vous pouvez créer un thème avec hugo new theme [your-theme-name] qui ajoute un squelette de thème dans votre dossier de site par exemple C:\Hugo\Sites\example.com (voir la capture d'écran)
  4. Ajouter du contenu hugo new posts/my-first-post.md
  5. Démarrez le serveur hugo server -D --watch --verbose

Hugo_myFirstTheme_files_folders

Après avoir créé un thème, les fichiers et dossiers doivent se trouver sous Sites/example.com/themes/your-theme-name/. Étant donné que la plupart des fichiers générés sont (presque) vides, vous devez en modifier quelques-uns avant que l'exemple de démarrage rapide ne fonctionne.

Basé sur développer un thème pour Hugo j'ai édité /themes/your-theme-name/layouts/index.html

<!DOCTYPE html>
<html> <body>    
    {{ range first 10 .Data.Pages }}        
         <h1>{{ .Title }}</h1>
         <div>{{- .Content -}}</div>
    {{ end }}      
</body> </html>

Informations de base sur hugo tirées de développer un thème pour Hugo

  • Les fichiers de configuration Hugo (TOML, YAML ou JSON) sont situés à la racine de votre site
  • Hugo par défaut: Markdown à l'intérieur content/,
    • les fichiers de contenu contiennent des métadonnées ( frontmatter ) et du texte (/ markdown) -> html to public /,
    • exemples d'attributs de frontmatter: date, title, description, categories, tags

  • modèles sous themes/ (ou layouts/)

    • trois types de modèles: single, list, partials
    • modèles de thème sous /themes/your-theme-name/ puis sous /layouts/ pour index.html et sous /layouts/_default/list.html et /layouts/_default/single.html

  • Les fichiers HTML seront écrits dans le public/ répertoire.

Vous voudrez peut-être lire la documentation du thème hugo .

2
surfmuggle