diff --git a/translations/README/RUSSIAN.md b/translations/README/RUSSIAN.md new file mode 100644 index 000000000..ff1ca9d4d --- /dev/null +++ b/translations/README/RUSSIAN.md @@ -0,0 +1,273 @@ +# [Contribute To This Project](https://syknapse.github.io/Contribute-To-This-Project/) + +![image info](/favicon.png) + +[![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Contribute%20To%20This%20Project.%20An%20easy%20project%20for%20first-time%20contributors,%20with%20a%20full%20tutorial.%20By%20@Syknapse&url=https://github.com/Syknapse/Contribute-To-This-Project&hashtags=100DaysofCode 'Tweet this project') + +[![Discord](https://badgen.net/discord/online-members/tWkvS4ueVF?label=Join%20Our%20Discord%20Server&icon=discord)](https://discord.gg/tWkvS4ueVF 'Join our Discord server!') + +![GitHub forks](https://img.shields.io/github/forks/Syknapse/Contribute-To-This-Project.svg?style=social&label=Fork&maxAge=2592000) +![GitHub stars](https://img.shields.io/github/stars/Syknapse/Contribute-To-This-Project.svg?style=social&label=Star&maxAge=2592000) +![GitHub watchers](https://img.shields.io/github/watchers/Syknapse/Contribute-To-This-Project.svg?style=social&label=Watch&maxAge=2592000) + +> ## **Объявление:** +> +> Хотели бы вы стать сопровождающим этого проекта и помогать поддерживать его в рабочем состоянии? Если вам интересно, прочтите [руководство по сопровождению](maintainer_guide.md ) и пришлите мне сообщение в [Твиттере](https://twitter.com/Syknapse). + +## Введение + +Это руководство, которое поможет начинающим участникам принять участие в простом и понятном проекте. + +### Цели + +- Внесите свой вклад в проект с открытым исходным кодом. +- Станьте более продвинутыми в использовании GitHub. + +### Для кого это? + +- Это для абсолютных новичков. Если вы знаете, как написать и отредактировать тег привязки ``, то вы сможете это сделать. +- Это также для тех, у кого немного больше опыта, но кто хочет внести свой первый вклад с открытым исходным кодом или получить больше вкладов для получения большего опыта и уверенности. + +### Зачем мне это делать? + +Любой веб-разработчик, начинающий или опытный, должен уметь контролировать версии Git, GitHub - самый популярный сервис, которым пользуются все. Это также сердце сообщества с открытым исходным кодом. Освоение GitHub - это важный навык. Внесение вклада в проект повышает вашу уверенность в себе и дает вам возможность показать что-то в своем профиле на GitHub.
+Если вы новый разработчик и вам интересно, нужно ли вам изучать Git и GitHub, то вот ответ: [Вы должны были изучить Git вчера](https://codeburst.io/number-one-piece-of-advice-for-new-developers-ddd08abc8bfa 'Новый разработчик? Тебе следовало бы выучить Git вчера. автор: Брэндон Морелли, создатель CodeBurst.io '). + +## Какой вклад я собираюсь внести? + +![Карточка участника](/readme-only/card.PNG 'Карточка участника') + +Вы собираетесь разместить на этой [веб-странице проекта](https://syknapse.github.io/Contribute-To-This-Project/ 'https://syknapse.github.io/Contribute-To-This-Project') карточку, подобную этой. Она будет включать ваше имя, ваш Twitter, краткое описание и 3 ссылки на полезные ресурсы для веб-разработчиков, которые вы рекомендуете. + +Вы сделаете копию шаблона открытки внутри HTML-файла и настроите ее с помощью собственной информации. + +## Оглавление + +| | Внести вклад: | +|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| + + +## Настройка + +Сначала давайте настроим всё для выполнения работы + +1. Войдите в свою учетную запись GitHub. Если у вас еще нет учетной записи, то [присоединитесь к GitHub](https://github.com/join). Перед тем как продолжить, я рекомендую вам выполнить [учебник GitHub Hello World](https://guides.github.com/activities/hello-world/). +2. Скачайте [приложение GitHub Desktop](https://desktop.github.com/). + - Если вы используете [VS Code](https://code.visualstudio.com/ 'Сайт Visual Studio Code'), он поставляется с интегрированным Git'ом и позволяет делать то, что нам нужно, прямо из редактора. + - Однако самый простой и легкий способ следовать этому руководству - использовать GitHub Desktop. + +## Теперь, когда вы все настроили, давайте приступим к работе по внесению вклада в проект.

+ +## [↑ Вернуться наверх ↑](#оглавление) + +## Внесение вклада + +Станьте участником проекта с открытым исходным кодом за 10 простых шагов. + +_Примерное время: Менее 30 минут_. + +### Шаг 1: Форкните этот репозиторий + +- Цель состоит в том, чтобы сделать копию этого проекта и поместить ее в свой аккаунт. +- Репозиторий - это то, как проект называется на GitHub, а форк - это его копия. +- Убедитесь, что вы находитесь на [главной странице](https://github.com/Syknapse/Contribute-To-This-Project 'https://github.com/Syknapse/Contribute-To-This-Project') этого репозитория. + +| | ![Fork](/readme-only/fork.png "кликните на 'Fork'") | +|:--------------------------------------------|----------------------------------------------------:| + + +- Теперь у вас есть полная копия на проекта на вашем аккаунте + [↑ Вернуться наверх ↑](#оглавление) + +--- + +### Шаг 2: Клонируйте репозиторий + +- Теперь мы хотим создать локальную копию проекта. То есть копию, сохраненную на вашей собственной машине. +- Откройте приложение GitHub для рабочего стола. В этом приложении: + +| | ![Clone](/readme-only/clone.PNG 'нажмите clone repository') | +|:-----------------------------------------------------------------|------------------------------------------------------------:| + + +| | ![Clone project](/readme-only/clone-project.PNG 'click on /Contribute-To-This-Project') | +|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------:| +| | ![Ваш форк](/readme-only/clone-your-fork.PNG 'your fork will look like this, with your own user name') | + +- Это займет некоторое время, пока проект будет копироваться на ваш жесткий диск. Я рекомендую сохранить путь по умолчанию, который обычно `..\Documents\GitHub`. +- Теперь у вас есть локальная копия проекта. + +--- + +### Шаг 3: Создайте новую ветку + +- После клонирования репозитория и открытия его на рабочем столе GitHub пришло время создать новую ветвь. +- Ответвление - это способ сохранить ваши изменения отдельно от основной части проекта под названием `Master`. Например, если что-то пойдет не так и вы будете недовольны своими изменениями, вы можете просто удалить ветку, и основной проект не пострадает. + +| | ![Создать ветку](/readme-only/branch-new.PNG "Click on 'Branch', then 'New'") | +|:-------------------------------------------------------------------------------|------------------------------------------------------------------------------:| + + +| | ![Name branch](/readme-only/branch-name.PNG 'Name your branch') | +|:------------------------------------------------------------------------|----------------------------------------------------------------:| + + +- Вы можете назвать его как угодно, но поскольку это ответвление для добавления в проект карточки с вашим именем, называть его `your-name-card` будет хорошей практикой, так как это сохраняет ясность намерений этого ответвления. + +| | ![Name branch](/readme-only/branch-publish.PNG 'Click publish to send the new branch to your remote repo on GitHub') | +|:-------------------------------------------------|---------------------------------------------------------------------------------------------------------------------:| + + +- Теперь вы создали новую ветвь, отдельную от основной. +- Для следующих шагов убедитесь, что вы работаете в этой ветке. Вы увидите название ветки, в которой вы находитесь, в верхней центральной части приложения GitHub для рабочего стола, где написано _Current branch_. + +- **НЕ РАБОТАЙТЕ НА ВЕТКЕ 'master'** + +--- + +### Шаг 4: Откройте index.html + +- Теперь нам нужно открыть файл, который мы собираемся редактировать, с помощью вашего любимого редактора кода. +- Найдите папку проекта на вашем компьютере. Если вы сохранили папку по умолчанию, она должна быть примерно такой: `Ваш компьютер > Документы > GitHub > Contribute-To-This-Project`. +- Файл `index.html` находится непосредственно в папке `Contribute-To-This-Project`. + +| | ![Open index file](/readme-only/index-open.PNG "'Open index.html in your text editor'") | +|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -----------------------------------------------------------------------------------: | + + +- Теперь файл, который вы собираетесь редактировать, открыт в вашем редакторе, и вы готовы начать вносить в него изменения. + +--- + +### Шаг 5: Скопируйте шаблон карточки + +- Мы сделаем копию шаблона открытки, чтобы начать работу над ней + +| | +|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| ![Copy card template](/readme-only/card-copy.PNG 'Copy the card template') | + +| | +|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| ![Paste card template](/readme-only/card-paste.PNG 'Paste below the indicated line') | + +- Теперь это **ваша** карточка, которую вы можете настраивать и редактировать. +--- + +### Шаг 6: Примените ваши изменения + +- Теперь мы начнем редактировать html, изменяя настраиваемые поля в нашей карточке. + +| | ![Change name](/readme-only/change-name.PNG 'Type your name') | +|:-------------------------------------------------------------------------------------------|--------------------------------------------------------------:| + + +| | +|:-----------------------------------------------------------------------------------------------------------------------------------| +| ![Change contact](/readme-only/change-contact.PNG 'Insert a link to your Twitter account and type your handle') | + +- Если вы предпочитаете использовать контакты, отличные от Twitter, вам нужно заменить значок twitter `` на [Font Awesome Icons](http://fontawesome.io/icons/), найдя нужный значок и заменив только часть `fa-twitter` на новый значок, например, `fa-facebook`. Затем выполните те же шаги, что описаны выше. + +| | ![Change about](/readme-only/change-about.PNG 'Write a sentence about you') | +| :------------------------------------------------------------------------------------------------------------------------------- |----------------------------------------------------------------------------:| + + +| | +|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| ![Change resources](/readme-only/change-resources.PNG 'Insert link, write a short description, and type the name of the resource') | +| | + +- Убедитесь, что вы **сохранили все изменения**. +- **Протестируйте свои изменения**. ЭТО ОЧЕНЬ ВАЖНО! Откройте html-файл в браузере (например, дважды щелкнув по нему) и посмотрите, как будет выглядеть ваша карточка на сайте. Убедитесь, что вся страница выглядит одинаково и ничего не нарушено. Нажмите на свои ссылки и убедитесь, что они работают. Откройте консоль (Ctrl + Shift + J (Windows / Linux) или Cmd + Opt + J (Mac)) и проверьте, нет ли сообщений об ошибках. +- Отлично, вы закончили редактирование кода! Следующие шаги отправят ваши изменения на GitHub, а затем отправят их для слияния с основным проектом. +--- + +### Шаг 7: Закоммитьте свои изменения + +- Вернитесь к настольному приложению GitHub. +- Ваши изменения будут автоматически добавлены в область хранения. +- Это означает, что Git записал все **сохраненные** изменения. +- Вы можете увидеть это в приложении. Все, что вы добавили в файл, будет выделено зеленым цветом, а удаление - красным. + +| | ![Commit changes](/readme-only/commit.PNG "The changes you've added should appear in green on the right side of GitHub desktop app. The commit button is on the bottom left") | +|:---------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| + + +| | +|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| ![Commit changes](/readme-only/commit-header.PNG "The changes you've added should appear in green on the right side of GitHub desktop app. The commit button is on the bottom left") | + +| | ![Write commit message and commit](/readme-only/commit-message.PNG "Write a brief commit message in the 'summary' input, and click 'commit'") | +|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------:| + + +--- + +### Шаг 8: Отправьте свои изменения на GitHub + +- Теперь ваши изменения сохранены или зафиксированы. Но они сохранены только локально, то есть на вашем компьютере. +- Синхронизация локальных изменений с вашим репозиторием на GitHub называется _Push_. Вы "проталкиваете" изменения из вашего локального репозитория в удаленный репозиторий на GitHub. + +| | ![Push to GitHub](/readme-only/push.PNG "Push your changes to GitHub, click on the 'Push' button") | +|:-------------------------------------------|---------------------------------------------------------------------------------------------------:| + + +- Через несколько секунд операция будет завершена, и теперь у вас есть точно такая же копия этой ветки как на вашей машине, так и на GitHub. + +--- + +### Шаг 9: Отправьте PR (Pull Request) + +- Настал момент, которого вы так долго ждали: подача _пулл реквеста_ (PR). +- До сих пор вся проделанная вами работа была связана с форком проекта, который, как вы помните, находится на вашем собственном аккаунте на GitHub. +- Теперь пришло время отправить свои изменения в основной проект для слияния с ним. +- Это называется [_Pull Request_](https://help.github.com/articles/about-pull-requests/ 'About Pull Requests - GitHub Help'), потому что вы просите сопровождающего оригинального проекта "перетянуть" ваши изменения в свой проект. +- Перейдите на главную страницу **вашего форка** на GitHub (вверху будет значок форка и ваше имя пользователя). +- В верхней части репозитория вы увидите выделенное сообщение Pull Request с зеленой кнопкой. + +| | ![Submit a Pull Request](/readme-only/pull-request.PNG 'This is usually towards the top of the page, under the description and above the project files and folders') | +|:--------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------:| + + +| | +|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| ![Open a Pull Request](/readme-only/pull-request-branches.PNG 'You are requesting to merge your branch from your fork into the master branch of the original project') | + +| | ![Submit a Pull Request](/readme-only/pull-request-open.PNG "Click the green button. Don't be scared!") | +|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------:| + + +- Не пугайтесь множества вариантов. Вам нужно выполнить только эти три шага. +- Оставьте опцию `Allow edits from maintainers` отмеченной. +- Теперь мейнтейнеру проекта будет отправлен запрос _Pull Request_. Как только он будет рассмотрен и принят, ваши изменения появятся на [веб-странице проекта](https://syknapse.github.io/Contribute-To-This-Project 'Contribute To This Project web page'). + +--- + +### Шаг 10: Отпразднуйте + +Вот и все. Вы сделали это! Теперь вы внесли свой вклад в открытый исходный код на GitHub. + +Вы добавили код на живую веб-страницу: [https://syknapse.github.io/Contribute-To-This-Project](https://syknapse.github.io/Contribute-To-This-Project) + +Ваши изменения **не будут видны сразу**; сначала они должны быть рассмотрены, приняты и объединены сопровождающим проекта. Как только они будут объединены, ваша карточка должна стать видимой и живой на странице. + +Это вполне нормально, когда рецензент просит внести изменения в PR. Считайте это хорошей практикой, если это произойдет с вами. Следите за комментариями и запрошенными изменениями. Как только вы внесете запрашиваемые изменения (в свою ветку), все, что вам нужно сделать, это зафиксировать и отправить изменения. PR будет автоматически обновлен новыми изменениями. + +Я обещаю, что постараюсь рассмотреть и объединить как можно скорее, но я делаю это в свободное время, поэтому задержка в несколько дней неизбежна. + +--- + +--- + +## Следующие шаги + +- Вернитесь через некоторое время, чтобы проверить, как прошел ваш объединенный Pull Request. +- Вы должны получить письмо от GitHub, когда ваши изменения будут одобрены, или если будут запрошены дополнительные изменения. И когда PR будет окончательно объединен с мастером и ваша карточка будет добавлена. +- Если вы нашли этот проект **полезным**, пожалуйста, поставьте ему :star: звезду :star: вверху страницы и **Tweet** о нем, чтобы помочь распространить информацию [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Contribute%20To%20This%20Project.%20An%20easy%20project%20for%20first-time%20contributors,%20with%20a%20full%20tutorial.%20By%20@Syknapse&url=https://github.com/Syknapse/Contribute-To-This-Project&hashtags=100DaysofCode 'Tweet this project'). +- Вы можете **следовать за мной** и связаться со мной в [Твиттере](https://twitter.com/Syknapse '@Syknapse') или [используя любой из этих других вариантов](https://syknapse.github.io/Syk-Houdeib/#contact 'Мой раздел контактов | Портфолио'). +- Это проект с открытым исходным кодом, поэтому, помимо вклада в свою карту, вы можете помочь исправить ошибки, внести улучшения или новые функции. Откройте [проблему](https://help.github.com/articles/creating-an-issue/ 'Mastering Issues | GitHub Guides') или отправьте новый [pull request](https://help.github.com/articles/creating-a-pull-request-from-a-fork/ 'Creating a pull request from a fork | GitHub Help'). +- Чтобы помочь улучшить наше сообщество, загляните на вкладку GitHub [Discussions](https://github.com/Syknapse/Contribute-To-This-Project/discussions), расположенную рядом с Pull Requests. Это место, где можно представиться, углубиться в обсуждение Open Source и пообщаться с мейнтейнерами проекта. Поможете ли вы нам создать эту функцию и улучшить наше сообщество? +- **Спасибо за вклад в этот проект**. Теперь вы можете попробовать внести свой вклад в другие проекты; обратите внимание на метку ![Good First Issue](https://user-images.githubusercontent.com/29199184/33852733-e23b7070-debb-11e7-907b-4e7a03aad436.png), чтобы найти варианты вклада, удобные для новичков. +- Я также ищу соавторов, которые могли бы помочь мне в рецензировании и объединении PR. Если вы хотите получить более продвинутую практику работы с Git, пожалуйста, напишите мне DM в Twitter и прочитайте [руководство сопровождающего](maintainer_guide.md). + +[Вернуться наверх;](#введение) \ No newline at end of file