docsify/docs/de-de/custom-navbar.md
2017-03-25 15:52:21 +08:00

2.5 KiB

Navigationsleiste anpassen

HTML

Solltest du eine Navigationsleiste benötigen, so kannst du eine HTML-basierte erstellen.

!> Die Links der Dokumentation fangen alle mit #/ an.

<!-- index.html -->

<body>
  <nav>
    <a href="#/">EN</a>
    <a href="#/de-de/">DE</a>
  </nav>
  <div id="app"></div>
</body>

Markdown

Oder du kannst deine Navigationsleiste mit einer Datei basierend auf Markdown erstellen, indem du loadNavbar auf true setzt und eine Datei namens _navbar.md erstellst, vergleiche load-navbar Einstellungen.

<!-- index.html -->

<script>
  window.$docsify = {
    loadNavbar: true
  }
</script>
<script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
<!-- _navbar.md -->

- [En](/)
- [Deutsch](/de-de/)

!> Solltest du Github Pages verwenden, musst du zusätzlich eine Datei namens .nojekyll in ./docs erstellen, um zu verhindern, dass Github Dateien ignoriert, die mit einem Unterstrich anfangen.

_navbar.md wird in jedem Verzeichnislevel geladen. Sollte das aktuelle Verzeichnis keine Datei namens _navbar.md haben, so sucht docsify in den übergeordneten Ordnern. Wenn du z.B. im Moment im Verzeichnis /guide/quick-start bist, so wird _navbar.md von der Datei /guide/_navbar.md geladen.

Aufbauen von Strukturen

Du kannst untergeordnete Listen erstellen, indem du untergeordnete Punkte einem übergeordneten Punkt gegenüber einrückst.

<!-- _navbar.md -->

- Getting started
  - [Quick start](de-de/quickstart.md)
  - [Writing more pages](de-de/more-pages.md)
  - [Custom navbar](de-de/custom-navbar.md)
  - [Cover page](de-de/cover.md)

- Configuration
  - [Configuration](de-de/configuration.md)
  - [Themes](de-de/themes.md)
  - [Using plugins](de-de/plugins.md)
  - [Markdown configuration](de-de/markdown.md)
  - [Language highlight](de-de/language-highlight.md)

wird also wie folgt aussehen

Nesting navbar

Angepasste Navigationsleisten in Verbindung mit dem emoji Erweiterung

Solltest du die emoji Erweiterung verwenden:

<!-- index.html -->

<script>
  window.$docsify = {
    // ...
  }
</script>
<script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
<script src="//unpkg.com/docsify/lib/plugins/emoji.min.js"></script>

so kannst du z.B. auch die Flaggenemojis in der Markdown Datei für deine angepasste Navigationsleiste verwenden:

<!-- _navbar.md -->

- [:us:, :uk:](/)
- [:de:](/de-de/)