docs: soft left nav for customization

jippi · Jun 28, 2024 · 86416ad · 86416ad
1 parent 419f0c2
commit 86416ad
Show file tree

Hide file tree

Showing 3 changed files with 18 additions and 10 deletions.
diff --git a/docs-customization/template/dot-env.template.tmpl b/docs-customization/template/dot-env.template.tmpl
@@ -1,12 +1,13 @@
 {{- define "external_url" -}}{{- regexFind "https://(.*?)/" . | trimPrefix "https://" | trimSuffix "/" -}}{{- end -}}
+
+# .env settings
+
 <style>
     .md-content__button {
         display: none;
     }
 </style>
 
-# .env settings
-
 !!! info
 
     This is an autogenerated page containing all the settings from the default `.env.docker` file. Below is a quick overview of the most frequently changed sections

diff --git a/docs/customize/.pages b/docs/customize/.pages
@@ -0,0 +1,7 @@
+---
+nav:
+    - settings.md
+    - tags.md
+    - entrypoint.md
+    - faq.md
+    - ...
diff --git a/docs/customize/tags.md b/docs/customize/tags.md
@@ -35,6 +35,14 @@ For example
 
     The [`DOCKER_APP_PHP_VERSION`](settings.md#docker_app_php_version) setting in your `.env` file control what Pixelfed version you will be running on your server.
 
+!!! tip "About semantic versioning"
+
+    Pixelfed loosely follows [Semantic Versioning](https://semver.org/), meaning that
+
+    * [**Major** version](https://semver.org/#spec-item-4) is the first part in the versioning (`X.y.z`)
+    * [**Minor** version](https://semver.org/#spec-item-7) is the second part of the versioning `(x.Y.z)`
+    * [**Patch** version](https://semver.org/#spec-item-6) is the third part of the versioning `(x.y.Z)`
+
 <div class="annotate" markdown>
 
 | [`DOCKER_APP_PHP_VERSION`](settings.md#docker_app_php_version) | Pixelfed Version |
@@ -59,14 +67,6 @@ For example
 
 ### Semantic releases
 
-!!! tip "About semantic versioning"
-
-    Pixelfed loosely follows [Semantic Versioning](https://semver.org/), meaning that
-
-    * [**Major** version](https://semver.org/#spec-item-4) is the first part in the versioning (`X.y.z`)
-    * [**Minor** version](https://semver.org/#spec-item-7) is the second part of the versioning `(x.Y.z)`
-    * [**Patch** version](https://semver.org/#spec-item-6) is the third part of the versioning `(x.y.Z)`
-
 `v{major}`
 
 : *For example `v0` will always point to the *latest* `0.x` release of Pixelfed, using PHP 8.3 and Apache.