From a6000685cfcbb4253f634b44637b599cec96d5bc Mon Sep 17 00:00:00 2001
From: Alan Pearce
Date: Sun, 18 Feb 2024 13:58:34 +0100
Subject: Create basic German version of website

---
 content/_index.de.md      | 23 +++++++++++++++++++++++
 content/bear.de.md        | 15 +++++++++++++++
 content/blog/_index.de.md |  3 +++
 content/zola.de.md        | 36 ++++++++++++++++++++++++++++++++++++
 4 files changed, 77 insertions(+)
 create mode 100644 content/_index.de.md
 create mode 100644 content/bear.de.md
 create mode 100644 content/blog/_index.de.md
 create mode 100644 content/zola.de.md

(limited to 'content')

diff --git a/content/_index.de.md b/content/_index.de.md
new file mode 100644
index 0000000..cdcad42
--- /dev/null
+++ b/content/_index.de.md
@@ -0,0 +1,23 @@
++++
++++
+# Eine himmlische Verbindung
+
+Es gibt eine Krise der Website-Fettleibigkeit. Aufgeblähte Websites voller Skripte, Werbung und Tracker bremsen deine Leser jedes Mal aus, wenn sie versuchen, deine gut gestalteten Inhalte zu lesen.
+
+Zola Bear Blog ist alles, was du brauchst, um eine fantastische und optimierte Website oder einen Blog zu erstellen. Es funktioniert perfekt auf **jedem** Anzeigegerät. Alles, worauf du dich konzentrieren müssen, ist das Schreiben guter Inhalte.
+
+[Zum ursprünglichen Bear-Blog](https://bearblog.dev/).
+
+---
+
+Was passiert, wenn du den weltweit schnellsten und leichtesten Generator für statische Websites mit einem Design-Theme kombinieren, das dir kostenlose, unkomplizierte und superschnelle Blogging-Funktionen bietet?
+
+**Benutze dieses Theme und finde es heraus!**
+
+Erstellt mit 💚 von [Alan Pearce](https://alanpearce.eu).
+
+---
+
+Veröffentliche einfach deine Inhalte online, bau ein Publikum auf und halte deine Seiten klein, schnell und **für Suchmaschinen optimiert**.
+
+Jede Seite ist ~5kb groß, und du kannst dein Blog selbst **hosten**.
diff --git a/content/bear.de.md b/content/bear.de.md
new file mode 100644
index 0000000..b9a1f3e
--- /dev/null
+++ b/content/bear.de.md
@@ -0,0 +1,15 @@
++++
+title = "Bear"
++++
+
+Webseite: [https://bearblog.dev](https://bearblog.dev)
+
+Es gibt eine Krise der Website-Fettleibigkeit. Aufgeblähte Websites voller Skripte, Werbung und Tracker bremsen deine Leser jedes Mal aus, wenn sie versuchen, deine gut gestalteten Inhalte zu lesen.
+
+Zola Bear Blog ist alles, was du brauchst, um eine fantastische und optimierte Website oder einen Blog zu erstellen. Es funktioniert perfekt auf **jedem** Anzeigegerät. Alles, worauf du dich konzentrieren müssen, ist das Schreiben guter Inhalte.
+
+Bear macht es einfach, Inhalte online zu veröffentlichen und ein Publikum aufzubauen, während die Seiten klein, schnell und **für Suchmaschinen optimiert** bleiben.
+
+Jede Seite ist ~5kb.
+
+Weitere Informationen und Beiträge unter [GitHub](https://github.com/HermanMartinus/bearblog).
diff --git a/content/blog/_index.de.md b/content/blog/_index.de.md
new file mode 100644
index 0000000..34651ab
--- /dev/null
+++ b/content/blog/_index.de.md
@@ -0,0 +1,3 @@
++++
+title = "Blog"
++++
diff --git a/content/zola.de.md b/content/zola.de.md
new file mode 100644
index 0000000..204f790
--- /dev/null
+++ b/content/zola.de.md
@@ -0,0 +1,36 @@
++++
+title = "Zola"
++++
+## Keine Abhängigkeiten
+
+Zola wird als einzelne ausführbare Datei mit Sass-Kompilierung, Syntax
+Syntaxhervorhebung, Inhaltsverzeichnis und vielen anderen Funktionen, die
+die normalerweise das Einrichten einer Entwicklungsumgebung oder das Hinzufügen einiger
+JavaScript-Bibliotheken zu deiner Website.
+
+## Rasend schnell
+
+Die durchschnittliche Website wird in weniger als einer Sekunde erstellt, einschließlich
+Sass-Kompilierung und Syntaxhervorhebung.
+
+## Skalierbar
+
+Zola rendert deine gesamte Website als statische Dateien, was es trivial macht
+jede Art von Datenverkehr zu bewältigen, ohne dass du dich um die
+ohne sich um die Verwaltung eines Servers oder einer Datenbank kümmern zu müssen.
+
+## Einfach zu bedienen
+
+Von der CLI bis zur Template-Engine ist alles so konzipiert, dass es
+intuitiv. Verlasse dich jedoch nicht auf mein Wort, sondern schaue in die Dokumentation
+und überzeug dich selbst.
+
+## Flexibel
+
+Zola geht dir aus dem Weg, damit du dich auf deine Inhalte konzentrieren kannst, sei es ein
+Blog, eine Wissensdatenbank, eine Landing Page oder eine Kombination aus beidem.
+
+## Erweitertes Markdown
+
+Zola verfügt über Shortcodes und interne Links, die das Schreiben von
+deine Inhalte zu schreiben.
-- 
cgit 1.4.1


From baabcb634bdffb8623eacc410e8707a3b4afe2b5 Mon Sep 17 00:00:00 2001
From: Emilio Ziniades
Date: Sun, 12 May 2024 15:54:40 +0200
Subject: feat(table of contents): Add table of contents

This feature is disabled by default, but can be enabled/disabled
globally or per-page.

Zola already provides `page.toc`, this PR simply adds a macro
to recursively render that data in nested `ul`s.

It also establishes some configuration options to display it
and set a maximum headers level.
---
 README.md             | 23 +++++++++++++++++++++++
 config.toml           |  6 +++++-
 content/zola.md       |  1 +
 templates/macros.html | 12 ++++++++++++
 templates/page.html   |  7 +++++++
 theme.toml            |  5 +++++
 6 files changed, 53 insertions(+), 1 deletion(-)
 create mode 100644 templates/macros.html

(limited to 'content')

diff --git a/README.md b/README.md
index 7ebe80b..5152949 100644
--- a/README.md
+++ b/README.md
@@ -73,6 +73,29 @@ The contents of the `index`-page may be changed by editing your `content/_index.
 
 Add a `custom_head.html`-file to your `templates/`-directory. In there you may add a `<style>`-tag, *or* you may add a `<link>`-tag referencing your own `custom.css` (in case you prefer to have a separate `.css`-file). Check out the [`style.html`](https://codeberg.org/alanpearce/zola-bearblog/src/branch/main/templates/style.html)-file to find out which CSS-styles are applied by default.
 
+### Table of contents
+
+Table of contents are not rendered by default. To render them, set `extra.table_of_contents.show = true` in `config.toml`.
+
+The table of contents is rendered inside a `details` element.
+If you want the section to be collapsed on page load, set `extra.table_of_contents.visible_on_load = false`.
+This defaults to `true`.
+
+In addition, `extra.table_of_contents.max_level` can limit the maximum level of headers to show.
+To show only `h1`s, set `max_level = 1`, to show `h1`s and `h2`s, set `max_level = 2`, and so on.
+By default, `max_level` is set to 6, so all headers on the page are shown.
+
+Below is an example of how to configure the table of contents in `config.toml`.
+
+```toml
+[extra.table_of_contents]
+show = true
+max_level = 2
+visible_on_load = false
+```
+
+It can also be toggled on page-by-page basis. Add `extra.hide_table_of_contents = true` to the page's frontmatter to hide the table of contents for that specific page.
+
 ## Issues / Feedback / Contributing
 Please use [Codeberg issues](https://codeberg.org/alanpearce/zola-bearblog/issues) and [Pull Requests](https://codeberg.org/alanpearce/zola-bearblog/pulls).
 
diff --git a/config.toml b/config.toml
index fcb1d61..8927d04 100644
--- a/config.toml
+++ b/config.toml
@@ -45,12 +45,16 @@ highlight_code = true
 date_format="%Y-%m-%d"
 webserver_sends_csp_headers=true
 language_switcher=true
-
 translations = [
   { code="en", name="English" },
   { code="de", name="Deutsch" },
 ]
 
+[extra.table_of_contents]
+show=true
+max_level=2
+visible_on_load=true
+
 [[extra.main_menu]]
 name = "Home"
 name_de = "Startseite"
diff --git a/content/zola.md b/content/zola.md
index 5458750..bbce998 100644
--- a/content/zola.md
+++ b/content/zola.md
@@ -1,5 +1,6 @@
 +++
 title = "Zola"
+extra.hide_table_of_contents = true
 +++
 ## No dependencies
 
diff --git a/templates/macros.html b/templates/macros.html
new file mode 100644
index 0000000..2ad23e6
--- /dev/null
+++ b/templates/macros.html
@@ -0,0 +1,12 @@
+{% macro table_of_contents(toc, max_level) %}
+<ul>
+  {% for header in toc %}
+    <li>
+      <a href="{{ header.permalink | safe }}">{{ header.title }}</a>
+        {% if header.children and header.level < max_level %}
+          {{ self::table_of_contents(toc=header.children, max_level=max_level) }}
+        {% endif %}
+    </li>
+  {% endfor %}
+</ul>
+{% endmacro %}
diff --git a/templates/page.html b/templates/page.html
index 5c1a80b..2e2ef86 100644
--- a/templates/page.html
+++ b/templates/page.html
@@ -1,3 +1,4 @@
+{% import "macros.html" as macros %}
 {% extends "base.html" %}
 
 {% block title %}{{ page.title }} | {{ super() }}{% endblock %}
@@ -15,6 +16,12 @@
       </p>
     {%- endif %}
   {%- endif %}
+  {%- if config.extra.table_of_contents.show and not page.extra.hide_table_of_contents and page.toc %}
+    <details {%if config.extra.table_of_contents.visible_on_load %}open{% endif %}>
+      <summary>Table of Contents</summary>
+      {{ macros::table_of_contents(toc=page.toc, max_level=config.extra.table_of_contents.max_level) }}
+    </details>
+  {%- endif %}
   <main>
     {{ page.content | safe }}
   </main>
diff --git a/theme.toml b/theme.toml
index 902c8ec..894f7fa 100644
--- a/theme.toml
+++ b/theme.toml
@@ -15,6 +15,11 @@ demo = "https://zola-bearblog.netlify.app/"
 date_format="%d %b, %Y"
 webserver_sends_csp_headers=false
 
+[extra.table_of_contents]
+show=false
+max_level=6
+visible_on_load=true
+
 [author]
 name = "Alan Pearce"
 homepage = "https://alanpearce.eu"
-- 
cgit 1.4.1