Enhance snippet handling

.github/workflows/scripts/python/changelog_markdown2lua.py

@@ -6,6 +6,7 @@
 """
 
 import mdformat
+import re
 import yaml
 
 from argparse import ArgumentParser
@@ -71,6 +72,7 @@ def markdown2lua(version: str, content: str) -> str:
             "wrap": MAX_LINE_LENGTH,
         },
     )
+    formatted_md = remove_liquid_tags(formatted_md)
 
     escaped_md = escape_special_symbols(formatted_md)
     lua_description = ",\n".join(
@@ -97,6 +99,12 @@ def extract_yaml_front_matter(content: str) -> Tuple[str, str]:
     return '', content
 
 
+def remove_liquid_tags(text: str) -> str:
+    """Removes all Liquid block tags like {% ... %} from the given text."""
+    pattern = r"{%.*?%}\s*\n"
+    return re.sub(pattern, "", text)
+
+
 def escape_special_symbols(text: str) -> str:
     """Escapes special symbols in text for Lua compatibility."""
     return text.replace("\\", "\\\\").replace('"', '\\"')

changelog/snippets/balance.7139.md

@@ -1 +1 @@
-- (#7139) Give an on-impact water vision radius of 4 to Aeon depth charges and the Solace's cluster torpedoes to be consistent with their normal on-impact vision.
+- Give an on-impact water vision radius of 4 to Aeon depth charges and the Solace's cluster torpedoes to be consistent with their normal on-impact vision (#7139).

changelog/snippets/fix.7104.md

@@ -1,3 +1 @@
-- (#7104) Fix computing the wrong area in the navigational mesh
-
-The new values may differ from the old values by +/- 15%.
+- Fix computing the wrong area in the navigational mesh. The new values may differ from the old values by +/- 15% (#7104).

changelog/snippets/fix.7127.md

@@ -1 +1 @@
-- (#7127) Fix French locale for Selen's toggle incorrectly saying that it toggles the Selen's cloak, when it actually only toggles selection priority, and the cloak always activates when stationary. 
+- Fix French locale for Selen's toggle incorrectly saying that it toggles the Selen's cloak, when it actually only toggles selection priority, and the cloak always activates when stationary (#7127).

changelog/snippets/fix.7129.md

@@ -1 +1 @@
-- (#7129) Fix typo in unlocalised version of the descriptive name of the UEF T3 Support Land Factory.
+- Fix typo in unlocalised version of the descriptive name of the UEF T3 Support Land Factory (#7129).

changelog/snippets/fix.7139.md

@@ -1 +1 @@
-- (#7139) Align the on-impact vision radius of the Lobo's (UEL0103) fragmentation shell, Aeon depth charges, and the Solace's cluster torpedoes to the engine's vision grid (5 -> 4).
+- Align the on-impact vision radius of the Lobo's (UEL0103) fragmentation shell, Aeon depth charges, and the Solace's cluster torpedoes to the engine's vision grid (5 -> 4) (#7139).

changelog/snippets/fix.7149.md

@@ -1 +1 @@
-- (#7149) Fix missing share condition default causing a score board UI loading error when the game was launched using the single player command line launch option.
+- Fix missing share condition default causing a score board UI loading error when the game was launched using the single player command line launch option (#7149).

changelog/snippets/graphics.7095.md

@@ -0,0 +1 @@
+- Fix the icon of the Aeon T1 power generator (#7095).

changelog/snippets/other.7036.md

@@ -1 +1 @@
-- (#7036) Game repository: Update the setup instructions for the development environment.
+- Game repository: Update the setup instructions for the development environment (#7036).

changelog/snippets/other.7106.md

@@ -1 +1 @@
-- (#7106) Generate BaseTemplate tables at import time instead of parsing them from lua source files.
+- Generate BaseTemplate tables at import time instead of parsing them from lua source files (#7106).

changelog/snippets/other.7137.md

@@ -1 +1 @@
-- (#7137) Add missing annotation for `CommonArmy` game option.
+- Add missing annotation for `CommonArmy` game option (#7137).

changelog/snippets/performance.6847.md

@@ -1 +1 @@
-- (#6847) Segment formations logic into different files and simplify category filters.
+- Segment formations logic into different files and simplify category filters (#6847).

docs/_plugins/balance_change.rb

@@ -0,0 +1,24 @@
+Jekyll::Hooks.register [:pages, :documents], :post_render do |doc|
+
+  apply =
+    # Everything in _posts
+    (doc.respond_to?(:collection) && doc.collection.label == "posts") ||
+    # Generated changelogs
+    doc.respond_to?(:path) && File.basename(doc.path) == "fafbeta.md" ||
+    doc.respond_to?(:path) && File.basename(doc.path) == "fafdevelop.md"
+
+  next unless apply
+
+  # Use https://regex101.com/ to debug regex.
+  doc.output.gsub!(
+    /<li>([^<]+?)<ul>\s*<li>([^<]+?:\s)([^<]+)\s-&gt;\s([^<]+)<\/li>/,
+    '<li><span class="change-category">\1</span><ul> <li><span class="change">\2</span><span class="old">\3</span> → <span class="new">\4</span></li>'
+  )
+
+  # Needed if there is more than one change per category
+  doc.output.gsub!(
+    /<li>([^<]+?:\s)([^<]+)\s-&gt;\s([^<]+)<\/li>/,
+    '<li><span class="change">\1</span><span class="old">\2</span> → <span class="new">\3</span></li>'
+  )
+
+end

docs/_plugins/unit_block.rb

@@ -0,0 +1,41 @@
+module Jekyll
+  class UnitBlock < Liquid::Block
+
+    def initialize(tag_name, markup, tokens)
+      super
+      @unit_id = markup.strip
+    end
+
+    def render(context)
+      name = super.strip
+
+      page = context.registers[:page]
+
+      is_post = page["collection"] == "posts"
+      is_fafbeta = File.basename(page["path"]) == "fafbeta.md"
+      is_fafdevelop = File.basename(page["path"]) == "fafdevelop.md"
+
+      apply = is_post || is_fafbeta || is_fafdevelop
+      unless apply
+        return "{% unit #{@unit_id} %}\n#{name}\n{% endunit %}"
+      end
+
+      icon_name =
+        if @unit_id.start_with?("enhancements")
+          "#{@unit_id}.png"
+        else
+          "#{@unit_id.upcase}_icon.png"
+        end
+
+      <<~HTML
+      <div class="unit-header">
+        <img class="unit-icon"
+             src="/assets/icons/#{icon_name}">
+        <span class="unit-name">#{name}</span>
+      </div>
+      HTML
+    end
+  end
+end
+
+Liquid::Template.register_tag('unit', Jekyll::UnitBlock)

docs/_sass/custom/custom.scss

@@ -0,0 +1,34 @@
+.unit-header {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  margin-top: 2rem;
+  font-size: 1.2rem;
+  font-weight: 600;
+}
+
+.unit-icon {
+  width: 64px;
+  height: 64px;
+}
+
+.unit-name {
+  display: inline-block;
+}
+
+.change-category {
+  font-weight: 600;
+}
+
+.change {
+  font-weight: 300;
+}
+
+.old {
+  color: #d73a49;
+  text-decoration: line-through;
+}
+
+.new {
+  color: #2da44e;
+}