Auflistung der Taxonomy geradegezogen

README.md

@@ -153,6 +153,24 @@ Und hier der weitere Artikel
 
 Hierfür kann auch die Vorlage für [Blog](https://gitea.marcodn.de/mdn/blogamore/src/branch/main/archetypes/blog.md) verwendet werden.
 
+### Beispiel für eine Beschreibung zur Taxonomy
+
+Zum erstellen der Datei mit der ein Term in der Taxonomy beschrieben werden kann, wird folgender Befehl verwendet (Taxonomy und Term müssen entsprechend angepasst werden):
+
+```bash
+hugo new tags/tag1/_index.md
+```
+
+In der Datei kann nun die Beschreibung  und der Titel angepasst werden. Sollte man eigene Taxonomies verwenden, wird geraten eine eigene Vorlage zu definieren. Diese ist unte archetypes zu definieren, der Name ist die Pluralform mit ".md" am Ende und es sollte folgenden Inhalt haben:
+
+```toml
+---
+title: {{ $term := path.Base .File.Dir }}"{{ replace $term "-" " " | title }}"
+description: "Dies ist eine Beschreibung für {{ $term | title }}"
+date: {{ now.Format "2006-01-02" }}
+---
+```
+
 ## Weiteres
 
 Haben Sie einen Fehler gefunden oder eine Idee für ein neues Feature? Schicken Sie mir bitte eine Mail an ... Oder erstellen Sie direkt einen [Pull Request](https://gitea.marcodn.de/mdn/blogamore/pulls) 

archetypes/categories.md

@@ -0,0 +1,5 @@
+---
+title: {{ $term := path.Base .File.Dir }}"{{ replace $term "-" " " | title }}"
+description: "Dies ist eine Beschreibung für {{ $term | title }}"
+date: {{ now.Format "2006-01-02" }}
+---

archetypes/skills.md

@@ -0,0 +1,5 @@
+---
+title: {{ $term := path.Base .File.Dir }}"{{ replace $term "-" " " | title }}"
+description: "Dies ist eine Beschreibung für {{ $term | title }}"
+date: {{ now.Format "2006-01-02" }}
+---

archetypes/tags.md

@@ -0,0 +1,5 @@
+---
+title: {{ $term := path.Base .File.Dir }}"{{ replace $term "-" " " | title }}"
+description: "Dies ist eine Beschreibung für {{ $term | title }}"
+date: {{ now.Format "2006-01-02" }}
+---

layouts/_default/taxonomy.html

@@ -1 +1,13 @@
-{{- partial "taxonomy/description.html" . -}}
+{{/* 
+  Definition der Standardauflistung von Taxonomy und der Seiten eines Elementes der Taxonomy
+  - kann durch terms.html die Hauptlistung der Taxonomy-Elemente überschrieben werden (z.B. tags/)
+  - kann durch layout/taxonomy/tag.html die Seite des Elementes überschrieben werden (z.B. tags/64Bit/)
+
+  Um weitere Informationen zu den Taxonomy-Element zu hinterlegen, muss in der Webseite eine _index.md für jedes Element
+  erzeugt werden. hierfür kann der Befehl `hugo new <taxonomy>/<term>/_index.md" verwendet werden. Mit unserem Beispiel
+  würde es dann wie folgt lauten: `hugo new tags/64Bit/index.md`. Sinnvoll sollte dafür auch Vorlagen unter archtypes/<taxonomy>.md
+  sein. Für unser Beispiel wäre es dann archtypes/tags.md.
+*/}}
+{{ define "main" }}
+  {{- partial "taxonomy/summary.html" . -}}
+{{ end }}

layouts/_default/terms.html

@@ -0,0 +1,3 @@
+{{ define "main" }}
+  {{- partial "taxonomy/description.html" . -}}
+{{ end }}

layouts/partials/taxonomy/description.html

@@ -1,11 +1,9 @@
-{{ define "main" }}
-  <h1 class="mb-5">{{ .Title }}</h1>
-  {{ range .Pages.ByTitle }}
+<h1 class="mb-5">{{ .Title }}</h1>
+{{ range .Pages.ByTitle }}
   <article class="border-bottom">
     <h3 class="mb-3">
       <a href="{{ .RelPermalink | relURL }}">{{ .Title }}</a>
     </h3>
-    <p>{{ .Summary }}</p>
+    <p>{{ .Description }}</p>
   </article>
-  {{ end }}
 {{ end }}

layouts/partials/taxonomy/summary.html

@@ -1,11 +1,9 @@
-{{ define "main" }}
-  <h1 class="mb-5">{{ .Title }}</h1>
-  {{ range .Pages.ByTitle }}
+<h1 class="mb-5">{{ .Title }}</h1>
+{{ range .Pages.ByTitle }}
   <article class="border-bottom">
     <h3 class="mb-3">
       <a href="{{ .RelPermalink | relURL }}">{{ .Title }}</a>
     </h3>
     <p>{{ .Summary }}</p>
   </article>
-  {{ end }}
 {{ end }}

layouts/taxonomy/category.html

@@ -1 +0,0 @@
-{{- partial "taxonomy/summary.html" . -}}

layouts/taxonomy/skill.html

@@ -1 +0,0 @@
-{{- partial "taxonomy/summary.html" . -}}

layouts/taxonomy/tag.html

@@ -1 +0,0 @@
-{{- partial "taxonomy/summary.html" . -}}