# 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-08-26 23:17+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 ../../contributing.rst:77 msgid "Linux / macOS:" msgstr "" #: ../../contributing.rst:44 msgid "Windows cmd" msgstr "" #: ../../contributing.rst:50 msgid "Windows PowerShell" msgstr "" #: ../../contributing.rst:56 msgid "" "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:73 msgid "Setup project" msgstr "" #: ../../contributing.rst:75 msgid "" "After activating the environment install `aiogram` from sources and their" " dependencies." msgstr "" #: ../../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:92 msgid "Making changes in code" msgstr "" #: ../../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:99 msgid "Format the code (code-style)" msgstr "" #: ../../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:111 msgid "Run tests" msgstr "" #: ../../contributing.rst:113 msgid "All changes should be tested:" msgstr "" #: ../../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:126 msgid "Docs" msgstr "" #: ../../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:137 msgid "Docs translations" msgstr "" #: ../../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:143 msgid "Before start, let's up to date all texts:" msgstr "" #: ../../contributing.rst:151 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:156 msgid "To view results:" msgstr "" #: ../../contributing.rst:164 msgid "Describe changes" msgstr "" #: ../../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 " "`..rst` file and write the description." msgstr "" #: ../../contributing.rst:169 msgid "" ":code:`` is Issue or Pull-request number, after release link to " "this issue will be published to the *Changelog* page." msgstr "" #: ../../contributing.rst:172 msgid ":code:`` is a changes category marker, it can be one of:" msgstr "" #: ../../contributing.rst:174 msgid ":code:`feature` - when you are implementing new feature" msgstr "" #: ../../contributing.rst:175 msgid ":code:`bugfix` - when you fix a bug" msgstr "" #: ../../contributing.rst:176 msgid ":code:`doc` - when you improve the docs" msgstr "" #: ../../contributing.rst:177 msgid ":code:`removal` - when you remove something from the framework" msgstr "" #: ../../contributing.rst:178 msgid "" ":code:`misc` - when changed something inside the Core or project " "configuration" msgstr "" #: ../../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:183 msgid "Complete" msgstr "" #: ../../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:190 msgid "Star on GitHub" msgstr "" #: ../../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:194 msgid "" "Adding stars makes it easier for other people to find this project and " "understand how useful it is." msgstr "" #: ../../contributing.rst:197 msgid "Guides" msgstr "" #: ../../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:202 msgid "" "This will help more people learn about the framework and learn how to use" " it" msgstr "" #: ../../contributing.rst:206 msgid "Take answers" msgstr "" #: ../../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:212 msgid "Funding" msgstr "" #: ../../contributing.rst:214 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: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 " "`_." 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 "" #~ 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 ""