[Hugo] Zusammenfassung zum Hinzufügen von Seiten zu der mit Learn erstellten Site

Überblick

Fassen Sie das Verfahren zum Hinzufügen von Seiten und Anwenden von Layouts auf eine mit Hugo erstellte Site (Thema: Lernen) zusammen.

Annahme

• [Docker] Erstellen einer Umgebung zur Verwendung von Hugo
• [Docker] Erstellen Sie eine Site mit Hugo und veröffentlichen Sie sie auf GitHub

Das oben beschriebene Verfahren besteht darin, die Umgebung zu erstellen und die Seite zu erstellen. Die Erklärung basiert auf der Annahme, dass sich der Ordner "posts" im Ordner "content" befindet.

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

Seite im Moment fertiggestellt

Tor

Ziel ist es, die folgende Site durch Hinzufügen von Seiten (Kinder) und Festlegen von Indexseiten (Eltern) zu erstellen.

Seite? ˅

Ordnerstruktur

Die endgültige Dateistruktur lautet wie folgt

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

Site-Indexseite, Seiteneinstellungen hängen von der Ordnerstruktur ab

Seite erstellen

Eine Seite (Kind) wird durch Ausführen des Befehls "hugo new" erstellt. In Vorheriger Artikel wurde der folgende Befehl ausgeführt.

hugo new posts/my-first-post.md　

Durch Ausführen dieses Befehls wird der in der Datei "default.md" im Ordner "archetypes" beschriebene Inhalt zur angegebenen MD-Datei hinzugefügt.

Die standardmäßig hinzugefügten Elemente lauten wie folgt

default.md

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

Sie können eine Website erstellen, indem Sie diese Parameter eingeben.

So ändern Sie den Titelnamen der Tabelle

Erklären Sie, wie Sie den Titel der Tabelle ändern

Da der Titel in "title:" von "my-first-post.md" festgelegt ist, ändern Sie hier die Zeichenfolge.

my-first-post.md

---
title: "My First Post" //Hier angegeben
date: 2020-XX-XX
draft: true
---

#Titel
Versuchen Sie, eine Hoge-Site zu erstellen

Wenn Sie zu title:" Chapter 1 " wechseln, werden die folgenden drei Teile geändert.

So fügen Sie eine Seite hinzu (Kind)

Es gibt zwei Möglichkeiten, Seiten hinzuzufügen:

1. Führen Sie den Befehl "hugo new" aus, genau wie beim Erstellen einer neuen Seite
2. Füllen Sie die Elemente manuell aus, die hinzugefügt werden, wenn Sie den Befehl "hugo new" ausführen.

Der Unterschied besteht darin, ob der Inhalt der Datei default.md per Befehl oder manuell eingegeben wird.

Kopieren Sie hier "my-first-post.md", benennen Sie es in "my-second-post.md" um, speichern Sie es in derselben Hierarchie und fügen Sie eine Seite hinzu.

my-second-post.md

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

#Seite hinzufügen
my-first-post.Kopieren Sie md, um den Inhalt zu ändern-second.Als MD-Datei speichern

Seite hinzugefügt

Indexseite hinzufügen (übergeordnet)

Ich möchte die Seite festlegen, die angezeigt wird, wenn ich auf "Posten" oder "Meine neue Hugo-Site" klicke. In Bezug auf die aktuelle Dateistruktur ist dies wie folgt. Dies sind die übergeordneten Seiten, die als Indexseiten bezeichnet werden. Lernhandbuch: _index.md

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

Standardmäßig gibt es keine Dateien, aus denen die Seiten "Post" oder "Meine neue Hugo-Site" bestehen. Sie können die Seite konfigurieren, indem Sie in jedem Ordner "_index.md" erstellen.

Inhalt hinzufügen> _index.md

_index.md

---
title: "Seiteninformation"
date: 2020-XX-XX
draft: true
---
Diese Seite testet die Anpassung von Learn.

Beiträge> Add _index.md

_index.md

---
title: "Anpassungsverfahren"
date: 2020-XX-XX
draft: true
---
#Lernen Sie die Anpassung
_Sie können diese Seite bearbeiten, indem Sie eine Indexdatei erstellen.

Bei den Operationen bis zu diesem Punkt ist die Dateistruktur wie folgt.

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

Seitenlayout anwenden

Learn bietet neben regulären Seitenlayouts auch Layouts für Kapitelseiten Lernhandbuch: Erstellen Sie Ihre erste Kapitelseite Das Layout wird angewendet, indem dem Header-Teil "Chapter: True" hinzugefügt und wie folgt geschrieben wird.

###Unterüberschrift
#Titel
Schreiben Sie hier einen Satz

posts> Wenden Sie das Layout für Kapitel auf die Datei _index.md an

_index.md

---
title: "Anpassungsverfahren"
date: 2020-XX-XX
draft: true
chapter: true //Nachtrag
---
###Anfänger
#Lernen Sie die Anpassung
_Sie können diese Seite bearbeiten, indem Sie eine Indexdatei erstellen.

Referenz

Hugo Learn Guide Hugo Content Organization