From 679bd3b7b07b43ae83d8bc01a8b3ecf83b046930 Mon Sep 17 00:00:00 2001 From: Xinhui Yang Date: Sat, 9 May 2026 10:38:35 +0800 Subject: [PATCH 1/8] config: swith to a more legible theme with a slight background The 
 element should have a background to emphasize the element from
the background.
---
 config.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/config.toml b/config.toml
index 5e543a3..6f99be0 100644
--- a/config.toml
+++ b/config.toml
@@ -17,7 +17,7 @@ taxonomies = [
 [markdown.highlighting]
 error_on_missing_language = false
 style = "inline"
-light_theme = "min-light"
+light_theme = "one-light"
 dark_theme = "material-theme-darker"
 
 [extra]

From 44e4b50b70613870de0e7f33dfbec9f69f197a7c Mon Sep 17 00:00:00 2001
From: Xinhui Yang 
Date: Fri, 8 May 2026 11:39:08 +0800
Subject: [PATCH 2/8] sass: limit the width of images

---
 sass/_main.sass | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/sass/_main.sass b/sass/_main.sass
index 6c4f645..a715806 100644
--- a/sass/_main.sass
+++ b/sass/_main.sass
@@ -171,3 +171,5 @@ footer
     line-height: 2.6rem
     text-align: center
 
+img
+  max-width: 40rem

From f092457689b3ec600ceabfefd97c20a682162574 Mon Sep 17 00:00:00 2001
From: Xinhui Yang 
Date: Fri, 8 May 2026 13:19:11 +0800
Subject: [PATCH 3/8] sass: add styling for  element

---
 sass/_color.sass      |  4 ++++
 sass/_color_dark.sass |  5 +++++
 sass/_main.sass       | 13 +++++++++++++
 3 files changed, 22 insertions(+)

diff --git a/sass/_color.sass b/sass/_color.sass
index 5863e57..1222dae 100644
--- a/sass/_color.sass
+++ b/sass/_color.sass
@@ -9,6 +9,10 @@ blockquote
 
 del
   color: #979593
+kbd
+  box-shadow: 0px 1px 2px 0px #444
+  border: 1px solid #a5a5a5
+  background: #eee
 
 code
   background-color: #f3f2f1
diff --git a/sass/_color_dark.sass b/sass/_color_dark.sass
index 19a468b..bf5c420 100644
--- a/sass/_color_dark.sass
+++ b/sass/_color_dark.sass
@@ -31,6 +31,11 @@
   blockquote
     color: #e1dfdd
 
+  kbd
+    box-shadow: 0px 1px 0 1px #888
+    border: 1px solid #ccc
+    background: #222
+
   code
     background-color: #323130
 
diff --git a/sass/_main.sass b/sass/_main.sass
index a715806..b412f83 100644
--- a/sass/_main.sass
+++ b/sass/_main.sass
@@ -173,3 +173,16 @@ footer
 
 img
   max-width: 40rem
+
+kbd
+  display: inline-block
+  font-family: sans-serif
+  font-size: 8pt
+  border-radius: 4px
+  cursor: default
+  line-height: 1
+  margin: 0 0.5rem
+  padding: 3px 6px
+  position: relative
+  top: -3px
+  user-select: none

From 943a526415411fb00309f84d62b4ac6aa4a1dc40 Mon Sep 17 00:00:00 2001
From: Xinhui Yang 
Date: Thu, 7 May 2026 16:05:02 +0800
Subject: [PATCH 4/8] sass: use serif fonts and increase the font weight in
 card titles

---
 sass/_components.sass | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/sass/_components.sass b/sass/_components.sass
index b3ba328..c93fd34 100644
--- a/sass/_components.sass
+++ b/sass/_components.sass
@@ -5,8 +5,7 @@
   .header
     margin-bottom: .25em
     font-size: 1.2em
-    font-weight: 600
-    font-family: $sansSerifFonts
+    font-weight: 700
     text-transform: capitalize
     // To align them
     display: flex

From 6391b06bde98b1db3286150e315d7642ceb90d45 Mon Sep 17 00:00:00 2001
From: Xinhui Yang 
Date: Sat, 9 May 2026 10:40:45 +0800
Subject: [PATCH 5/8] sass: remove pre-defined color for 
 -> 

Let the highlighting themes to handle this job.
---
 sass/_color.sass      | 9 ---------
 sass/_color_dark.sass | 3 ---
 sass/_typography.sass | 4 ----
 3 files changed, 16 deletions(-)

diff --git a/sass/_color.sass b/sass/_color.sass
index 1222dae..58f3d6c 100644
--- a/sass/_color.sass
+++ b/sass/_color.sass
@@ -14,15 +14,6 @@ kbd
   border: 1px solid #a5a5a5
   background: #eee
 
-code
-  background-color: #f3f2f1
-
-pre
-  code
-    // So we can see non-colored text
-    color: #c0c5ce
-    background-color: transparent
-
 table
   border-color: #a19f9d
   th
diff --git a/sass/_color_dark.sass b/sass/_color_dark.sass
index bf5c420..68ba8c9 100644
--- a/sass/_color_dark.sass
+++ b/sass/_color_dark.sass
@@ -36,9 +36,6 @@
     border: 1px solid #ccc
     background: #222
 
-  code
-    background-color: #323130
-
   table
     border-color: #c8c6c4
     th
diff --git a/sass/_typography.sass b/sass/_typography.sass
index 887d74c..b293e85 100644
--- a/sass/_typography.sass
+++ b/sass/_typography.sass
@@ -48,10 +48,6 @@ pre
   overflow-x: auto
   padding: 1rem
   line-height: 1.2
-  code
-    // So we can see non-colored text
-    color: #c0c5ce
-    background-color: transparent
 
 // Table formatting
 table

From 4ff139aad25c94ae74e973bce4e13140d98f32fb Mon Sep 17 00:00:00 2001
From: Xinhui Yang 
Date: Thu, 7 May 2026 15:57:45 +0800
Subject: [PATCH 6/8] templates: allow alternative title in cards

This does not affect existing cards (omitting `title' is allowed):

{% card(type="warning") %}
Writing a person's name with a red pen is considered disrespectful.
{% end %}

To use an alternative title, specify a title in the `card()` template
call:

{% card(type="warning", title="ACHTUNG") %}
Rauchen ist hier verboten.
{% end %}
---
 templates/shortcodes/card.html | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/templates/shortcodes/card.html b/templates/shortcodes/card.html
index 4d53ba4..6e91e07 100644
--- a/templates/shortcodes/card.html
+++ b/templates/shortcodes/card.html
@@ -13,7 +13,13 @@
 

   

     
{{ icon | safe }}

-    {{ trans(key=type) }}
+    
+      {% if title %}
+        {{ title }}
+      {% else %}
+        {{ trans(key=type, lang=lang) }}
+      {% endif %}
+    
   

   

     {{ body | markdown(inline=true) | safe }}

From 8d9ee2757b096f240b7195eddc9f6ac934555724 Mon Sep 17 00:00:00 2001
From: Xinhui Yang 
Date: Thu, 7 May 2026 16:10:52 +0800
Subject: [PATCH 7/8] templates: add new card type "tips", reusing color scheme
 of "info"

---
 config.toml                    | 2 ++
 sass/_color.sass               | 2 +-
 sass/_color_dark.sass          | 2 +-
 templates/shortcodes/card.html | 2 ++
 4 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/config.toml b/config.toml
index 6f99be0..b7aee15 100644
--- a/config.toml
+++ b/config.toml
@@ -39,6 +39,7 @@ on_this_page = "On This Page"
 categories = "Categories:"
 footer_msg = "Unless specified, works on this wiki are licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/?ref=chooser-v1)."
 info = "Info"
+tips = "Tips"
 warning = "Warning"
 danger = "Danger"
 success = "Success"
@@ -58,6 +59,7 @@ on_this_page = "本页内容"
 categories = "类别："
 footer_msg = "除非另行声明，此 Wiki 的内容采用 [知识共享署名 4.0 国际许可协议](https://creativecommons.org/licenses/by/4.0/) 进行许可。"
 info = "信息"
+tips = "提示"
 warning = "警告"
 danger = "危险"
 success = "成功"
diff --git a/sass/_color.sass b/sass/_color.sass
index 58f3d6c..43e410d 100644
--- a/sass/_color.sass
+++ b/sass/_color.sass
@@ -70,7 +70,7 @@ article
 .card.success
   color: #498205
   fill: #498205
-.card.info
+.card.info, .card.tips
   color: #0078d4
   fill: #0078d4
 .card.warning
diff --git a/sass/_color_dark.sass b/sass/_color_dark.sass
index 68ba8c9..a035512 100644
--- a/sass/_color_dark.sass
+++ b/sass/_color_dark.sass
@@ -54,7 +54,7 @@
   .card.success
     fill: #00ad56
     color: #00ad56
-  .card.info
+  .card.info, .card.tips
     fill: #00b7c3
     color: #00b7c3
   .card.warning
diff --git a/templates/shortcodes/card.html b/templates/shortcodes/card.html
index 6e91e07..30efa5d 100644
--- a/templates/shortcodes/card.html
+++ b/templates/shortcodes/card.html
@@ -6,6 +6,8 @@
 {% set icon = "Warning" %}
 {% elif type == "danger" %}
 {% set icon = "Nuclear" %}
+{% elif type == "tips" %}
+{% set icon = "" %}
 {% else %}
 {% set icon = "Information Circle" %}
 {% endif %}

From c4d7e98c42a2da8fbc7279c6ece4f239ef259254 Mon Sep 17 00:00:00 2001
From: Xinhui Yang 
Date: Thu, 7 May 2026 17:21:51 +0800
Subject: [PATCH 8/8] templates: remove hard-coded sort criteria in section
 template

---
 templates/section.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates/section.html b/templates/section.html
index 6d70511..a67ccaa 100644
--- a/templates/section.html
+++ b/templates/section.html
@@ -66,7 +66,7 @@ 
{{ section.title }}

         
       {% endfor %}
 
-      {% set pages = section.pages | sort(attribute="title") %}
+      {% set pages = section.pages %}
       {% for post in pages %}
         {{ post.title }}
       {% endfor %}