add example section

the example section is only rendered when drafts are enabled
This commit is contained in:
Johannes Kimmel 2022-11-18 17:56:15 +01:00
parent 32338d19fe
commit e7fb03072e
2 changed files with 63 additions and 0 deletions

57
content/example/_index.md Normal file
View File

@ -0,0 +1,57 @@
---
title: "Example"
date: 2022-11-17T23:09:11+01:00
weight: 1024
draft: true
---
alles bis zum [<code>&#60;&#33;&#45;&#45;more&#45;&#45;&#62;</code>](https://gohugo.io/content-management/summaries/#manual-summary-splitting)
gilt als Kurzbeschreibung für die Seite und wird in den Übersichtslisten verwendet.
<!--more-->
## Ordnerstruktur
```
content/example/_index.md
^ ^
| section main page
section
```
Hier ist eine Bespiel [section].
Die Hauptseite innerhalb einer [section] muss den Dateiname [`_index.md`][_index.md] haben.
Der Titel für das Menü wird dabei aus dem `title` [frontmatter][frontmatter] Attribut entnommen.
## Links
Auf andere Seiten kann ganz normal mit Markdownsyntax verlinkt werden:
```md
[Beschreibung](Pfad)
```
Wenn der Dateiname eindeutig ist können [shortcodes] für [links] verwendet werden, um unabhänging vom Pfad zu einer Datei zu verlinken:
```md
[Beschreibung]({{%/* relref "dateiname" */%}})
```
## Beispiel
[Zur Beispielseite]({{% relref "example_page" %}})
```md
[Zur Beispielseite]({{%/* relref "example_page" */%}})
```
```html
<a href="/example/example_page/">Zur Beispielseite</a>
```
[section]: https://gohugo.io/content-management/sections
[_index.md]: https://gohugo.io/templates/lists/#example-list-templates
[frontmatter]: https://gohugo.io/content-management/front-matter/
[shortcodes]: https://gohugo.io/content-management/shortcodes/
[links]: https://gohugo.io/content-management/cross-references/

View File

@ -0,0 +1,6 @@
---
title: "Beispielseite"
date: 2022-11-17T23:17:22+01:00
---
`content/example/example_page.md`