summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDan Allen <dan.j.allen@gmail.com>2024-02-27 13:04:34 -0700
committerDan Allen <dan.j.allen@gmail.com>2024-02-27 13:04:58 -0700
commit2ec935f3b0cb511ab7d910b1a167340b51f46ecf (patch)
treea9b2261efa0cebaec3381951849abbc4627349f0
parent959619d1f364d243471206be4bebed7bc1a98eed (diff)
add note as to why bundled themes use underscore as key separator instead of hyphen
-rw-r--r--docs/modules/theme/pages/language.adoc4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/modules/theme/pages/language.adoc b/docs/modules/theme/pages/language.adoc
index cf39bc42..1534e99e 100644
--- a/docs/modules/theme/pages/language.adoc
+++ b/docs/modules/theme/pages/language.adoc
@@ -32,6 +32,10 @@ See xref:blocks.adoc#align[Alignment for blocks] for more information.
See xref:text.adoc#text-align[Text alignment] for more information.
* The `font-color` property in the theme language is equivalent to the `color` property in CSS.
+TIP: When you look at the bundled themes, you'll see that they use an underscore to separate key names.
+The underscore separator is used for bundled themes since it requires no translation and those themes are loaded frequently.
+The hyphen is the preferred separator for use in custom themes since it looks clearer.
+
[#values]
== Key values