mirror of
https://github.com/aiogram/aiogram.git
synced 2025-12-13 02:19:54 +00:00
330 lines
8.5 KiB
Text
330 lines
8.5 KiB
Text
# 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"
|
|
"POT-Creation-Date: 2023-07-30 18:31+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"
|
|
"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"
|
|
|
|
#: ../../contributing.rst:3
|
|
msgid "Contributing"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:5
|
|
msgid "You're welcome to contribute to aiogram!"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:7
|
|
msgid ""
|
|
"*aiogram* is an open-source project, and anyone can contribute to it in "
|
|
"any possible way"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:11
|
|
msgid "Developing"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:13
|
|
msgid ""
|
|
"Before making any changes in the framework code, it is necessary to fork "
|
|
"the project and clone the project to your PC and know how to do a pull-"
|
|
"request."
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:16
|
|
msgid ""
|
|
"How to work with pull-request you can read in the `GitHub docs "
|
|
"<https://docs.github.com/en/pull-requests/collaborating-with-pull-"
|
|
"requests/proposing-changes-to-your-work-with-pull-requests/creating-a"
|
|
"-pull-request>`_"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:18
|
|
msgid ""
|
|
"Also in due to this project is written in Python, you will need Python to"
|
|
" be installed (is recommended to use latest Python versions, but any "
|
|
"version starting from 3.8 can be used)"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:23
|
|
msgid "Use virtualenv"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:25
|
|
msgid ""
|
|
"You can create a virtual environment in a directory using :code:`venv` "
|
|
"module (it should be pre-installed by default):"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:31
|
|
msgid ""
|
|
"This action will create a :code:`.venv` directory with the Python "
|
|
"binaries and then you will be able to install packages into that isolated"
|
|
" environment."
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:36
|
|
msgid "Activate the environment"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:38
|
|
msgid "Linux/ macOS:"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:44
|
|
msgid "Windows PoweShell"
|
|
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
|
|
msgid ""
|
|
"Also make you shure you have the latest pip version in your virtual "
|
|
"environment to avoid errors on next steps:"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:74
|
|
msgid "Setup project"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:76
|
|
msgid ""
|
|
"After activating the environment install `aiogram` from sources and their"
|
|
" dependencies:"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:82
|
|
msgid ""
|
|
"It will install :code:`aiogram` in editable mode into your virtual "
|
|
"environment and all dependencies."
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:85
|
|
msgid "Making changes in code"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:87
|
|
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
|
|
msgid "Format the code (code-style)"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:94
|
|
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
|
|
msgid "Run tests"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:106
|
|
msgid "All changes should be tested:"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:112
|
|
msgid ""
|
|
"Also if you are doing something with Redis-storage, you will need to test"
|
|
" everything works with Redis:"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:119
|
|
msgid "Docs"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:121
|
|
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
|
|
msgid "Docs translations"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:132
|
|
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
|
|
msgid "Before start, let's up to date all texts:"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:144
|
|
msgid ""
|
|
"Change the :code:`<language_code>` in example below to the target "
|
|
"language code, after that you can modify texts inside "
|
|
":code:`docs/locale/<language_code>/LC_MESSAGES` as :code:`*.po` files by "
|
|
"using any text-editor or specialized utilites for GNU Gettext, for "
|
|
"example via `poedit <https://poedit.net/>`_."
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:149
|
|
msgid "To view results:"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:157
|
|
msgid "Describe changes"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:159
|
|
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
|
|
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
|
|
msgid ":code:`<category>` is a changes category marker, it can be one of:"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:167
|
|
msgid ":code:`feature` - when you are implementing new feature"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:168
|
|
msgid ":code:`bugfix` - when you fix a bug"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:169
|
|
msgid ":code:`doc` - when you improve the docs"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:170
|
|
msgid ":code:`removal` - when you remove something from the framework"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:171
|
|
msgid ""
|
|
":code:`misc` - when changed something inside the Core or project "
|
|
"configuration"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:173
|
|
msgid ""
|
|
"If you have troubles with changing category feel free to ask Core-"
|
|
"contributors to help with choosing it."
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:176
|
|
msgid "Complete"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:178
|
|
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
|
|
msgid "Star on GitHub"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:185
|
|
msgid ""
|
|
"You can \"star\" repository on GitHub - "
|
|
"https://github.com/aiogram/aiogram (click the star button at the top "
|
|
"right)"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:187
|
|
msgid ""
|
|
"Adding stars makes it easier for other people to find this project and "
|
|
"understand how useful it is."
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:190
|
|
msgid "Guides"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:192
|
|
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
|
|
msgid ""
|
|
"This will help more people learn about the framework and learn how to use"
|
|
" it"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:199
|
|
msgid "Take answers"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:201
|
|
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
|
|
msgid "Funding"
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:207
|
|
msgid ""
|
|
"The development of the project is free and not financed by commercial "
|
|
"organizations, it is my personal initiative (`@JRootJunior "
|
|
"<https://t.me/JRootJunior>`_) and I am engaged in the development of the "
|
|
"project in my free time."
|
|
msgstr ""
|
|
|
|
#: ../../contributing.rst:211
|
|
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 "
|
|
"<https://opencollective.com/aiogram>`_."
|
|
msgstr ""
|
|
|
|
#~ 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 "
|
|
#~ "<https://opencollective.com/aiogram>`_ or `Patreon "
|
|
#~ "<https://www.patreon.com/aiogram>`_."
|
|
#~ msgstr ""
|