From 2ec935f3b0cb511ab7d910b1a167340b51f46ecf Mon Sep 17 00:00:00 2001 From: Dan Allen Date: Tue, 27 Feb 2024 13:04:34 -0700 Subject: add note as to why bundled themes use underscore as key separator instead of hyphen --- docs/modules/theme/pages/language.adoc | 4 ++++ 1 file changed, 4 insertions(+) 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 -- cgit v1.2.3