From e34488f4984de7b1b50507e75b32ca19c2761984 Mon Sep 17 00:00:00 2001
From: Ellpeck <me@ellpeck.de>
Date: Sat, 8 Apr 2023 14:45:45 +0200
Subject: [PATCH] improved the changelog & in-game news display on the docs
 site

---
 docs/docfx.json                        |  3 ++-
 docs/overrides/conceptual.extension.js | 15 +++++++++++++++
 2 files changed, 17 insertions(+), 1 deletion(-)
 create mode 100644 docs/overrides/conceptual.extension.js

diff --git a/docs/docfx.json b/docs/docfx.json
index 692a959..b7239c0 100644
--- a/docs/docfx.json
+++ b/docs/docfx.json
@@ -41,7 +41,8 @@
         "dest": "_site",
         "template": [
             "default",
-            "modern"
+            "modern",
+            "overrides"
         ]
     }
 }
diff --git a/docs/overrides/conceptual.extension.js b/docs/overrides/conceptual.extension.js
new file mode 100644
index 0000000..81eca13
--- /dev/null
+++ b/docs/overrides/conceptual.extension.js
@@ -0,0 +1,15 @@
+exports.preTransform = function (model) {
+    if (model._path.includes("Changelog") || model._path.includes("InGameNews")) {
+        // reduce header levels by 1
+        model.conceptual = model.rawTitle + model.conceptual;
+        for (let i = 5; i >= 1; i--) {
+            model.conceptual = model.conceptual.replaceAll(`<h${i}`, `<h${i + 1}`);
+            model.conceptual = model.conceptual.replaceAll(`</h${i}`, `</h${i + 1}`);
+        }
+
+        // set appropriate title
+        model.title = model._path.includes("Changelog") ? "Changelog" : "In-Game News";
+        model.rawTitle = `<h1>${model.title}</h1>`;
+    }
+    return model;
+};