Externalize category display map to html-generators/categories.properties

Co-authored-by: brunoborges <129743+brunoborges@users.noreply.github.com>

Author: Copilot

html-generators/categories.properties

@@ -0,0 +1,11 @@
+language=Language
+collections=Collections
+strings=Strings
+streams=Streams
+concurrency=Concurrency
+io=I/O
+errors=Errors
+datetime=Date/Time
+security=Security
+tooling=Tooling
+enterprise=Enterprise

html-generators/generate.java

@@ -16,14 +16,23 @@
 static final Pattern TOKEN = Pattern.compile("\\{\\{(\\w+)}}");
 static final ObjectMapper MAPPER = new ObjectMapper();
 
-static final SequencedMap<String, String> CATEGORY_DISPLAY = new LinkedHashMap<>() {{
-    put("language", "Language"); put("collections", "Collections");
-    put("strings", "Strings");   put("streams", "Streams");
-    put("concurrency", "Concurrency"); put("io", "I/O");
-    put("errors", "Errors");     put("datetime", "Date/Time");
-    put("security", "Security"); put("tooling", "Tooling");
-    put("enterprise", "Enterprise");
-}};
+static final String CATEGORIES_FILE = "html-generators/categories.properties";
+static final SequencedMap<String, String> CATEGORY_DISPLAY = loadCategoryDisplay();
+
+static SequencedMap<String, String> loadCategoryDisplay() {
+    try {
+        var map = new LinkedHashMap<String, String>();
+        for (var line : Files.readAllLines(Path.of(CATEGORIES_FILE))) {
+            line = line.strip();
+            if (line.isEmpty() || line.startsWith("#")) continue;
+            var idx = line.indexOf('=');
+            if (idx > 0) map.put(line.substring(0, idx).strip(), line.substring(idx + 1).strip());
+        }
+        return map;
+    } catch (IOException e) {
+        throw new UncheckedIOException(e);
+    }
+}
 
 static final Set<String> EXCLUDED_KEYS = Set.of("_path", "prev", "next", "related");
 

html-generators/generate.py

@@ -19,19 +19,25 @@
 CONTENT_DIR = "content"
 SITE_DIR = "site"
 
-CATEGORY_DISPLAY = {
-    "language": "Language",
-    "collections": "Collections",
-    "strings": "Strings",
-    "streams": "Streams",
-    "concurrency": "Concurrency",
-    "io": "I/O",
-    "errors": "Errors",
-    "datetime": "Date/Time",
-    "security": "Security",
-    "tooling": "Tooling",
-    "enterprise": "Enterprise",
-}
+CATEGORIES_FILE = "html-generators/categories.properties"
+
+
+def load_category_display():
+    """Load category display names from the properties file."""
+    categories = {}
+    with open(CATEGORIES_FILE) as f:
+        for line in f:
+            line = line.strip()
+            if not line or line.startswith('#'):
+                continue
+            key, sep, value = line.partition('=')
+            key, value = key.strip(), value.strip()
+            if sep and key:
+                categories[key] = value
+    return categories
+
+
+CATEGORY_DISPLAY = load_category_display()
 
 
 def escape(text):
@@ -65,12 +71,8 @@ def load_template():
 def load_all_snippets():
     """Load all JSON snippet files, keyed by category/slug."""
     snippets = {}
-    categories = [
-        "language", "collections", "strings", "streams", "concurrency",
-        "io", "errors", "datetime", "security", "tooling", "enterprise",
-    ]
     json_files = []
-    for cat in categories:
+    for cat in CATEGORY_DISPLAY:
         json_files.extend(sorted(glob.glob(f"{CONTENT_DIR}/{cat}/*.json")))
     for path in json_files:
         with open(path) as f: