Update documentation

This commit is contained in:
2025-12-04 21:01:52 +03:00
parent 6be0a94ba9
commit baebeca55b
14 changed files with 747 additions and 508 deletions
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-12-02 22:27+0300\n"
"POT-Creation-Date: 2025-12-04 20:39+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: en\n"
@@ -29,9 +29,10 @@ msgid ""
"создавать таблицы, подсвечивать синтаксис и многое другое, что улучшает "
"визуальное восприятие информации."
msgstr ""
"By default, ``Argenta`` uses the ``rich`` library for text output with enhanced "
"formatting. It allows applying colors and styles, creating tables, highlighting "
"syntax, and much more, which improves the visual perception of information."
"By default, ``Argenta`` uses the ``rich`` library for text output with "
"enhanced formatting. It allows applying colors and styles, creating "
"tables, highlighting syntax, and much more, which improves the visual "
"perception of information."
#: ../../root/overriding_formatting.rst:11
msgid "Управление стандартным форматированием"
@@ -43,16 +44,17 @@ msgid ""
"``override_system_messages: bool`` (по умолчанию ``False``), который "
"позволяет отключать стандартное форматирование."
msgstr ""
"When creating an ``App`` instance, you can use the ``override_system_messages: "
"bool`` parameter (default ``False``), which allows disabling standard formatting."
"When creating an ``App`` instance, you can use the "
"``override_system_messages: bool`` parameter (default ``False``), which "
"allows disabling standard formatting."
#: ../../root/overriding_formatting.rst:15
msgid ""
"Если установить его в ``True``, стилизация текста и ASCII-арт будут "
"Если установить его в ``True``, стилизация текста и ASCII-графика будут "
"отключены, а системные сообщения — выводиться в «сыром» виде."
msgstr ""
"If set to ``True``, text styling and ASCII art will be disabled, and system "
"messages will be output in \"raw\" form."
"If set to ``True``, text styling and ASCII graphics will be disabled, and"
" system messages will be output in \"raw\" form."
#: ../../root/overriding_formatting.rst:20
msgid "Приветственное и прощальное сообщения"
@@ -63,8 +65,8 @@ msgid ""
"Приветственное (``initial_message``) и прощальное (``farewell_message``) "
"сообщения по умолчанию выводятся в виде ASCII-графики."
msgstr ""
"Welcome (``initial_message``) and farewell (``farewell_message``) messages are "
"displayed as ASCII art by default."
"Welcome (``initial_message``) and farewell (``farewell_message``) "
"messages are displayed as ASCII art by default."
#: ../../root/overriding_formatting.rst:25
msgid ""
@@ -75,11 +77,11 @@ msgid ""
"``override_system_messages=True`` или использовать только латинские "
"символы."
msgstr ""
"The ``art`` library is designed to work with ASCII characters and **does not "
"support Cyrillic**. This leads to distortion of Russian and other Cyrillic "
"alphabet characters. If your message contains Cyrillic, it is recommended to "
"disable formatting using ``override_system_messages=True`` or use only Latin "
"characters."
"The ``art`` library is designed to work with ASCII characters and **does "
"not support Cyrillic**. This leads to distortion of Russian and other "
"Cyrillic alphabet characters. If your message contains Cyrillic, it is "
"recommended to disable formatting using ``override_system_messages=True``"
" or use only Latin characters."
#: ../../root/overriding_formatting.rst:30
msgid "Кастомизация вывода"
@@ -90,8 +92,8 @@ msgid ""
"Для полной замены логики вывода текста в конструкторе ``App`` "
"предусмотрен параметр ``print_func``."
msgstr ""
"For complete replacement of text output logic, the ``App`` constructor provides "
"the ``print_func`` parameter."
"For complete replacement of text output logic, the ``App`` constructor "
"provides the ``print_func`` parameter."
#: ../../root/overriding_formatting.rst:34
msgid ""
@@ -101,10 +103,11 @@ msgid ""
"``rich.console.Console().print``. Вы можете передать сюда свою функцию, "
"чтобы, например, логировать вывод в файл или отправлять его по сети."
msgstr ""
"**print_func**: ``Callable[[str], None]`` This parameter allows passing any "
"callable entity (for example, a function) that will be used to output all system "
"messages. By default, this is ``rich.console.Console().print``. You can pass your "
"own function here to, for example, log output to a file or send it over the network."
"**print_func**: ``Callable[[str], None]`` This parameter allows passing "
"any callable entity (for example, a function) that will be used to output"
" all system messages. By default, this is "
"``rich.console.Console().print``. You can pass your own function here to,"
" for example, log output to a file or send it over the network."
#: ../../root/overriding_formatting.rst:38
msgid ""
@@ -113,7 +116,8 @@ msgid ""
"выводиться в сыром виде, в этом случае рекомендуется переопределить "
"стандартное форматирование с помощью ``override_system_messages=True``."
msgstr ""
"When overriding the output function, you should ensure it supports ``rich`` markup, "
"otherwise system messages will be output in raw form. In this case, it is "
"recommended to override standard formatting using ``override_system_messages=True``."
"When overriding the output function, you should ensure it supports "
"``rich`` markup, otherwise system messages will be output in raw form. In"
" this case, it is recommended to override standard formatting using "
"``override_system_messages=True``."