mirror of
https://github.com/satwikkansal/wtfpython
synced 2024-11-13 06:58:53 +01:00
Move translated files to translations/ru-russian
This commit is contained in:
Vadim Nifadev
parent
6f35f00461
commit
b1684aaf39
70
CONTRIBUTING.md
vendored
70
CONTRIBUTING.md
vendored
@ -1,63 +1,63 @@
|
|||||||
Приветствуются все виды изменений. Не стесняйтесь предлагать броские и смешные названия для существующих примеров. Цель - сделать эту коллекцию как можно более интересной для чтения. Вот несколько способов, с помощью которых вы можете внести свой вклад,
|
All kinds of patches are welcome. Feel free to even suggest some catchy and funny titles for the existing Examples. The goal is to make this collection as interesting to read as possible. Here are a few ways through which you can contribute,
|
||||||
|
|
||||||
- Если вы заинтересованы в переводе проекта на другой язык (некоторые люди уже делали это в прошлом), пожалуйста, не стесняйтесь открыть тему и дайте мне знать, если вам нужна какая-либо помощь.
|
- If you are interested in translating the project to another language (some people have done that in the past), please feel free to open up an issue, and let me know if you need any kind of help.
|
||||||
- Если изменения, которые вы предлагаете, значительны, то создание issue перед внесением изменений будет оценено по достоинству. Если вы хотите поработать над issue (это очень рекомендуется), выразите свою заинтересованность и вы будете назначены исполнителем.
|
- If the changes you suggest are significant, filing an issue before submitting the actual patch will be appreciated. If you'd like to work on the issue (highly encouraged), you can mention that you're interested in working on it while creating the issue and get assigned to it.
|
||||||
- Если вы добавляете новый пример, настоятельно рекомендуется создать issue, чтобы обсудить ее перед отправкой изменений. Для добавления нового примера вы можете использовать следующий шаблон:
|
- If you're adding a new example, it is highly recommended to create an issue to discuss it before submitting a patch. You can use the following template for adding a new example:
|
||||||
|
|
||||||
<pre>
|
<pre>
|
||||||
### ▶ Какое-то причудливое название. *
|
### ▶ Some fancy Title *
|
||||||
* в конце названия означает, что пример был добавлен недавно.
|
The asterisk at the end of the title indicates the example was not present in the first release and has been recently added.
|
||||||
|
|
||||||
```py
|
```py
|
||||||
# Подготовка кода.
|
# Setting up the code.
|
||||||
# Подготовка к волшебству...
|
# Preparation for the magic...
|
||||||
```
|
```
|
||||||
|
|
||||||
**Вывод (версия Python):**
|
**Output (Python version):**
|
||||||
```py
|
```py
|
||||||
>>> triggering_statement
|
>>> triggering_statement
|
||||||
Вероятно, неожиданный вывод
|
Probably unexpected output
|
||||||
|
|
||||||
```
|
```
|
||||||
(Необязательно): Одна строка, описывающая неожиданный вывод.
|
(Optional): One line describing the unexpected output.
|
||||||
|
|
||||||
#### 💡 Объяснение:
|
#### 💡 Explanation:
|
||||||
* Краткое объяснение того, что происходит и почему это происходит.
|
* Brief explanation of what's happening and why is it happening.
|
||||||
```py
|
```py
|
||||||
Подготовка примеров для пояснения (при необходимости)
|
Setting up examples for clarification (if necessary)
|
||||||
```
|
```
|
||||||
|
**Output:**
|
||||||
**Вывод:**
|
|
||||||
```py
|
```py
|
||||||
>>> trigger # пример, облегчающий понимание магии
|
>>> trigger # some example that makes it easy to unveil the magic
|
||||||
# обоснованный вывод
|
# some justified output
|
||||||
|
```
|
||||||
```
|
```
|
||||||
</pre>
|
</pre>
|
||||||
|
|
||||||
Несколько моментов, которые стоит учитывать при написании примера,
|
|
||||||
|
|
||||||
- Если вы решили отправить новый пример без создания issue и обсуждения, пожалуйста, проверьте проект, чтобы убедиться, что в нем уже нет похожих примеров.
|
Few things that you can consider while writing an example,
|
||||||
- Старайтесь быть последовательными в именах и значениях, которые вы используете для переменных. Например, большинство имен переменных в проекте имеют вид `some_string`, `some_list`, `some_dict` и т.д. Вы увидите много `x` для однобуквенных имен переменных, и `"wtf"` в качестве значений для строк. В проекте нет строгой схемы, как таковой, но вы можете взглянуть на другие примеры, чтобы понять суть.
|
|
||||||
- Старайтесь быть как можно более креативными, чтобы добавить элемент "сюрприза" во время подготовки примеров. Иногда это может означать написание фрагмента, который здравомыслящий программист никогда бы не написал.
|
|
||||||
- Также не стесняйтесь добавлять свое имя в список [контрибьюторов](/CONTRIBUTORS.md).
|
|
||||||
|
|
||||||
**Некоторые часто задаваемые вопросы**
|
- If you are choosing to submit a new example without creating an issue and discussing, please check the project to make sure there aren't similar examples already.
|
||||||
|
- Try to be consistent with the namings and the values you use with the variables. For instance, most variable names in the project are along the lines of `some_string`, `some_list`, `some_dict`, etc. You'd see a lot of `x`s for single letter variable names, and `"wtf"` as values for strings. There's no strictly enforced scheme in the project as such, but you can take a glance at other examples to get a gist.
|
||||||
|
- Try to be as creative as possible to add that element of "surprise" in the setting up part of an example. Sometimes this may mean writing a snippet a sane programmer would never write.
|
||||||
|
- Also, feel free to add your name to the [contributors list](/CONTRIBUTORS.md).
|
||||||
|
|
||||||
Что это такое после каждого заголовка сниппета (###) в README: <!-- ID примера: 30f1d3fc-e267-4b30-84ef-4d9e7091ac1a --->? Нужно ли его добавлять вручную или можно игнорировать при создании новых сниппетов?
|
**Some FAQs**
|
||||||
|
|
||||||
Это случайный UUID, он используется для идентификации примеров в нескольких переводах проекта. Как контрибьютор, вы не должны беспокоиться о том, как он используется, вы просто должны добавлять новый случайный UUID к новым примерам в этом формате.
|
What is is this after every snippet title (###) in the README: <!-- Example ID: 30f1d3fc-e267-4b30-84ef-4d9e7091ac1a --->? Should it be added manually or can it be ignored when creating new snippets?
|
||||||
|
|
||||||
Куда следует добавлять новые сниппеты? В начало/в конец раздела?
|
That's a random UUID, it is used to keep identify the examples across multiple translations of the project. As a contributor, you don't have to worry about behind the scenes of how it is used, you just have to add a new random UUID to new examples in that format.
|
||||||
|
|
||||||
При определении порядка учитывается множество факторов (зависимость от других примеров, уровень сложности, категория и т.д.). Я бы предложил просто добавить новый пример в конец раздела, который вы считаете более подходящим (или просто добавить его в раздел "Разное"). О его порядке можно будет позаботиться в будущих редакциях.
|
Where should new snippets be added? Top/bottom of the section, doesn't ?
|
||||||
|
|
||||||
В чем разница между разделами (первые два очень похожи)?
|
There are multiple things that are considered to decide the order (the dependency on the other examples, difficulty level, category, etc). I'd suggest simply adding the new example at the bottom of a section you find more fitting (or just add it to the Miscellaneous section). Its order will be taken care of in future revisions.
|
||||||
|
|
||||||
Раздел "Напрягите мозг" содержит более надуманные примеры, с которыми вы не столкнетесь в реальной жизни, в то время как раздел "Скользкие склоны" содержит примеры, с которыми можно чаще сталкиваться при программировании.
|
What's the difference between the sections (the first two feel very similar)?
|
||||||
|
|
||||||
Перед оглавлением написано, что для его создания использовался markdown-toc -i README.md --maxdepth 3. Пакет pip markdown-toc не содержит ни флагов -i, ни --maxdepth. Какой пакет имеется в виду, или какая версия этого пакета?
|
The section "Strain your brain" contains more contrived examples that you may not really encounter in real life, whereas the section "Slippery Slopes" contains examples that have the potential to be encountered more frequently while programming.
|
||||||
Должна ли новая запись в оглавлении для фрагмента быть создана с помощью вышеуказанной команды или вручную (в случае, если вышеуказанная команда делает больше, чем просто добавляет запись)?
|
|
||||||
|
|
||||||
Мы используем пакет [markdown-toc](https://www.npmjs.com/package/markdown-toc) npm для создания ToC (содержание). Однако у него есть некоторые проблемы со специальными символами (не уверен, что они уже исправлены). Чаще всего я просто вставляю ссылку toc вручную в нужное место. Инструмент удобен, когда мне нужно сделать большую перестановку, в остальных случаях просто обновлять toc вручную удобнее.
|
Before the table of contents it says that markdown-toc -i README.md --maxdepth 3 was used to create it. The pip package markdown-toc does not contain either -i or --maxdepth flags. Which package is meant, or what version of that package?
|
||||||
|
Should the new table of contents entry for the snippet be created with the above command or created manually (in case the above command does more than only add the entry)?
|
||||||
|
|
||||||
Если у вас есть вопросы, не стесняйтесь спрашивать в [issue](https://github.com/satwikkansal/wtfpython/issues/269) (спасибо [@LiquidFun](https://github.com/LiquidFun) за ее создание).
|
We use the [markdown-toc](https://www.npmjs.com/package/markdown-toc) npm package to generate ToC. It has some issues with special characters though (I'm not sure if it's fixed yet). More often than not, I just end up inserting the toc link manually at the right place. The tool is handy when I have to big reordering, otherwise just updating toc manually is more convenient imo.
|
||||||
|
|
||||||
|
If you have any questions feel free to ask on [this issue](https://github.com/satwikkansal/wtfpython/issues/269) (thanks to [@LiquidFun](https://github.com/LiquidFun) for starting it).
|
||||||
12
CONTRIBUTORS.md
vendored
12
CONTRIBUTORS.md
vendored
@ -1,6 +1,6 @@
|
|||||||
Ниже перечислены (без определенного порядка) замечательные люди, которые внесли вклад в развитие wtfpython.
|
Following are the wonderful people (in no specific order) who have contributed their examples to wtfpython.
|
||||||
|
|
||||||
| Автор | Github | Issues |
|
| Contributor | Github | Issues |
|
||||||
|-------------|--------|--------|
|
|-------------|--------|--------|
|
||||||
| Lucas-C | [Lucas-C](https://github.com/Lucas-C) | [#36](https://github.com/satwikkansal/wtfpython/issues/36) |
|
| Lucas-C | [Lucas-C](https://github.com/Lucas-C) | [#36](https://github.com/satwikkansal/wtfpython/issues/36) |
|
||||||
| MittalAshok | [MittalAshok](https://github.com/MittalAshok) | [#23](https://github.com/satwikkansal/wtfpython/issues/23) |
|
| MittalAshok | [MittalAshok](https://github.com/MittalAshok) | [#23](https://github.com/satwikkansal/wtfpython/issues/23) |
|
||||||
@ -28,15 +28,15 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**Переводчики**
|
**Translations**
|
||||||
|
|
||||||
| Переводчик | Github | Язык |
|
| Translator | Github | Language |
|
||||||
|-------------|--------|--------|
|
|-------------|--------|--------|
|
||||||
| leisurelicht | [leisurelicht](https://github.com/leisurelicht) | [Chinese](https://github.com/leisurelicht/wtfpython-cn) |
|
| leisurelicht | [leisurelicht](https://github.com/leisurelicht) | [Chinese](https://github.com/leisurelicht/wtfpython-cn) |
|
||||||
| vuduclyunitn | [vuduclyunitn](https://github.com/vuduclyunitn) | [Vietnamese](https://github.com/vuduclyunitn/wtfptyhon-vi) |
|
| vuduclyunitn | [vuduclyunitn](https://github.com/vuduclyunitn) | [Vietnamese](https://github.com/vuduclyunitn/wtfptyhon-vi) |
|
||||||
| José De Freitas | [JoseDeFreitas](https://github.com/JoseDeFreitas) | [Spanish](https://github.com/JoseDeFreitas/wtfpython-es) |
|
| José De Freitas | [JoseDeFreitas](https://github.com/JoseDeFreitas) | [Spanish](https://github.com/JoseDeFreitas/wtfpython-es) |
|
||||||
| Vadim Nifadev | [nifadyev](https://github.com/nifadyev) | [Russian](https://github.com/satwikkansal/wtfpython/tree/main/translations/README-ru.md) |
|
| Vadim Nifadev | [nifadyev](https://github.com/nifadyev) | [Russian](https://github.com/satwikkansal/wtfpython/tree/main/translations/README-ru.md) |
|
||||||
|
|
||||||
Спасибо всем за ваше время и за то, что делаете wtfpython еще более потрясающим! :smile:
|
Thank you all for your time and making wtfpython more awesome! :smile:
|
||||||
|
|
||||||
PS: Этот список обновляется после каждого крупного релиза, если я забыл добавить сюда ваш вклад, пожалуйста, не стесняйтесь сделать Pull request.
|
PS: This list is updated after every major release, if I forgot to add your contribution here, please feel free to raise a Pull request.
|
||||||
105
code-of-conduct.md
vendored
105
code-of-conduct.md
vendored
@ -1,70 +1,73 @@
|
|||||||
# Кодекс Поведения участника
|
# Contributor Covenant Code of Conduct
|
||||||
|
|
||||||
## Наши обязательства
|
## Our Pledge
|
||||||
|
|
||||||
Мы, как участники, авторы и лидеры обязуемся сделать участие в сообществе
|
In the interest of fostering an open and welcoming environment, we as
|
||||||
свободным от притеснений для всех, независимо от возраста, телосложения,
|
contributors and maintainers pledge to making participation in our project and
|
||||||
видимых или невидимых ограничений способности, этнической принадлежности,
|
our community a harassment-free experience for everyone, regardless of age, body
|
||||||
половых признаков, гендерной идентичности и выражения, уровня опыта,
|
size, disability, ethnicity, gender identity and expression, level of experience,
|
||||||
образования, социально-экономического статуса, национальности, внешности,
|
education, socio-economic status, nationality, personal appearance, race,
|
||||||
расы, религии, или сексуальной идентичности и ориентации.
|
religion, or sexual identity and orientation.
|
||||||
|
|
||||||
Мы обещаем действовать и взаимодействовать таким образом, чтобы вносить вклад в открытое,
|
## Our Standards
|
||||||
дружелюбное, многообразное, инклюзивное и здоровое сообщество.
|
|
||||||
|
|
||||||
## Наши стандарты
|
Examples of behavior that contributes to creating a positive environment
|
||||||
|
include:
|
||||||
|
|
||||||
Примеры поведения, создающие условия для благоприятных взаимоотношений включают в себя:
|
* Using welcoming and inclusive language
|
||||||
|
* Being respectful of differing viewpoints and experiences
|
||||||
|
* Gracefully accepting constructive criticism
|
||||||
|
* Focusing on what is best for the community
|
||||||
|
* Showing empathy towards other community members
|
||||||
|
|
||||||
* Проявление доброты и эмпатии к другим участникам проекта
|
Examples of unacceptable behavior by participants include:
|
||||||
* Уважение к чужой точке зрения и опыту
|
|
||||||
* Конструктивная критика и принятие конструктивной критики
|
|
||||||
* Принятие ответственности, принесение извинений тем, кто пострадал от наших ошибок
|
|
||||||
и извлечение уроков из опыта
|
|
||||||
* Ориентирование на то, что лучше подходит для сообщества, а не только для нас лично
|
|
||||||
|
|
||||||
Примеры неприемлемого поведения участников включают в себя:
|
* The use of sexualized language or imagery and unwelcome sexual attention or
|
||||||
|
advances
|
||||||
|
* Trolling, insulting/derogatory comments, and personal or political attacks
|
||||||
|
* Public or private harassment
|
||||||
|
* Publishing others' private information, such as a physical or electronic
|
||||||
|
address, without explicit permission
|
||||||
|
* Other conduct which could reasonably be considered inappropriate in a
|
||||||
|
professional setting
|
||||||
|
|
||||||
* Использование выражений или изображений сексуального характера и нежелательное сексуальное внимание или домогательство в любой форме
|
## Our Responsibilities
|
||||||
* Троллинг, оскорбительные или уничижительные комментарии, переход на личности или затрагивание политических убеждений
|
|
||||||
* Публичное или приватное домогательство
|
|
||||||
* Публикация личной информации других лиц, например, физического или электронного адреса, без явного разрешения
|
|
||||||
* Иное поведение, которое обоснованно считать неуместным в профессиональной обстановке
|
|
||||||
|
|
||||||
## Обязанности
|
Project maintainers are responsible for clarifying the standards of acceptable
|
||||||
|
behavior and are expected to take appropriate and fair corrective action in
|
||||||
|
response to any instances of unacceptable behavior.
|
||||||
|
|
||||||
Лидеры сообщества отвечают за разъяснение и применение наших стандартов приемлемого
|
Project maintainers have the right and responsibility to remove, edit, or
|
||||||
поведения и будут предпринимать соответствующие и честные меры по исправлению положения
|
reject comments, commits, code, wiki edits, issues, and other contributions
|
||||||
в ответ на любое поведение, которое они сочтут неприемлемым, угрожающим, оскорбительным или вредным.
|
that are not aligned to this Code of Conduct, or to ban temporarily or
|
||||||
|
permanently any contributor for other behaviors that they deem inappropriate,
|
||||||
|
threatening, offensive, or harmful.
|
||||||
|
|
||||||
Лидеры сообщества обладают правом и обязанностью удалять, редактировать или отклонять
|
## Scope
|
||||||
комментарии, коммиты, код, изменения в вики, вопросы и другой вклад, который не совпадает
|
|
||||||
с Кодексом Поведения, и предоставят причины принятого решения, когда сочтут нужным.
|
|
||||||
|
|
||||||
## Область применения
|
This Code of Conduct applies both within project spaces and in public spaces
|
||||||
|
when an individual is representing the project or its community. Examples of
|
||||||
|
representing a project or community include using an official project e-mail
|
||||||
|
address, posting via an official social media account, or acting as an appointed
|
||||||
|
representative at an online or offline event. Representation of a project may be
|
||||||
|
further defined and clarified by project maintainers.
|
||||||
|
|
||||||
Данный Кодекс Поведения применим во всех публичных физических и цифровых пространства сообщества,
|
## Enforcement
|
||||||
а также когда человек официально представляет сообщество в публичных местах.
|
|
||||||
Примеры представления проекта или сообщества включают использование официальной электронной почты,
|
|
||||||
публикации в официальном аккаунте в социальных сетях,
|
|
||||||
или упоминания как представителя в онлайн или офлайн мероприятии.
|
|
||||||
|
|
||||||
## Приведение в исполнение
|
Instances of abusive, harassing, or otherwise unacceptable behavior may be
|
||||||
|
reported by contacting the project team at [INSERT EMAIL ADDRESS]. All
|
||||||
|
complaints will be reviewed and investigated and will result in a response that
|
||||||
|
is deemed necessary and appropriate to the circumstances. The project team is
|
||||||
|
obligated to maintain confidentiality with regard to the reporter of an incident.
|
||||||
|
Further details of specific enforcement policies may be posted separately.
|
||||||
|
|
||||||
О случаях домогательства, а так же оскорбительного или иного другого неприемлемого
|
Project maintainers who do not follow or enforce the Code of Conduct in good
|
||||||
поведения можно сообщить ответственным лидерам сообщества с помощью email.
|
faith may face temporary or permanent repercussions as determined by other
|
||||||
Все жалобы будут рассмотрены и расследованы оперативно и беспристрастно.
|
members of the project's leadership.
|
||||||
|
|
||||||
Все лидеры сообщества обязаны уважать неприкосновенность частной жизни и личную
|
## Attribution
|
||||||
неприкосновенность автора сообщения.
|
|
||||||
|
|
||||||
## Атрибуция
|
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
|
||||||
|
available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
|
||||||
Данный Кодекс Поведения основан на [Кодекс Поведения участника][homepage],
|
|
||||||
версии 2.0, доступной по адресу
|
|
||||||
https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
|
|
||||||
|
|
||||||
Принципы Воздействия в Сообществе были вдохновлены [Mozilla's code of conduct
|
|
||||||
enforcement ladder](https://github.com/mozilla/diversity).
|
|
||||||
|
|
||||||
[homepage]: https://www.contributor-covenant.org
|
[homepage]: https://www.contributor-covenant.org
|
||||||
|
|||||||
63
translations/ru-russian/CONTIRBUTING.md
vendored
Normal file
63
translations/ru-russian/CONTIRBUTING.md
vendored
Normal file
@ -0,0 +1,63 @@
|
|||||||
|
Приветствуются все виды изменений. Не стесняйтесь предлагать броские и смешные названия для существующих примеров. Цель - сделать эту коллекцию как можно более интересной для чтения. Вот несколько способов, с помощью которых вы можете внести свой вклад,
|
||||||
|
|
||||||
|
- Если вы заинтересованы в переводе проекта на другой язык (некоторые люди уже делали это в прошлом), пожалуйста, не стесняйтесь открыть тему и дайте мне знать, если вам нужна какая-либо помощь.
|
||||||
|
- Если изменения, которые вы предлагаете, значительны, то создание issue перед внесением изменений будет оценено по достоинству. Если вы хотите поработать над issue (это очень рекомендуется), выразите свою заинтересованность и вы будете назначены исполнителем.
|
||||||
|
- Если вы добавляете новый пример, настоятельно рекомендуется создать issue, чтобы обсудить ее перед отправкой изменений. Для добавления нового примера вы можете использовать следующий шаблон:
|
||||||
|
|
||||||
|
<pre>
|
||||||
|
### ▶ Какое-то причудливое название. *
|
||||||
|
* в конце названия означает, что пример был добавлен недавно.
|
||||||
|
|
||||||
|
```py
|
||||||
|
# Подготовка кода.
|
||||||
|
# Подготовка к волшебству...
|
||||||
|
```
|
||||||
|
|
||||||
|
**Вывод (версия Python):**
|
||||||
|
```py
|
||||||
|
>>> triggering_statement
|
||||||
|
Вероятно, неожиданный вывод
|
||||||
|
|
||||||
|
```
|
||||||
|
(Необязательно): Одна строка, описывающая неожиданный вывод.
|
||||||
|
|
||||||
|
#### 💡 Объяснение:
|
||||||
|
* Краткое объяснение того, что происходит и почему это происходит.
|
||||||
|
```py
|
||||||
|
Подготовка примеров для пояснения (при необходимости)
|
||||||
|
```
|
||||||
|
|
||||||
|
**Вывод:**
|
||||||
|
```py
|
||||||
|
>>> trigger # пример, облегчающий понимание магии
|
||||||
|
# обоснованный вывод
|
||||||
|
```
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
Несколько моментов, которые стоит учитывать при написании примера,
|
||||||
|
|
||||||
|
- Если вы решили отправить новый пример без создания issue и обсуждения, пожалуйста, проверьте проект, чтобы убедиться, что в нем уже нет похожих примеров.
|
||||||
|
- Старайтесь быть последовательными в именах и значениях, которые вы используете для переменных. Например, большинство имен переменных в проекте имеют вид `some_string`, `some_list`, `some_dict` и т.д. Вы увидите много `x` для однобуквенных имен переменных, и `"wtf"` в качестве значений для строк. В проекте нет строгой схемы, как таковой, но вы можете взглянуть на другие примеры, чтобы понять суть.
|
||||||
|
- Старайтесь быть как можно более креативными, чтобы добавить элемент "сюрприза" во время подготовки примеров. Иногда это может означать написание фрагмента, который здравомыслящий программист никогда бы не написал.
|
||||||
|
- Также не стесняйтесь добавлять свое имя в список [контрибьюторов](/CONTRIBUTORS.md).
|
||||||
|
|
||||||
|
**Некоторые часто задаваемые вопросы**
|
||||||
|
|
||||||
|
Что это такое после каждого заголовка сниппета (###) в README: <!-- ID примера: 30f1d3fc-e267-4b30-84ef-4d9e7091ac1a --->? Нужно ли его добавлять вручную или можно игнорировать при создании новых сниппетов?
|
||||||
|
|
||||||
|
Это случайный UUID, он используется для идентификации примеров в нескольких переводах проекта. Как контрибьютор, вы не должны беспокоиться о том, как он используется, вы просто должны добавлять новый случайный UUID к новым примерам в этом формате.
|
||||||
|
|
||||||
|
Куда следует добавлять новые сниппеты? В начало/в конец раздела?
|
||||||
|
|
||||||
|
При определении порядка учитывается множество факторов (зависимость от других примеров, уровень сложности, категория и т.д.). Я бы предложил просто добавить новый пример в конец раздела, который вы считаете более подходящим (или просто добавить его в раздел "Разное"). О его порядке можно будет позаботиться в будущих редакциях.
|
||||||
|
|
||||||
|
В чем разница между разделами (первые два очень похожи)?
|
||||||
|
|
||||||
|
Раздел "Напрягите мозг" содержит более надуманные примеры, с которыми вы не столкнетесь в реальной жизни, в то время как раздел "Скользкие склоны" содержит примеры, с которыми можно чаще сталкиваться при программировании.
|
||||||
|
|
||||||
|
Перед оглавлением написано, что для его создания использовался markdown-toc -i README.md --maxdepth 3. Пакет pip markdown-toc не содержит ни флагов -i, ни --maxdepth. Какой пакет имеется в виду, или какая версия этого пакета?
|
||||||
|
Должна ли новая запись в оглавлении для фрагмента быть создана с помощью вышеуказанной команды или вручную (в случае, если вышеуказанная команда делает больше, чем просто добавляет запись)?
|
||||||
|
|
||||||
|
Мы используем пакет [markdown-toc](https://www.npmjs.com/package/markdown-toc) npm для создания ToC (содержание). Однако у него есть некоторые проблемы со специальными символами (не уверен, что они уже исправлены). Чаще всего я просто вставляю ссылку toc вручную в нужное место. Инструмент удобен, когда мне нужно сделать большую перестановку, в остальных случаях просто обновлять toc вручную удобнее.
|
||||||
|
|
||||||
|
Если у вас есть вопросы, не стесняйтесь спрашивать в [issue](https://github.com/satwikkansal/wtfpython/issues/269) (спасибо [@LiquidFun](https://github.com/LiquidFun) за ее создание).
|
||||||
42
translations/ru-russian/CONTRIBUTORS.md
vendored
Normal file
42
translations/ru-russian/CONTRIBUTORS.md
vendored
Normal file
@ -0,0 +1,42 @@
|
|||||||
|
Ниже перечислены (без определенного порядка) замечательные люди, которые внесли вклад в развитие wtfpython.
|
||||||
|
|
||||||
|
| Автор | Github | Issues |
|
||||||
|
|-------------|--------|--------|
|
||||||
|
| Lucas-C | [Lucas-C](https://github.com/Lucas-C) | [#36](https://github.com/satwikkansal/wtfpython/issues/36) |
|
||||||
|
| MittalAshok | [MittalAshok](https://github.com/MittalAshok) | [#23](https://github.com/satwikkansal/wtfpython/issues/23) |
|
||||||
|
| asottile | [asottile](https://github.com/asottile) | [#40](https://github.com/satwikkansal/wtfpython/issues/40) |
|
||||||
|
| MostAwesomeDude | [MostAwesomeDude](https://github.com/MostAwesomeDude) | [#1](https://github.com/satwikkansal/wtfpython/issues/1) |
|
||||||
|
| tukkek | [tukkek](https://github.com/tukkek) | [#11](https://github.com/satwikkansal/wtfpython/issues/11), [#26](https://github.com/satwikkansal/wtfpython/issues/26) |
|
||||||
|
| PiaFraus | [PiaFraus](https://github.com/PiaFraus) | [#9](https://github.com/satwikkansal/wtfpython/issues/9) |
|
||||||
|
| chris-rands | [chris-rands](https://github.com/chris-rands) | [#32](https://github.com/satwikkansal/wtfpython/issues/32) |
|
||||||
|
| sohaibfarooqi | [sohaibfarooqi](https://github.com/sohaibfarooqi) | [#63](https://github.com/satwikkansal/wtfpython/issues/63) |
|
||||||
|
| ipid | [ipid](https://github.com/ipid) | [#145](https://github.com/satwikkansal/wtfpython/issues/145) |
|
||||||
|
| roshnet | [roshnet](https://github.com/roshnet) | [#140](https://github.com/satwikkansal/wtfpython/issues/140) |
|
||||||
|
| daidai21 | [daidai21](https://github.com/daidai21) | [#137](https://github.com/satwikkansal/wtfpython/issues/137) |
|
||||||
|
| scidam | [scidam](https://github.com/scidam) | [#136](https://github.com/satwikkansal/wtfpython/issues/136) |
|
||||||
|
| pmjpawelec | [pmjpawelec](https://github.com/pmjpawelec) | [#121](https://github.com/satwikkansal/wtfpython/issues/121) |
|
||||||
|
| leisurelicht | [leisurelicht](https://github.com/leisurelicht) | [#112](https://github.com/satwikkansal/wtfpython/issues/112) |
|
||||||
|
| mishaturnbull | [mishaturnbull](https://github.com/mishaturnbull) | [#108](https://github.com/satwikkansal/wtfpython/issues/108) |
|
||||||
|
| MuseBoy | [MuseBoy](https://github.com/MuseBoy) | [#101](https://github.com/satwikkansal/wtfpython/issues/101) |
|
||||||
|
| Ghost account | N/A | [#96](https://github.com/satwikkansal/wtfpython/issues/96) |
|
||||||
|
| koddo | [koddo](https://github.com/koddo) | [#80](https://github.com/satwikkansal/wtfpython/issues/80), [#73](https://github.com/satwikkansal/wtfpython/issues/73) |
|
||||||
|
| jab | [jab](https://github.com/jab) | [#77](https://github.com/satwikkansal/wtfpython/issues/77) |
|
||||||
|
| Jongy | [Jongy](https://github.com/Jongy) | [#208](https://github.com/satwikkansal/wtfpython/issues/208), [#210](https://github.com/satwikkansal/wtfpython/issues/210), [#233](https://github.com/satwikkansal/wtfpython/issues/233) |
|
||||||
|
| Diptangsu Goswami | [diptangsu](https://github.com/diptangsu) | [#193](https://github.com/satwikkansal/wtfpython/issues/193) |
|
||||||
|
| Charles | [charles-l](https://github.com/charles-l) | [#245](https://github.com/satwikkansal/wtfpython/issues/245) |
|
||||||
|
| LiquidFun | [LiquidFun](https://github.com/LiquidFun) | [#267](https://github.com/satwikkansal/wtfpython/issues/267) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Переводчики**
|
||||||
|
|
||||||
|
| Переводчик | Github | Язык |
|
||||||
|
|-------------|--------|--------|
|
||||||
|
| leisurelicht | [leisurelicht](https://github.com/leisurelicht) | [Chinese](https://github.com/leisurelicht/wtfpython-cn) |
|
||||||
|
| vuduclyunitn | [vuduclyunitn](https://github.com/vuduclyunitn) | [Vietnamese](https://github.com/vuduclyunitn/wtfptyhon-vi) |
|
||||||
|
| José De Freitas | [JoseDeFreitas](https://github.com/JoseDeFreitas) | [Spanish](https://github.com/JoseDeFreitas/wtfpython-es) |
|
||||||
|
| Vadim Nifadev | [nifadyev](https://github.com/nifadyev) | [Russian](https://github.com/satwikkansal/wtfpython/tree/main/translations/README-ru.md) |
|
||||||
|
|
||||||
|
Спасибо всем за ваше время и за то, что делаете wtfpython еще более потрясающим! :smile:
|
||||||
|
|
||||||
|
PS: Этот список обновляется после каждого крупного релиза, если я забыл добавить сюда ваш вклад, пожалуйста, не стесняйтесь сделать Pull request.
|
||||||
70
translations/ru-russian/code-of-conduct.md
vendored
Normal file
70
translations/ru-russian/code-of-conduct.md
vendored
Normal file
@ -0,0 +1,70 @@
|
|||||||
|
# Кодекс Поведения участника
|
||||||
|
|
||||||
|
## Наши обязательства
|
||||||
|
|
||||||
|
Мы, как участники, авторы и лидеры обязуемся сделать участие в сообществе
|
||||||
|
свободным от притеснений для всех, независимо от возраста, телосложения,
|
||||||
|
видимых или невидимых ограничений способности, этнической принадлежности,
|
||||||
|
половых признаков, гендерной идентичности и выражения, уровня опыта,
|
||||||
|
образования, социально-экономического статуса, национальности, внешности,
|
||||||
|
расы, религии, или сексуальной идентичности и ориентации.
|
||||||
|
|
||||||
|
Мы обещаем действовать и взаимодействовать таким образом, чтобы вносить вклад в открытое,
|
||||||
|
дружелюбное, многообразное, инклюзивное и здоровое сообщество.
|
||||||
|
|
||||||
|
## Наши стандарты
|
||||||
|
|
||||||
|
Примеры поведения, создающие условия для благоприятных взаимоотношений включают в себя:
|
||||||
|
|
||||||
|
* Проявление доброты и эмпатии к другим участникам проекта
|
||||||
|
* Уважение к чужой точке зрения и опыту
|
||||||
|
* Конструктивная критика и принятие конструктивной критики
|
||||||
|
* Принятие ответственности, принесение извинений тем, кто пострадал от наших ошибок
|
||||||
|
и извлечение уроков из опыта
|
||||||
|
* Ориентирование на то, что лучше подходит для сообщества, а не только для нас лично
|
||||||
|
|
||||||
|
Примеры неприемлемого поведения участников включают в себя:
|
||||||
|
|
||||||
|
* Использование выражений или изображений сексуального характера и нежелательное сексуальное внимание или домогательство в любой форме
|
||||||
|
* Троллинг, оскорбительные или уничижительные комментарии, переход на личности или затрагивание политических убеждений
|
||||||
|
* Публичное или приватное домогательство
|
||||||
|
* Публикация личной информации других лиц, например, физического или электронного адреса, без явного разрешения
|
||||||
|
* Иное поведение, которое обоснованно считать неуместным в профессиональной обстановке
|
||||||
|
|
||||||
|
## Обязанности
|
||||||
|
|
||||||
|
Лидеры сообщества отвечают за разъяснение и применение наших стандартов приемлемого
|
||||||
|
поведения и будут предпринимать соответствующие и честные меры по исправлению положения
|
||||||
|
в ответ на любое поведение, которое они сочтут неприемлемым, угрожающим, оскорбительным или вредным.
|
||||||
|
|
||||||
|
Лидеры сообщества обладают правом и обязанностью удалять, редактировать или отклонять
|
||||||
|
комментарии, коммиты, код, изменения в вики, вопросы и другой вклад, который не совпадает
|
||||||
|
с Кодексом Поведения, и предоставят причины принятого решения, когда сочтут нужным.
|
||||||
|
|
||||||
|
## Область применения
|
||||||
|
|
||||||
|
Данный Кодекс Поведения применим во всех публичных физических и цифровых пространства сообщества,
|
||||||
|
а также когда человек официально представляет сообщество в публичных местах.
|
||||||
|
Примеры представления проекта или сообщества включают использование официальной электронной почты,
|
||||||
|
публикации в официальном аккаунте в социальных сетях,
|
||||||
|
или упоминания как представителя в онлайн или офлайн мероприятии.
|
||||||
|
|
||||||
|
## Приведение в исполнение
|
||||||
|
|
||||||
|
О случаях домогательства, а так же оскорбительного или иного другого неприемлемого
|
||||||
|
поведения можно сообщить ответственным лидерам сообщества с помощью email.
|
||||||
|
Все жалобы будут рассмотрены и расследованы оперативно и беспристрастно.
|
||||||
|
|
||||||
|
Все лидеры сообщества обязаны уважать неприкосновенность частной жизни и личную
|
||||||
|
неприкосновенность автора сообщения.
|
||||||
|
|
||||||
|
## Атрибуция
|
||||||
|
|
||||||
|
Данный Кодекс Поведения основан на [Кодекс Поведения участника][homepage],
|
||||||
|
версии 2.0, доступной по адресу
|
||||||
|
https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
|
||||||
|
|
||||||
|
Принципы Воздействия в Сообществе были вдохновлены [Mozilla's code of conduct
|
||||||
|
enforcement ladder](https://github.com/mozilla/diversity).
|
||||||
|
|
||||||
|
[homepage]: https://www.contributor-covenant.org
|
||||||
Loading…
Reference in New Issue
Block a user