From ec3d767435390cebedee8e3ca504d4b20d52f735 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Tue, 9 Jun 2026 06:04:44 -0500 Subject: docs(theme-studio): warn that fill_data tokens are replaced in comments too --- scripts/theme-studio/generate.py | 3 +++ 1 file changed, 3 insertions(+) (limited to 'scripts/theme-studio') diff --git a/scripts/theme-studio/generate.py b/scripts/theme-studio/generate.py index e2a26f82..24ad7a1b 100644 --- a/scripts/theme-studio/generate.py +++ b/scripts/theme-studio/generate.py @@ -503,6 +503,9 @@ APP_JS""" # Fill the data placeholders. str.replace is literal (no backref interpretation), # so backslashes in the inlined JS survive intact — the escaping-bug class that # the triple-quoted string used to cause is gone now that app.js is a real file. +# Caveat: these tokens are replaced everywhere they appear, including inside code +# comments. Don't write a placeholder name (COLORMATH_J, APP_CORE_J, ...) in +# prose in any inlined file, or that prose gets the body spliced into it too. def fill_data(s): return (s.replace("COLORMATH_J",COLORMATH_BODY) .replace("APP_CORE_J",APP_CORE_BODY) -- cgit v1.2.3