Update documentation and code snippets

This commit is contained in:
2025-12-03 14:30:33 +03:00
parent 2a0ec209c3
commit 52139e5405
14 changed files with 484 additions and 200 deletions
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
@@ -21,7 +20,7 @@ msgstr ""
#: ../../root/overriding_formatting.rst:4
msgid "Форматирование вывода"
msgstr ""
msgstr "Output Formatting"
#: ../../root/overriding_formatting.rst:6
msgid ""
@@ -30,10 +29,13 @@ 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."
#: ../../root/overriding_formatting.rst:11
msgid "Управление стандартным форматированием"
msgstr ""
msgstr "Managing Standard Formatting"
#: ../../root/overriding_formatting.rst:13
msgid ""
@@ -41,22 +43,28 @@ 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."
#: ../../root/overriding_formatting.rst:15
msgid ""
"Если установить его в ``True``, стилизация текста и ASCII-арт будут "
"отключены, а системные сообщения — выводиться в «сыром» виде."
msgstr ""
"If set to ``True``, text styling and ASCII art will be disabled, and system "
"messages will be output in \"raw\" form."
#: ../../root/overriding_formatting.rst:20
msgid "Приветственное и прощальное сообщения"
msgstr ""
msgstr "Welcome and Farewell Messages"
#: ../../root/overriding_formatting.rst:22
msgid ""
"Приветственное (``initial_message``) и прощальное (``farewell_message``) "
"сообщения по умолчанию выводятся в виде ASCII-графики."
msgstr ""
"Welcome (``initial_message``) and farewell (``farewell_message``) messages are "
"displayed as ASCII art by default."
#: ../../root/overriding_formatting.rst:25
msgid ""
@@ -67,16 +75,23 @@ 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."
#: ../../root/overriding_formatting.rst:30
msgid "Кастомизация вывода"
msgstr ""
msgstr "Output Customization"
#: ../../root/overriding_formatting.rst:32
msgid ""
"Для полной замены логики вывода текста в конструкторе ``App`` "
"предусмотрен параметр ``print_func``."
msgstr ""
"For complete replacement of text output logic, the ``App`` constructor provides "
"the ``print_func`` parameter."
#: ../../root/overriding_formatting.rst:34
msgid ""
@@ -86,6 +101,10 @@ 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."
#: ../../root/overriding_formatting.rst:38
msgid ""
@@ -94,4 +113,7 @@ 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``."