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('"', '\\"')

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;
+}