Update snippet viewer

Author: johnsamuelwrites

_plugins/snippet_tokens.rb

@@ -0,0 +1,29 @@
+module SnippetTokens
+  TOKEN = /\{\{\s*snippet:([a-zA-Z0-9_-]+)\s*\}\}/.freeze
+
+  module_function
+
+  def render(content, site, locale)
+    return content unless content&.match?(TOKEN)
+
+    content.gsub(TOKEN) do
+      snippet_id = Regexp.last_match(1)
+      snippet_path = File.join(site.source, "docs", "snippets", snippet_id, "#{locale}.code")
+      fallback_path = File.join(site.source, "docs", "snippets", snippet_id, "en.code")
+      resolved_path = File.exist?(snippet_path) ? snippet_path : fallback_path
+
+      unless File.exist?(resolved_path)
+        Jekyll.logger.warn("snippet_tokens:", "missing snippet #{snippet_id} for locale #{locale}")
+        next "<!-- missing snippet #{snippet_id} for locale #{locale} -->"
+      end
+
+      snippet = File.read(resolved_path, encoding: "utf-8").rstrip
+      "\n```python\n#{snippet}\n```\n"
+    end
+  end
+end
+
+Jekyll::Hooks.register [:pages, :documents], :pre_render do |doc|
+  locale = doc.data["locale"] || "en"
+  doc.content = SnippetTokens.render(doc.content, doc.site, locale)
+end

scripts/check_pages_artifact.py

@@ -7,6 +7,8 @@
 import sys
 from pathlib import Path
 
+SNIPPET_TOKEN = "{{snippet:"
+
 
 def main() -> int:
     parser = argparse.ArgumentParser()
@@ -32,6 +34,20 @@ def main() -> int:
         print(f"ERROR: invalid base path (must start with '/'): {args.base_path!r}")
         return 1
 
+    unresolved = []
+    for html_file in site_dir.rglob("*.html"):
+        text = html_file.read_text(encoding="utf-8")
+        if SNIPPET_TOKEN in text:
+            unresolved.append(str(html_file))
+
+    if unresolved:
+        print("ERROR: unresolved snippet tokens found in built HTML:")
+        for path in unresolved[:20]:
+            print(f" - {path}")
+        if len(unresolved) > 20:
+            print(f" - ... and {len(unresolved) - 20} more")
+        return 1
+
     print(f"Pages artifact sanity checks passed for {site_dir}")
     return 0