aiogram/docs/locale/en/LC_MESSAGES/utils/formatting.po

450 lines
12 KiB
Text
Raw Normal View History

2023-07-02 15:12:42 +03:00
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, aiogram Team
# This file is distributed under the same license as the aiogram package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2023.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: aiogram \n"
"Report-Msgid-Bugs-To: \n"
2023-07-30 18:32:37 +03:00
"POT-Creation-Date: 2023-07-30 18:31+0300\n"
2023-07-02 15:12:42 +03:00
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.12.1\n"
#: ../../utils/formatting.rst:5
msgid "Formatting"
msgstr ""
#: ../../utils/formatting.rst:7
msgid "Make your message formatting flexible and simple"
msgstr ""
#: ../../utils/formatting.rst:9
msgid ""
"This instrument works on top of Message entities instead of using HTML or"
" Markdown markups, you can easily construct your message and sent it to "
"the Telegram without the need to remember tag parity (opening and "
"closing) or escaping user input."
msgstr ""
#: ../../utils/formatting.rst:14
msgid "Usage"
msgstr ""
#: ../../utils/formatting.rst:17
msgid "Basic scenario"
msgstr ""
#: ../../utils/formatting.rst:19
msgid "Construct your message and send it to the Telegram."
msgstr ""
#: ../../utils/formatting.rst:26
msgid "Is the same as the next example, but without usage markup"
msgstr ""
#: ../../utils/formatting.rst:35
msgid ""
"Literally when you execute :code:`as_kwargs` method the Text object is "
"converted into text :code:`Hello, Alex!` with entities list "
":code:`[MessageEntity(type='bold', offset=7, length=4)]` and passed into "
"dict which can be used as :code:`**kwargs` in API call."
msgstr ""
#: ../../utils/formatting.rst:39
msgid ""
"The complete list of elements is listed `on this page below <#available-"
"elements>`_."
msgstr ""
#: ../../utils/formatting.rst:42
msgid "Advanced scenario"
msgstr ""
#: ../../utils/formatting.rst:44
msgid ""
"On top of base elements can be implemented content rendering structures, "
"so, out of the box aiogram has a few already implemented functions that "
"helps you to format your messages:"
msgstr ""
#: aiogram.utils.formatting.as_line:1 of
msgid "Wrap multiple nodes into line with :code:`\\\\n` at the end of line."
msgstr ""
#: aiogram.utils.formatting.Text.as_kwargs
#: aiogram.utils.formatting.as_key_value aiogram.utils.formatting.as_line
#: aiogram.utils.formatting.as_list aiogram.utils.formatting.as_marked_list
#: aiogram.utils.formatting.as_marked_section
#: aiogram.utils.formatting.as_numbered_list
#: aiogram.utils.formatting.as_numbered_section
#: aiogram.utils.formatting.as_section of
msgid "Parameters"
msgstr ""
#: aiogram.utils.formatting.as_line:3 of
msgid "Text or Any"
msgstr ""
#: aiogram.utils.formatting.as_line:4 of
msgid "ending of the line, by default is :code:`\\\\n`"
msgstr ""
2023-07-30 18:32:37 +03:00
#: aiogram.utils.formatting.as_line:5 of
msgid "separator between items, by default is empty string"
msgstr ""
2023-07-02 15:12:42 +03:00
#: aiogram.utils.formatting.Text.as_kwargs aiogram.utils.formatting.Text.render
#: aiogram.utils.formatting.as_key_value aiogram.utils.formatting.as_line
#: aiogram.utils.formatting.as_list aiogram.utils.formatting.as_marked_list
#: aiogram.utils.formatting.as_marked_section
#: aiogram.utils.formatting.as_numbered_list
#: aiogram.utils.formatting.as_numbered_section
#: aiogram.utils.formatting.as_section of
msgid "Returns"
msgstr ""
2023-07-30 18:32:37 +03:00
#: aiogram.utils.formatting.as_key_value:5 aiogram.utils.formatting.as_line:6
2023-07-02 15:12:42 +03:00
#: aiogram.utils.formatting.as_marked_list:5
#: aiogram.utils.formatting.as_numbered_list:6
#: aiogram.utils.formatting.as_section:5 of
msgid "Text"
msgstr ""
#: aiogram.utils.formatting.as_list:1 of
msgid "Wrap each element to separated lines"
msgstr ""
#: aiogram.utils.formatting.as_marked_list:1 of
msgid "Wrap elements as marked list"
msgstr ""
#: aiogram.utils.formatting.as_marked_list:4 of
2023-07-30 18:32:37 +03:00
msgid "line marker, by default is '- '"
2023-07-02 15:12:42 +03:00
msgstr ""
#: aiogram.utils.formatting.as_numbered_list:1 of
msgid "Wrap elements as numbered list"
msgstr ""
#: aiogram.utils.formatting.as_numbered_list:4 of
msgid "initial number, by default 1"
msgstr ""
#: aiogram.utils.formatting.as_numbered_list:5 of
2023-07-30 18:32:37 +03:00
msgid "number format, by default '{}. '"
2023-07-02 15:12:42 +03:00
msgstr ""
#: aiogram.utils.formatting.as_section:1 of
msgid "Wrap elements as simple section, section has title and body"
msgstr ""
#: aiogram.utils.formatting.as_marked_section:1 of
msgid "Wrap elements as section with marked list"
msgstr ""
#: aiogram.utils.formatting.as_numbered_section:1 of
msgid "Wrap elements as section with numbered list"
msgstr ""
#: aiogram.utils.formatting.as_key_value:1 of
msgid "Wrap elements pair as key-value line. (:code:`<b>{key}:</b> {value}`)"
msgstr ""
#: ../../utils/formatting.rst:64
msgid "and lets complete them all:"
msgstr ""
#: ../../utils/formatting.rst:92
msgid "Will be rendered into:"
msgstr ""
#: ../../utils/formatting.rst:94
msgid "**Success:**"
msgstr ""
#: ../../utils/formatting.rst:96
msgid "✅ Test 1"
msgstr ""
#: ../../utils/formatting.rst:98
msgid "✅ Test 3"
msgstr ""
#: ../../utils/formatting.rst:100
msgid "✅ Test 4"
msgstr ""
#: ../../utils/formatting.rst:102
msgid "**Failed:**"
msgstr ""
#: ../../utils/formatting.rst:104
msgid "❌ Test 2"
msgstr ""
#: ../../utils/formatting.rst:106
msgid "**Summary:**"
msgstr ""
#: ../../utils/formatting.rst:108
msgid "**Total**: 4"
msgstr ""
#: ../../utils/formatting.rst:110
msgid "**Success**: 3"
msgstr ""
#: ../../utils/formatting.rst:112
msgid "**Failed**: 1"
msgstr ""
#: ../../utils/formatting.rst:114
msgid "#test"
msgstr ""
#: ../../utils/formatting.rst:117
msgid "Or as HTML:"
msgstr ""
#: ../../utils/formatting.rst:137
msgid "Available methods"
msgstr ""
#: aiogram.utils.formatting.Text:1 of
msgid "Bases: :py:class:`~typing.Iterable`\\ [:py:obj:`~typing.Any`]"
msgstr ""
#: aiogram.utils.formatting.Text:1 of
msgid "Simple text element"
msgstr ""
#: aiogram.utils.formatting.Text.render:1 of
msgid "Render elements tree as text with entities list"
msgstr ""
#: aiogram.utils.formatting.Text.as_kwargs:1 of
msgid ""
"Render elements tree as keyword arguments for usage in the API call, for "
"example:"
msgstr ""
#: aiogram.utils.formatting.Text.as_html:1 of
msgid "Render elements tree as HTML markup"
msgstr ""
#: aiogram.utils.formatting.Text.as_markdown:1 of
msgid "Render elements tree as MarkdownV2 markup"
msgstr ""
#: ../../utils/formatting.rst:147
msgid "Available elements"
msgstr ""
#: aiogram.utils.formatting.Bold:1 aiogram.utils.formatting.BotCommand:1
#: aiogram.utils.formatting.CashTag:1 aiogram.utils.formatting.Code:1
#: aiogram.utils.formatting.CustomEmoji:1 aiogram.utils.formatting.Email:1
#: aiogram.utils.formatting.HashTag:1 aiogram.utils.formatting.Italic:1
#: aiogram.utils.formatting.PhoneNumber:1 aiogram.utils.formatting.Pre:1
#: aiogram.utils.formatting.Spoiler:1 aiogram.utils.formatting.Strikethrough:1
#: aiogram.utils.formatting.TextLink:1 aiogram.utils.formatting.TextMention:1
#: aiogram.utils.formatting.Underline:1 aiogram.utils.formatting.Url:1 of
msgid "Bases: :py:class:`~aiogram.utils.formatting.Text`"
msgstr ""
#: aiogram.utils.formatting.HashTag:1 of
msgid "Hashtag element."
msgstr ""
#: aiogram.utils.formatting.HashTag:5 of
msgid "The value should always start with '#' symbol"
msgstr ""
#: aiogram.utils.formatting.HashTag:7 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type "
":obj:`aiogram.enums.message_entity_type.MessageEntityType.HASHTAG`"
msgstr ""
#: aiogram.utils.formatting.CashTag:1 of
msgid "Cashtag element."
msgstr ""
#: aiogram.utils.formatting.CashTag:5 of
msgid "The value should always start with '$' symbol"
msgstr ""
#: aiogram.utils.formatting.CashTag:7 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type "
":obj:`aiogram.enums.message_entity_type.MessageEntityType.CASHTAG`"
msgstr ""
#: aiogram.utils.formatting.BotCommand:1 of
msgid "Bot command element."
msgstr ""
#: aiogram.utils.formatting.BotCommand:5 of
msgid "The value should always start with '/' symbol"
msgstr ""
#: aiogram.utils.formatting.BotCommand:7 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type "
":obj:`aiogram.enums.message_entity_type.MessageEntityType.BOT_COMMAND`"
msgstr ""
#: aiogram.utils.formatting.Url:1 of
msgid "Url element."
msgstr ""
#: aiogram.utils.formatting.Url:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.URL`"
msgstr ""
#: aiogram.utils.formatting.Email:1 of
msgid "Email element."
msgstr ""
#: aiogram.utils.formatting.Email:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type "
":obj:`aiogram.enums.message_entity_type.MessageEntityType.EMAIL`"
msgstr ""
#: aiogram.utils.formatting.PhoneNumber:1 of
msgid "Phone number element."
msgstr ""
#: aiogram.utils.formatting.PhoneNumber:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type "
":obj:`aiogram.enums.message_entity_type.MessageEntityType.PHONE_NUMBER`"
msgstr ""
#: aiogram.utils.formatting.Bold:1 of
msgid "Bold element."
msgstr ""
#: aiogram.utils.formatting.Bold:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.BOLD`"
msgstr ""
#: aiogram.utils.formatting.Italic:1 of
msgid "Italic element."
msgstr ""
#: aiogram.utils.formatting.Italic:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type "
":obj:`aiogram.enums.message_entity_type.MessageEntityType.ITALIC`"
msgstr ""
#: aiogram.utils.formatting.Underline:1 of
msgid "Underline element."
msgstr ""
#: aiogram.utils.formatting.Underline:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type "
":obj:`aiogram.enums.message_entity_type.MessageEntityType.UNDERLINE`"
msgstr ""
#: aiogram.utils.formatting.Strikethrough:1 of
msgid "Strikethrough element."
msgstr ""
#: aiogram.utils.formatting.Strikethrough:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type "
":obj:`aiogram.enums.message_entity_type.MessageEntityType.STRIKETHROUGH`"
msgstr ""
#: aiogram.utils.formatting.Spoiler:1 of
msgid "Spoiler element."
msgstr ""
#: aiogram.utils.formatting.Spoiler:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type "
":obj:`aiogram.enums.message_entity_type.MessageEntityType.SPOILER`"
msgstr ""
#: aiogram.utils.formatting.Code:1 of
msgid "Code element."
msgstr ""
#: aiogram.utils.formatting.Code:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.CODE`"
msgstr ""
#: aiogram.utils.formatting.Pre:1 of
msgid "Pre element."
msgstr ""
#: aiogram.utils.formatting.Pre:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.PRE`"
msgstr ""
#: aiogram.utils.formatting.TextLink:1 of
msgid "Text link element."
msgstr ""
#: aiogram.utils.formatting.TextLink:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type "
":obj:`aiogram.enums.message_entity_type.MessageEntityType.TEXT_LINK`"
msgstr ""
#: aiogram.utils.formatting.TextMention:1 of
msgid "Text mention element."
msgstr ""
#: aiogram.utils.formatting.TextMention:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type "
":obj:`aiogram.enums.message_entity_type.MessageEntityType.TEXT_MENTION`"
msgstr ""
#: aiogram.utils.formatting.CustomEmoji:1 of
msgid "Custom emoji element."
msgstr ""
#: aiogram.utils.formatting.CustomEmoji:3 of
msgid ""
"Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` "
"with type "
":obj:`aiogram.enums.message_entity_type.MessageEntityType.CUSTOM_EMOJI`"
msgstr ""
2023-07-30 18:32:37 +03:00
#~ msgid "line marker, by default is :code:`- `"
#~ msgstr ""
#~ msgid "number format, by default :code:`{}. `"
#~ msgstr ""