BI-5092 Add COLOR, SIZE, BR to docs & suggest (#382)

* BI-5092 Add COLOR, SIZE, BR to docs & suggest

* Update ru texts

* Update en texts

Author: KonstantAnxiety

lib/dl_formula/dl_formula/definitions/functions_markup.py

@@ -251,8 +251,6 @@ class FuncColor(FuncMarkup):
     ]
     variants = make_variants("cl")
 
-    scopes = Function.scopes & ~Scope.SUGGESTED & ~Scope.DOCUMENTED
-
 
 class FuncSize(FuncMarkup):
     name = "size"
@@ -263,14 +261,12 @@ class FuncSize(FuncMarkup):
         ArgTypeSequence([MARKUP_EFFECTIVELY, DataType.STRING]),
     ]
     variants = make_variants("sz")
-    scopes = Function.scopes & ~Scope.SUGGESTED & ~Scope.DOCUMENTED
 
 
 class FuncBr(FuncMarkup):
     name = "br"
     arg_cnt = 0
     variants = make_variants("br")
-    scopes = Function.scopes & ~Scope.SUGGESTED & ~Scope.DOCUMENTED
 
 
 DEFINITIONS_MARKUP = [

lib/dl_formula_ref/dl_formula_ref/functions/markup.py

@@ -1,7 +1,9 @@
 from dl_formula_ref.categories.markup import CATEGORY_MARKUP
+from dl_formula_ref.i18n.registry import FormulaRefTranslatable as Translatable
 from dl_formula_ref.localization import get_gettext
 from dl_formula_ref.registry.base import FunctionDocRegistryItem
 from dl_formula_ref.registry.example import SimpleExample
+from dl_formula_ref.registry.note import Note
 
 
 _ = get_gettext()
@@ -40,20 +42,36 @@
 FUNCTION_COLOR = FunctionDocRegistryItem(
     name="color",
     category=CATEGORY_MARKUP,
-    description=_("Stylizes the passed text with the passed color."),
+    description=_("Enables specifying the color for the provided text."),
+    examples=[
+        SimpleExample("COLOR([text], '#5282ff')"),
+        SimpleExample("COLOR([text], 'blue')"),
+        SimpleExample("COLOR([text], 'rgb(82, 130, 255)')"),
+        SimpleExample("COLOR([text], 'rgba(82, 130, 255, 0.5)')"),
+    ],
+    notes=[
+        Note(
+            Translatable("You can specify the color in any web format, such as HEX, keyword (e.g., `green`), RGB, etc.")
+        ),
+    ],
 )
 
-
 FUNCTION_SIZE = FunctionDocRegistryItem(
     name="size",
     category=CATEGORY_MARKUP,
-    description=_("Stylizes the passed text with the passed size."),
+    description=_("Enables specifying the size (in pixels) for the provided text."),
+    examples=[
+        SimpleExample("SIZE([text], '26px')"),
+    ],
 )
 
 FUNCTION_BR = FunctionDocRegistryItem(
     name="br",
     category=CATEGORY_MARKUP,
     description=_("Adds a line break."),
+    examples=[
+        SimpleExample("'Line 1' + BR() + 'Line 2'"),
+    ],
 )
 
 FUNCTIONS_MARKUP = [

lib/dl_formula_ref/dl_formula_ref/locales/en/LC_MESSAGES/dl_formula_ref_dl_formula_ref.po

@@ -1041,10 +1041,15 @@ msgid ""
 "marked up text."
 msgstr ""
 
-msgid "Stylizes the passed text with the passed color."
+msgid "Enables specifying the color for the provided text."
 msgstr ""
 
-msgid "Stylizes the passed text with the passed size."
+msgid ""
+"You can specify the color in any web format, such as HEX, keyword (e.g., "
+"`green`), RGB, etc."
+msgstr ""
+
+msgid "Enables specifying the size (in pixels) for the provided text."
 msgstr ""
 
 msgid "Adds a line break."

lib/dl_formula_ref/dl_formula_ref/locales/ru/LC_MESSAGES/dl_formula_ref_dl_formula_ref.mo

@@ -1584,16 +1584,21 @@ msgstr ""
 "Объединяет размеченный текст. Также может быть использован для конвертации "
 "обычных строк в размеченный текст."
 
-#, fuzzy
-msgid "Stylizes the passed text with the passed color."
-msgstr "Выделяет переданный текст жирным шрифтом."
+msgid "Enables specifying the color for the provided text."
+msgstr "Позволяет указать цвет для переданного текста."
 
-#, fuzzy
-msgid "Stylizes the passed text with the passed size."
-msgstr "Выделяет переданный текст жирным шрифтом."
+msgid ""
+"You can specify the color in any web format, such as HEX, keyword (e.g., "
+"`green`), RGB, etc."
+msgstr ""
+"Цвет можно указать в любом формате представления веб-цвета: HEX, ключевым "
+"словом (например, `green`), RGB и т. д."
+
+msgid "Enables specifying the size (in pixels) for the provided text."
+msgstr "Позволяет указать размер в пикселях для переданного текста."
 
 msgid "Adds a line break."
-msgstr ""
+msgstr "Добавляет перенос строки."
 
 msgid "Returns the absolute value of {arg:0}."
 msgstr "Возвращает абсолютное значение заданного числа {arg:0}."