# 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" #: ../../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 " "`_" 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:`` in example below to the target " "language code, after that you can modify texts inside " ":code:`docs/locale//LC_MESSAGES` as :code:`*.po` files by " "using any text-editor or specialized utilites for GNU Gettext, for " "example via `poedit `_." 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 " "`..rst` file and write the description." msgstr "" #: ../../contributing.rst:162 msgid "" ":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:`` 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 " "`_) 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 " "`_." 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 " #~ "`_ or `Patreon " #~ "`_." #~ msgstr ""