Small documentation improvements and texts update

This commit is contained in:
Alex Root Junior 2023-08-26 23:18:20 +03:00
parent 806f8f67d5
commit ca4c1b4b95
No known key found for this signature in database
GPG key ID: 074C1D455EBEA4AC
41 changed files with 2160 additions and 1167 deletions

View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: aiogram \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-07-30 18:31+0300\n"
"POT-Creation-Date: 2023-08-26 23:17+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@ -78,112 +78,112 @@ msgstr ""
msgid "Activate the environment"
msgstr ""
#: ../../contributing.rst:38
msgid "Linux/ macOS:"
#: ../../contributing.rst:38 ../../contributing.rst:77
msgid "Linux / macOS:"
msgstr ""
#: ../../contributing.rst:44
msgid "Windows PoweShell"
msgid "Windows cmd"
msgstr ""
#: ../../contributing.rst:50
msgid ""
"To check it worked, use described command, it should show the :code:`pip`"
" location inside the isolated environment"
msgstr ""
#: ../../contributing.rst:53
msgid "Linux, macOS:"
msgstr ""
#: ../../contributing.rst:59
msgid "Windows PowerShell"
msgstr ""
#: ../../contributing.rst:65
#: ../../contributing.rst:56
msgid ""
"Also make you shure you have the latest pip version in your virtual "
"To check it worked, use described command, it should show the :code:`pip`"
" version and location inside the isolated environment"
msgstr ""
#: ../../contributing.rst:64
msgid ""
"Also make sure you have the latest pip version in your virtual "
"environment to avoid errors on next steps:"
msgstr ""
#: ../../contributing.rst:74
#: ../../contributing.rst:73
msgid "Setup project"
msgstr ""
#: ../../contributing.rst:76
#: ../../contributing.rst:75
msgid ""
"After activating the environment install `aiogram` from sources and their"
" dependencies:"
" dependencies."
msgstr ""
#: ../../contributing.rst:82
#: ../../contributing.rst:83
msgid "Windows:"
msgstr ""
#: ../../contributing.rst:89
msgid ""
"It will install :code:`aiogram` in editable mode into your virtual "
"environment and all dependencies."
msgstr ""
#: ../../contributing.rst:85
#: ../../contributing.rst:92
msgid "Making changes in code"
msgstr ""
#: ../../contributing.rst:87
#: ../../contributing.rst:94
msgid ""
"At this point you can make any changes in the code that you want, it can "
"be any fixes, implementing new features or experimenting."
msgstr ""
#: ../../contributing.rst:92
#: ../../contributing.rst:99
msgid "Format the code (code-style)"
msgstr ""
#: ../../contributing.rst:94
#: ../../contributing.rst:101
msgid ""
"Note that this project is Black-formatted, so you should follow that "
"code-style, too be sure You're correctly doing this let's reformat the "
"code automatically:"
msgstr ""
#: ../../contributing.rst:104
#: ../../contributing.rst:111
msgid "Run tests"
msgstr ""
#: ../../contributing.rst:106
#: ../../contributing.rst:113
msgid "All changes should be tested:"
msgstr ""
#: ../../contributing.rst:112
#: ../../contributing.rst:119
msgid ""
"Also if you are doing something with Redis-storage, you will need to test"
" everything works with Redis:"
msgstr ""
#: ../../contributing.rst:119
#: ../../contributing.rst:126
msgid "Docs"
msgstr ""
#: ../../contributing.rst:121
#: ../../contributing.rst:128
msgid ""
"We are using `Sphinx` to render docs in different languages, all sources "
"located in `docs` directory, you can change the sources and to test it "
"you can start live-preview server and look what you are doing:"
msgstr ""
#: ../../contributing.rst:130
#: ../../contributing.rst:137
msgid "Docs translations"
msgstr ""
#: ../../contributing.rst:132
#: ../../contributing.rst:139
msgid ""
"Translation of the documentation is very necessary and cannot be done "
"without the help of the community from all over the world, so you are "
"welcome to translate the documentation into different languages."
msgstr ""
#: ../../contributing.rst:136
#: ../../contributing.rst:143
msgid "Before start, let's up to date all texts:"
msgstr ""
#: ../../contributing.rst:144
#: ../../contributing.rst:151
msgid ""
"Change the :code:`<language_code>` in example below to the target "
"language code, after that you can modify texts inside "
@ -192,120 +192,120 @@ msgid ""
"example via `poedit <https://poedit.net/>`_."
msgstr ""
#: ../../contributing.rst:149
#: ../../contributing.rst:156
msgid "To view results:"
msgstr ""
#: ../../contributing.rst:157
#: ../../contributing.rst:164
msgid "Describe changes"
msgstr ""
#: ../../contributing.rst:159
#: ../../contributing.rst:166
msgid ""
"Describe your changes in one or more sentences so that bot developers "
"know what's changed in their favorite framework - create "
"`<code>.<category>.rst` file and write the description."
msgstr ""
#: ../../contributing.rst:162
#: ../../contributing.rst:169
msgid ""
":code:`<code>` is Issue or Pull-request number, after release link to "
"this issue will be published to the *Changelog* page."
msgstr ""
#: ../../contributing.rst:165
#: ../../contributing.rst:172
msgid ":code:`<category>` is a changes category marker, it can be one of:"
msgstr ""
#: ../../contributing.rst:167
#: ../../contributing.rst:174
msgid ":code:`feature` - when you are implementing new feature"
msgstr ""
#: ../../contributing.rst:168
#: ../../contributing.rst:175
msgid ":code:`bugfix` - when you fix a bug"
msgstr ""
#: ../../contributing.rst:169
#: ../../contributing.rst:176
msgid ":code:`doc` - when you improve the docs"
msgstr ""
#: ../../contributing.rst:170
#: ../../contributing.rst:177
msgid ":code:`removal` - when you remove something from the framework"
msgstr ""
#: ../../contributing.rst:171
#: ../../contributing.rst:178
msgid ""
":code:`misc` - when changed something inside the Core or project "
"configuration"
msgstr ""
#: ../../contributing.rst:173
#: ../../contributing.rst:180
msgid ""
"If you have troubles with changing category feel free to ask Core-"
"contributors to help with choosing it."
msgstr ""
#: ../../contributing.rst:176
#: ../../contributing.rst:183
msgid "Complete"
msgstr ""
#: ../../contributing.rst:178
#: ../../contributing.rst:185
msgid ""
"After you have made all your changes, publish them to the repository and "
"create a pull request as mentioned at the beginning of the article and "
"wait for a review of these changes."
msgstr ""
#: ../../contributing.rst:183
#: ../../contributing.rst:190
msgid "Star on GitHub"
msgstr ""
#: ../../contributing.rst:185
#: ../../contributing.rst:192
msgid ""
"You can \"star\" repository on GitHub - "
"https://github.com/aiogram/aiogram (click the star button at the top "
"right)"
msgstr ""
#: ../../contributing.rst:187
#: ../../contributing.rst:194
msgid ""
"Adding stars makes it easier for other people to find this project and "
"understand how useful it is."
msgstr ""
#: ../../contributing.rst:190
#: ../../contributing.rst:197
msgid "Guides"
msgstr ""
#: ../../contributing.rst:192
#: ../../contributing.rst:199
msgid ""
"You can write guides how to develop Bots on top of aiogram and publish it"
" into YouTube, Medium, GitHub Books, any Courses platform or any other "
"platform that you know."
msgstr ""
#: ../../contributing.rst:195
#: ../../contributing.rst:202
msgid ""
"This will help more people learn about the framework and learn how to use"
" it"
msgstr ""
#: ../../contributing.rst:199
#: ../../contributing.rst:206
msgid "Take answers"
msgstr ""
#: ../../contributing.rst:201
#: ../../contributing.rst:208
msgid ""
"The developers is always asks for any question in our chats or any other "
"platforms like GitHub Discussions, StackOverflow and others, feel free to"
" answer to this questions."
msgstr ""
#: ../../contributing.rst:205
#: ../../contributing.rst:212
msgid "Funding"
msgstr ""
#: ../../contributing.rst:207
#: ../../contributing.rst:214
msgid ""
"The development of the project is free and not financed by commercial "
"organizations, it is my personal initiative (`@JRootJunior "
@ -313,7 +313,7 @@ msgid ""
"project in my free time."
msgstr ""
#: ../../contributing.rst:211
#: ../../contributing.rst:218
msgid ""
"So, if you want to financially support the project, or, for example, give"
" me a pizza or a beer, you can do it on `OpenCollective "
@ -328,3 +328,31 @@ msgstr ""
#~ "<https://opencollective.com/aiogram>`_ or `Patreon "
#~ "<https://www.patreon.com/aiogram>`_."
#~ msgstr ""
#~ msgid "Linux/ macOS:"
#~ msgstr ""
#~ msgid "Windows PoweShell"
#~ msgstr ""
#~ msgid ""
#~ "To check it worked, use described "
#~ "command, it should show the :code:`pip`"
#~ " location inside the isolated environment"
#~ msgstr ""
#~ msgid "Linux, macOS:"
#~ msgstr ""
#~ msgid ""
#~ "Also make you shure you have the"
#~ " latest pip version in your virtual"
#~ " environment to avoid errors on next"
#~ " steps:"
#~ msgstr ""
#~ msgid ""
#~ "After activating the environment install "
#~ "`aiogram` from sources and their "
#~ "dependencies:"
#~ msgstr ""