From b8581773ff9e0a4d8cbea7e2da4f4d2663876c75 Mon Sep 17 00:00:00 2001
From: Luca Zeuch <l-zeuch@email.de>
Date: Wed, 27 Mar 2024 10:30:06 +0100
Subject: [PATCH 1/3] hugo: increase ToC endLevel to 4
Increase the markup.tableOfContents endLevel config to 4, so that some
relatively deeply nested headers still show up in the individual page's
ToC.
This may be especially important for future pages such as template
references, where we'll be using those higher-level headers fairly
extensively.
Signed-off-by: Luca Zeuch <l-zeuch@email.de>
---
hugo.toml | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/hugo.toml b/hugo.toml
index 9caa6ca..813cb5c 100644
--- a/hugo.toml
+++ b/hugo.toml
@@ -7,6 +7,10 @@ title = 'YAGPDB Documentation v2'
uglyURLs = true
[markup]
+ [markup.tableOfContents]
+ # Some relatively important headers, like cc triggers, are on level 4;
+ # we want to have those in our table of contents, so we need to set this to 4.
+ endLevel = 4
[markup.goldmark]
[markup.goldmark.renderer]
# Enable HTML tags in Markdown
From e293fdef00c4a56f917072a2e76f818985d2911a Mon Sep 17 00:00:00 2001
From: Luca Zeuch <l-zeuch@email.de>
Date: Wed, 27 Mar 2024 10:33:57 +0100
Subject: [PATCH 2/3] hugo: remove some useless/ugly themes
Remove most of the themes that have no use beyond changing a single
colour around, or are just not very nice to look at / redundant compared
to other themes.
Internal voting has concluded that we want to keep the Zen theme. A
custom theme based on YAGPDB's colours is also being considered and
should hopefully be the default in the future.
Signed-off-by: Luca Zeuch <l-zeuch@email.de>
---
hugo.toml | 15 +++------------
1 file changed, 3 insertions(+), 12 deletions(-)
diff --git a/hugo.toml b/hugo.toml
index 813cb5c..3e673ce 100644
--- a/hugo.toml
+++ b/hugo.toml
@@ -25,18 +25,9 @@ uglyURLs = true
[params]
themeVariant = [
- { identifier = "relearn-auto", name = "Relearn Light/Dark", auto = [] },
- { identifier = "relearn-light" },
- { identifier = "relearn-dark" },
- { identifier = "relearn-bright" },
- { identifier = "zen-auto", name = "Zen Light/Dark", auto = [ "zen-light", "zen-dark" ] },
- { identifier = "zen-light" },
- { identifier = "zen-dark" },
- { identifier = "neon" },
- { identifier = "learn" },
- { identifier = "blue" },
- { identifier = "green" },
- { identifier = "red" }
+ { identifier = "zen-auto", name = "Zen Light/Dark", auto = [ "zen-light", "zen-dark" ] },
+ { identifier = "zen-light" },
+ { identifier = "zen-dark" },
]
collapsibleMenu = true
From 6d39a319083eae4516ddfe56547c91b0c4119193 Mon Sep 17 00:00:00 2001
From: Luca Zeuch <l-zeuch@email.de>
Date: Wed, 27 Mar 2024 10:36:20 +0100
Subject: [PATCH 3/3] layout: increase margin on menu sidebar items
Increase the margin on menu sidebar items (`#R-Topics`).
Prior to this change, the arrows of said items were quite close to the
edge of the viewport / screen, which makes for an... interesting
experience to look at.
Personal testing and consulting with one other person has concluded that
0.5em is good enough(tm).
Signed-off-by: Luca Zeuch <l-zeuch@email.de>
---
layouts/partials/custom-header.html | 1 +
static/css/menu.css | 6 ++++++
2 files changed, 7 insertions(+)
create mode 100644 layouts/partials/custom-header.html
create mode 100644 static/css/menu.css
diff --git a/layouts/partials/custom-header.html b/layouts/partials/custom-header.html
new file mode 100644
index 0000000..4f3e251
--- /dev/null
+++ b/layouts/partials/custom-header.html
@@ -0,0 +1 @@
+<link rel="stylesheet" href="{{ relURL "css/menu.css" }}">
diff --git a/static/css/menu.css b/static/css/menu.css
new file mode 100644
index 0000000..3761e56
--- /dev/null
+++ b/static/css/menu.css
@@ -0,0 +1,6 @@
+/* Increase the margin a little bit such that it doesn't look too crowded
+ * on the menu side bar.
+ */
+#R-topics {
+ margin-left: 0.5em;
+}