---
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/