[Hugo] Résumé de la façon d'ajouter des pages au site créé avec Learn

Aperçu

Résumez la procédure d'ajout de pages et d'application de mises en page à un site (thème: Learn) construit avec Hugo.

supposition

• [Docker] Construction d'un environnement pour utiliser Hugo
• [Docker] Construisez un site avec Hugo et publiez-le sur GitHub

La procédure décrite ci-dessus consiste à créer l'environnement et à créer la page, et l'explication est basée sur l'hypothèse que le dossier des publications se trouve dans le dossier «contenu» ci-dessous.

content
└── posts
    └── my-first-post.md

Page terminée pour le moment

objectif

Le but est de créer le site suivant en ajoutant des pages (enfants) et en définissant des pages d'index (parents).

site

Structure des dossiers

La structure finale du fichier est la suivante

content
├── _index.md         // baseurl 
└── posts　　　
    ├── _index.md     // .../post 
    ├── my-first-post.md　　　　// .../post/my-first-post
    └── my-second-post.md　　　// .../post/my-second-post

Page d'index du site, les paramètres de la page dépendent de la structure des dossiers

Créer une page

Une page (enfant) est créée en exécutant la commande hugo new. Dans Article précédent, la commande suivante a été exécutée.

hugo new posts/my-first-post.md　

En exécutant cette commande, le contenu décrit dans le fichier «default.md» du dossier «archétypes» sera ajouté au fichier .md spécifié.

Les éléments ajoutés par défaut sont les suivants

default.md

---
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
draft: true
---

Vous pouvez créer un site Web en remplissant ces paramètres.

Comment changer le nom du titre de la table

Expliquez comment changer le titre du tableau

Puisque le titre est défini dans "title:" de "my-first-post.md", modifiez la chaîne de caractères ici.

my-first-post.md

---
title: "My First Post" //Spécifié ici
date: 2020-XX-XX
draft: true
---

#Titre
Essayez de créer un site hoge

Si vous changez pour title:" Chapitre 1 ", les trois parties suivantes seront modifiées.

Comment ajouter une page (enfant)

Il existe deux façons d'ajouter des pages:

1. Exécutez la commande hugo new, comme lorsque vous avez créé une nouvelle page
2. Remplissez manuellement les éléments qui seront ajoutés lorsque vous exécutez la commande hugo new.

La différence est de savoir si le contenu du fichier default.md est entré par commande ou manuellement.

Ici, copiez "my-first-post.md", renommez-le en "my-second-post.md", enregistrez-le dans la même hiérarchie, et ajoutez une page.

my-second-post.md

---
title: "Chapitre 2"
date: 2020-XX-XX
draft: true
---

#Ajouter une page
my-first-post.Copiez md pour modifier le contenu, mon-second.Enregistrer en tant que fichier md

Page ajoutée

Ajouter une page d'index (parent)

Je souhaite définir la page qui s'affiche lorsque je clique sur "Publier" ou "Mon nouveau site Hugo" En regardant la structure actuelle des fichiers, c'est comme suit. Ce sont les pages parentes, appelées pages d'index. Guide d'apprentissage: _index.md

content
└── posts
    ├── my-first-post.md
    └── my-second-post.md

Par défaut, il n'y a pas de fichiers qui composent les pages Publier ou Mon nouveau site Hugo. Vous pouvez configurer la page en créant _index.md dans chaque dossier.

Ajouter du contenu> _index.md

_index.md

---
title: "Informations sur le site"
date: 2020-XX-XX
draft: true
---
Ce site teste la personnalisation Apprendre.

posts> Ajouter _index.md

_index.md

---
title: "Procédure de personnalisation"
date: 2020-XX-XX
draft: true
---
#Apprendre la personnalisation
_Vous pouvez modifier cette page en créant un fichier d'index.

Avec les opérations jusqu'à ce point, la structure du fichier est la suivante.

content
├── _index.md
└── posts
    ├── _index.md
    ├── my-first-post.md
    └── my-second-post.md

Appliquer la mise en page

Learn fournit des mises en page pour les pages de chapitre en plus des mises en page standard. Guide d'apprentissage: créez votre première page de chapitre La mise en page est appliquée en ajoutant chapitre: true à la partie d'en-tête et en écrivant comme suit.

###Sous-titre
#Titre
Écrivez une phrase ici

articles> Appliquer la mise en page des chapitres au fichier _index.md

_index.md

---
title: "Procédure de personnalisation"
date: 2020-XX-XX
draft: true
chapter: true //Postscript
---
###Débutants
#Apprendre la personnalisation
_Vous pouvez modifier cette page en créant un fichier d'index.

référence

Hugo Learn Guide Organisation de contenu Hugo