From b43d9fe2bbed161c9ebdb49c86353b5c78863913 Mon Sep 17 00:00:00 2001
From: Gabriele Musco <gabmus@disroot.org>
Date: Sun, 10 Dec 2023 08:58:07 +0000
Subject: [PATCH 1/2] feat: doc pages can have icons shown before the title

---
 assets/_main.scss                | 6 ++++++
 layouts/partials/docs/title.html | 7 ++++++-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/assets/_main.scss b/assets/_main.scss
index 7073e2b..826a06d 100644
--- a/assets/_main.scss
+++ b/assets/_main.scss
@@ -287,6 +287,12 @@ body[dir="rtl"] .book-menu {
   will-change: transform, margin, opacity;
 }
 
+.book-filetree-icon {
+  width: 16px;
+  height: 16px;
+  vertical-align: middle;
+}
+
 @media screen and (max-width: $mobile-breakpoint) {
   #menu-control,
   #toc-control {
diff --git a/layouts/partials/docs/title.html b/layouts/partials/docs/title.html
index 83df5b6..19620bd 100644
--- a/layouts/partials/docs/title.html
+++ b/layouts/partials/docs/title.html
@@ -3,7 +3,11 @@
   Accepts Page as context
 -->
 {{ $title := "" }}
+{{ $icon := "" }}
 
+{{ if .Params.Icon }}
+  {{ $icon = printf "<img src=\"%s\" class=\"book-filetree-icon\" />" .Params.Icon }}
+{{ end }}
 {{ if .LinkTitle }}
   {{ $title = .LinkTitle }}
 {{ else if .Title }}
@@ -14,4 +18,5 @@
   {{ $title = .File.BaseFileName | humanize | title }}
 {{ end }}
 
-{{ return $title }}
+{{ $out := printf "%s %s" $icon $title | safeHTML }}
+{{ return $out }}

From 5fcb0c09a86019fceca39bc0ed4b2632fad1b112 Mon Sep 17 00:00:00 2001
From: Gabriele Musco <gabmus@disroot.org>
Date: Sun, 10 Dec 2023 09:16:12 +0000
Subject: [PATCH 2/2] fix: only use icon where applicable

---
 layouts/partials/docs/header.html          | 2 +-
 layouts/partials/docs/menu-filetree.html   | 8 ++++----
 layouts/partials/docs/menu-hugo.html       | 2 +-
 layouts/partials/docs/title-with-icon.html | 9 +++++++++
 layouts/partials/docs/title.html           | 7 +------
 layouts/posts/list.html                    | 2 +-
 6 files changed, 17 insertions(+), 13 deletions(-)
 create mode 100644 layouts/partials/docs/title-with-icon.html

diff --git a/layouts/partials/docs/header.html b/layouts/partials/docs/header.html
index 089859c..38b0796 100644
--- a/layouts/partials/docs/header.html
+++ b/layouts/partials/docs/header.html
@@ -3,7 +3,7 @@
     <img src="{{ "svg/menu.svg" | relURL }}" class="book-icon" alt="Menu" />
   </label>
 
-  <strong>{{ partial "docs/title" . }}</strong>
+  <strong>{{ partial "docs/title-with-icon" . }}</strong>
 
   <label for="toc-control">
     {{ if default true (default .Site.Params.BookToC .Params.BookToC) }}
diff --git a/layouts/partials/docs/menu-filetree.html b/layouts/partials/docs/menu-filetree.html
index edb150c..3b713a4 100644
--- a/layouts/partials/docs/menu-filetree.html
+++ b/layouts/partials/docs/menu-filetree.html
@@ -32,18 +32,18 @@
     <input type="checkbox" id="section-{{ md5 .Page }}" class="toggle" {{ if or $current $ancestor }}checked{{ end }} />
     <label for="section-{{ md5 .Page }}" class="flex justify-between">
       <a {{ if .Page.Content }}href="{{ .Page.RelPermalink }}"{{ else }}role="button"{{ end }} class="{{ if $current }}active{{ end }}">
-        {{- partial "docs/title" .Page -}}
+        {{- partial "docs/title-with-icon" .Page -}}
       </a>
     </label>
   {{ else if .Page.Params.BookHref }}
     <a href="{{ .Page.Params.BookHref }}" class="{{ if $current }}active{{ end }}" target="_blank" rel="noopener">
-      {{- partial "docs/title" .Page -}}
+      {{- partial "docs/title-with-icon" .Page -}}
     </a>
   {{ else if .Page.Content }}
     <a href="{{ .Page.RelPermalink }}" class="{{ if $current }}active{{ end }}">
-      {{- partial "docs/title" .Page -}}
+      {{- partial "docs/title-with-icon" .Page -}}
     </a>
   {{ else }}
-    <span>{{- partial "docs/title" .Page -}}</span>
+    <span>{{- partial "docs/title-with-icon" .Page -}}</span>
   {{ end }}
 {{ end }}
diff --git a/layouts/partials/docs/menu-hugo.html b/layouts/partials/docs/menu-hugo.html
index 5f01be0..3a25b6c 100644
--- a/layouts/partials/docs/menu-hugo.html
+++ b/layouts/partials/docs/menu-hugo.html
@@ -13,7 +13,7 @@
     <a href="{{ .URL }}" {{ with .Params.class }}class="{{ . }}"{{ end }} {{ if not .Page }}target="_blank" rel="noopener"{{ end }}>
       {{- .Pre -}}
       {{ with .Page }}
-        {{ partial "docs/title" .Page }}
+        {{ partial "docs/title-with-icon" .Page }}
       {{ else }}
         {{ .Name }}
       {{ end }}
diff --git a/layouts/partials/docs/title-with-icon.html b/layouts/partials/docs/title-with-icon.html
new file mode 100644
index 0000000..fa07b16
--- /dev/null
+++ b/layouts/partials/docs/title-with-icon.html
@@ -0,0 +1,9 @@
+{{ $title := (partial "docs/title" .) }}
+{{ $icon := "" }}
+
+{{ if .Params.Icon }}
+  {{ $icon = printf "<img src=\"%s\" class=\"book-filetree-icon\" />" .Params.Icon }}
+{{ end }}
+
+{{ $out := printf "%s %s" $icon $title | safeHTML }}
+{{ return $out }}
diff --git a/layouts/partials/docs/title.html b/layouts/partials/docs/title.html
index 19620bd..83df5b6 100644
--- a/layouts/partials/docs/title.html
+++ b/layouts/partials/docs/title.html
@@ -3,11 +3,7 @@
   Accepts Page as context
 -->
 {{ $title := "" }}
-{{ $icon := "" }}
 
-{{ if .Params.Icon }}
-  {{ $icon = printf "<img src=\"%s\" class=\"book-filetree-icon\" />" .Params.Icon }}
-{{ end }}
 {{ if .LinkTitle }}
   {{ $title = .LinkTitle }}
 {{ else if .Title }}
@@ -18,5 +14,4 @@
   {{ $title = .File.BaseFileName | humanize | title }}
 {{ end }}
 
-{{ $out := printf "%s %s" $icon $title | safeHTML }}
-{{ return $out }}
+{{ return $title }}
diff --git a/layouts/posts/list.html b/layouts/posts/list.html
index badf0f6..7b01bb9 100644
--- a/layouts/posts/list.html
+++ b/layouts/posts/list.html
@@ -2,7 +2,7 @@
   {{ range sort .Paginator.Pages }}
   <article class="markdown book-post">
     <h2>
-      <a href="{{ .RelPermalink }}">{{ partial "docs/title.html" . }}</a>
+      <a href="{{ .RelPermalink }}">{{ partial "docs/title-with-icon.html" . }}</a>
     </h2>
     {{ partial "docs/post-meta" . }}
     <p>