# SOME DESCRIPTIVE TITLE. # Copyright (C) 2023, aiogram Team # This file is distributed under the same license as the aiogram package. # FIRST AUTHOR , 2023. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2023-07-30 18:31+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \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 "" #: aiogram.utils.formatting.as_line:5 of msgid "separator between items, by default is empty string" msgstr "" #: 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 "" #: aiogram.utils.formatting.as_key_value:5 aiogram.utils.formatting.as_line:6 #: 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 msgid "line marker, by default is '- '" 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 msgid "number format, by default '{}. '" 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:`{key}: {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 "" #~ msgid "line marker, by default is :code:`- `" #~ msgstr "" #~ msgid "number format, by default :code:`{}. `" #~ msgstr ""