From b8581773ff9e0a4d8cbea7e2da4f4d2663876c75 Mon Sep 17 00:00:00 2001 From: Luca Zeuch 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 --- 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 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 --- 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 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 --- 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 @@ + 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; +}