refactor: changed the translation a little bit

This commit is contained in:
Stanislav Gavrilov
2024-01-27 14:12:22 +03:00
parent 8374234377
commit a1bf3fa141
7 changed files with 87 additions and 87 deletions

View File

@@ -1,21 +1,21 @@
---
title: Изучай чужие решения
title: Изучайте чужие решения
description: Руководство по просмотру чужого ответа.
sidebar:
order: 3
---
Все ответы на испытания Angular представлены в виде Pull Request (PR). Чтобы их просмотреть и изучить, перейди на страницу **Files Changes** на GitHub. Однако, если ты не знаком с интерфейсом, процесс может быть не очевидным. Иногда просмотреть решение в твоей любимой IDE может быть удобнее.
Все ответы на испытания Angular представлены в виде Pull Request (PR). Чтобы их просмотреть и изучить, нужно перейти на страницу **Files Changes** на GitHub. Однако, если вы не знакомы с интерфейсом, процесс может быть не очевидным. Иногда посмотреть на решение в вашей любимой IDE может быть удобнее.
Это руководство поможет тебе с этим.
Это руководство поможет вам с этим.
## Проверьте чужой PR локально
### Синхронизируй свой репозиторий
### Синхронизируйте свой репозиторий
В начале тебе нужно синхронизировать твою копию репозитория, чтобы убедиться, что она находится в актуальном состоянии.
В начале вам нужно синхронизировать вашу копию репозитория, чтобы убедиться, что она находится в актуальном состоянии.
Это можно сделать, нажав кнопку **Sync fork** на главной странице репозитория.
Это можно сделать, нажав на кнопку **Sync fork** на главной странице репозитория.
![Sync project header](../../../../assets/fork-sync.png)
@@ -23,26 +23,26 @@ sidebar:
![Sync project update modal](../../../../assets/sync-fork-update.png)
### Перейди на PR
### Перейдите к PR
Перейди к PR, который ты хочешь изучить локально, и узнай его ID. Ты найдешь его в заголовке PR (как показано ниже).
Перейдите к PR, который вы хотите изучить локально, и узнайте его ID. Вы найдете его в заголовке PR (как показано ниже).
![PR header](../../../../assets/PR-header.png)
Далее открой терминал в каталоге проекта и выполни следующую команду:
Далее откройте терминал в каталоге проекта и выполните следующую команду:
```bash
gh pr checkout <ID>
```
Если ты не помнишь команду, нажми на кнопку "Code" в правой части заголовка, и ты сможешь легко скопировать/вставить команду.
Если вы не помните команду, нажмите на кнопку "Code" в правой части заголовка, и вы сможете легко скопировать/вставить команду.
![PR code modal](../../../../assets/PR-code-btn-modal.png)
:::note[Примечание]
Если команда не сработала или не выполнилась, Github CLI подскажет что делать.
Если команда не сработала, Github CLI подскажет что делать.
:::
🔥Теперь ты можешь изучать решение локально и запускать его для тестирования.🔥
🔥Теперь вы можете изучить решение локально и запустить его для тестирования.🔥
<!-- gh repo set-default -->

View File

@@ -1,20 +1,20 @@
---
title: Вноси свой вклад
title: Вносите свой вклад
description: Описание как помочь проекту
sidebar:
order: 4
---
Ты можешь помочь проекту многими способами:
Вы можете помочь проекту многими способами:
🔥 Создавай новые испытания, следуя инструкциям [тут](/guides/create-challenge).
🔥 Создавайте новые испытания, следуя инструкциям [тут](/guides/create-challenge).
🔥 Проходи испытания и отправляй свои решения. (руководство [тут](/guides/resolve-challenge)).
🔥 Проходите испытания и отправляйте свои решения на ревью. (руководство [тут](/guides/resolve-challenge)).
🔥 Проводи ревью чужих решений, давая конструктивные и дружелюбные комментарии.
🔥 Проводите ревью чужих решений, оставляя конструктивные и дружелюбные комментарии.
🔥 Исправляй опечатки и ошибки в документации.
🔥 Исправляйте опечатки и ошибки в документации.
🔥 Оставляй заявки, чтобы предложить идеи новых испытаний или чтобы сообщить об ошибках.
🔥 Оставляйте issues, чтобы предложить идеи новых испытаний или чтобы сообщить об ошибках.
🔥 Поддерживай проект [тут](https://github.com/sponsors/tomalaforge).
🔥 Поддерживайте проект [тут](https://github.com/sponsors/tomalaforge).

View File

@@ -1,23 +1,23 @@
---
title: Создай свое испытание
title: Создайте свое испытание
description: Руководство по созданию испытания
sidebar:
order: 5
---
У тебя есть идея, которой ты хочешь поделиться, интересная ошибка, с которой ты борешься в одном из своих приватных или побочных проектов, или трюк Angular, который ты обнаружил. Все эти возможности - хорошая отправная точка, чтобы создать задачу и поделиться ее решением с другими.
У вас есть идея, которой вы хотите поделиться, интересная ошибка, с которой вы боретесь в одном из своих проектов, или что-то необычное в Angular, что вы обнаружили. Всё это - хорошая отправная точка, чтобы создать испытание и поделиться её решением с другими.
Но как начать создавать испытания?
## Шаблон создания испытания
Чтобы упростить этот процесс, я создал генератор Nx, который настроит все за тебя и поможет тебе быстрее начать. Проще всего его запустить в консоли Nx: перейди в раздел <b>Nx Console > generate > @angular-challenges/cli - challenge</b>
Чтобы упростить этот процесс, я создал генератор Nx, который настроит все за вас и поможет вам быстрее начать. Проще всего его запустить в консоли Nx: перейдите в раздел <b>Nx Console > generate > @angular-challenges/cli - challenge</b>
### Параметры
#### обязательные параметры
- <b>title</b>: Название, которое ты хочешь дать испытанию.
- <b>title</b>: Название, которое вы хотите дать испытанию.
:::note[Примечание]
Название должно быть не больше 25 символов.
:::
@@ -31,8 +31,8 @@ sidebar:
#### не обязательные параметры
- <b>directory</b>: Если ты хочешь, чтобы приложение находилось в определенной папке внутри `apps`.
- <b>addTest</b>: Если хочешь добавить конфигурацию теста.
- <b>directory</b>: Если вы не хотите, чтобы приложение находилось в стандартной папке внутри `apps`.
- <b>addTest</b>: Если хотите добавить конфигурацию теста.
### Что будет создано
@@ -44,11 +44,11 @@ sidebar:
Все что осталось - создать испытание. 🚀
:::danger[Опасно]
Не забудь обновить документацию, чтобы описать свою задачу и дать инструкции.
Не забудьте обновить документацию, чтобы описать свою задачу и дать инструкции.
:::
Дальше действовать будешь ты!!! 💪
Дальше действовать будете вы!!! 💪
## Отправка решения
Через неделю или около того не забудь представить свое решение задачи.
Через неделю или около того не забудьте представить своё решение задачи.

View File

@@ -8,10 +8,10 @@ sidebar:
<details>
<summary>Почему мое приложение не запускается, или почему я вижу ошибки в терминале при запуске `nx serve`?</summary>
Чаще всего эта проблема возникает из-за того, что фnode_modules устарели, и тебе нужно обновить их, выполнив команду `npm ci`.
Чаще всего эта проблема возникает из-за того, что node_modules устарели, и вам нужно обновить их, выполнив команду `npm ci`.
Если установка завершилась неудачно, ты можешь решить эту проблему, удалив папку node_modules с помощью команды `rm -rf node_modules` или `npx npkill` а затем снова выполнить `npm ci`.
Если установка завершилась неудачно, вы можете попробовать решить эту проблему, удалив папку node_modules с помощью команды `rm -rf node_modules` или `npx npkill` а затем снова выполнить `npm ci`.
Если проблема сохраняется, пожалуйста сообщи о ней [тут](https://github.com/tomalaforge/angular-challenges/issues/new).
Если проблема сохранится, пожалуйста сообщи о ней [тут](https://github.com/tomalaforge/angular-challenges/issues/new).
</details>

View File

@@ -5,22 +5,22 @@ sidebar:
order: 1
---
Чтобы начать работу с <b>испытаниями Angular</b>, выполни следующие шаги:
Чтобы начать работу с <b>испытаниями Angular</b>, выполните следующие шаги:
## Создай аккаунт на Github
## Создайте аккаунт на Github
Если ты захочешь отправить решение, тебе потребуется аккаунт на GitHub. Кроме того, иметь учетную запись на GitHub всегда полезно. Тем более это бесплатно.
Если вы захотите отправить свое решение для испытания, вам потребуется аккаунт на GitHub. Кроме того, иметь учетную запись на GitHub всегда полезно. Тем более это бесплатно.
## Скопируй github проект
## Скопируйте github проект
Перейди в [Angular Challenges Repository](https://github.com/tomalaforge/angular-challenges) и нажми на кнопку <span class="github-neutral-btn"> <svg aria-hidden="true" height="16" viewBox="0 0 16 16" version="1.1" width="16" data-view-component="true" class="octicon octicon-repo-forked mr-2">
<path d="M5 5.372v.878c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.878a2.25 2.25 0 1 1 1.5 0v.878a2.25 2.25 0 0 1-2.25 2.25h-1.5v2.128a2.251 2.251 0 1 1-1.5 0V8.5h-1.5A2.25 2.25 0 0 1 3.5 6.25v-.878a2.25 2.25 0 1 1 1.5 0ZM5 3.25a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Zm6.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5Zm-3 8.75a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Z"></path></svg>Fork</span> в вверху страницы. Это создаст копию этого репозитория на твоей GitHub странице.
Перейдите в [Angular Challenges Repository](https://github.com/tomalaforge/angular-challenges) и нажмите на кнопку <span class="github-neutral-btn"> <svg aria-hidden="true" height="16" viewBox="0 0 16 16" version="1.1" width="16" data-view-component="true" class="octicon octicon-repo-forked mr-2">
<path d="M5 5.372v.878c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.878a2.25 2.25 0 1 1 1.5 0v.878a2.25 2.25 0 0 1-2.25 2.25h-1.5v2.128a2.251 2.251 0 1 1-1.5 0V8.5h-1.5A2.25 2.25 0 0 1 3.5 6.25v-.878a2.25 2.25 0 1 1 1.5 0ZM5 3.25a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Zm6.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5Zm-3 8.75a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Z"></path></svg>Fork</span> в вверху страницы. Это создаст копию репозитория на вашей GitHub странице.
## Клонируй репозиторий на свой компьютер
## Клонируйте репозиторий на свой компьютер
Выбери папку на своем компьютере и клонируй репозиторий.
Выберите папку на своем компьютере и клонируйте репозиторий.
Открой терминал, перейди в выбранный каталог, и набери команду:
Откройте терминал, перейдите в выбранный каталог, и наберите команду:
```bash
git clone https://github.com/[YOUR_GITHUB_NAME]/angular-challenges.git
@@ -28,30 +28,30 @@ git clone https://github.com/[YOUR_GITHUB_NAME]/angular-challenges.git
:::note
Ты можешь найти URL адрес клонированного репозитория нажав на кнопку <span class="github-success-btn"><> Code</span> в <b>твоем собственном</b> экземпляре репозитория Angular Challenges.
Вы можете найти URL адрес клонированного репозитория нажав на кнопку <span class="github-success-btn"><> Code</span> в <b>вашем собственном</b> экземпляре репозитория Angular Challenges.
![Header of github workpspace](../../../../assets/header-github.png)
:::
## Открой проект в своей любимой среде разработки
## Откройте проект в вашей любимой среде разработки
Открой проект в любой IDE на твой выбор.
Откройте проект в любой IDE на ваш выбор.
## Установи все зависимости
## Установите все зависимости
```bash
npm ci
```
## Выбери задачу
## Выберите задачу
Твой проект сейчас поднят и запущен. Осталось только выбрать испытание 🚀
Ваш проект сейчас поднят и запущен. Осталось только выбрать испытание 🚀
Каждое испытание состоит из:
- <b>Имя</b>: описывает о чем испытание.
- <b>Номер</b>: номер создания. Этот номер не несет какого-то смысла, но служит для ссылки в секции Github Pull Request.
- <b>Номер</b>: порядковый номер создания. Этот номер не несет какого-то смысла, но служит для ссылки в секции Github Pull Request.
- <b>Бейдж</b>: показывает уровень сложности. Полностью субъективно 😅
- 🟢 простое
- 🟠 среднее

View File

@@ -1,13 +1,13 @@
---
title: Сделай rebase своей ветки
title: Сделайте rebase вашей ветки
description: Руководство по rebase ветки на последние изменения
sidebar:
order: 6
---
Иногда в проект могут вноситься изменения. Я стараюсь вносить изменения, которые ничего не сломают, но иногда это неизбежно.
Иногда в проект могут вноситься изменения. Я стараюсь вносить изменения, которые ничего не сломают, но иногда этого не избежать.
В большинстве случаев тебе не придется делать rebase твоего решения, но вот руководство, которое поможет тебе узнать, как это сделать.
В большинстве случаев вам не придется делать rebase вашего решения, но вот руководство, которое поможет вам понять, как это сделать.
:::note[Примечание]
Это руководство применимо к любому проекту с открытым исходным кодом.
@@ -15,11 +15,11 @@ sidebar:
## Шаги rebase
### Синхронизируй свой репозиторий
### Синхронизируйте ваш репозиторий
Во-первых, тебе нужно синхронизировать твою копию, чтобы убедиться, что она содержит последние изменения.
Во-первых, вам нужно синхронизировать вашу копию, чтобы убедиться, что она содержит последние изменения.
Ты можешь сделать это, нажав на кнопку Sync fork на главной странице твоего репозитория.
Вы можете сделать это, нажав на кнопку Sync fork на главной странице вашего репозитория.
![Sync project header](../../../../assets/fork-sync.png)
@@ -27,7 +27,7 @@ sidebar:
![Sync project update modal](../../../../assets/sync-fork-update.png)
### Открой терминал
### Откройте терминал
Откройте любой терминал, будь то терминал в любимой IDE или отдельное приложение.
@@ -39,17 +39,17 @@ sidebar:
- git pull
- git checkout [your branch]
- git rebase main
- Реши конфликты
- Разрешите конфликты
На этом этапе rebase может остановиться, потому что в твоей локальной ветке есть конфликтующие файлы с основной веткой. Исправь это. После того как закончишь:
На этом этапе rebase может остановиться, потому что в вашей локальной ветке есть конфликтующие файлы с основной веткой. Исправьте это. После того как закончите:
- git add .
- git rebase --continue
Если в твоей ветке нет конфликтов, будет показано сообщение об успехе.
Если в вашей ветке нет конфликтов, будет показано сообщение об успехе.
### Отправь свою работу в удаленный репозиторий
### Отправьте свою работу в удаленный репозиторий
Наконец, отправь свою работу на GitHub:
Наконец, отправьте свою работу на GitHub:
- git push -f

View File

@@ -1,28 +1,28 @@
---
title: Пройди испытание
title: Пройдите испытание
description: Инструкция по прохождению испытания
sidebar:
order: 2
---
В этом руководстве ты узнаешь, как пройти испытание и отправить решение в основной репозиторий Github.
В этом руководстве вы узнаете, как пройти испытание и отправить свое решение.
## Вступление
Этот репозиторий работает под управлением [Nx](https://nx.dev/getting-started/intro). <b>Nx</b> это монорепозиторий который позволяет тебе хранить несколько приложений в одном рабочем пространстве.
Каждое испытание - это отдельное приложение. Если ты откроешь каталог `apps`, то обнаружишь несколько директорий, каждая из которых относится к определенной задаче. Каждый каталог представляет собой полноценное приложение `Nx`. Чтобы запустить и начать работу с одним из них, открой терминал и выполни команду:
Этот репозиторий работает под управлением [Nx](https://nx.dev/getting-started/intro). <b>Nx</b> это монорепозиторий который позволяет вам хранить несколько приложений в одном рабочем пространстве.
Каждое испытание - это отдельное приложение. Если вы откроете каталог `apps`, то обнаружите несколько директорий, каждая из которых относится к определенной задаче. Каждый каталог представляет собой полноценное приложение `Nx`. Чтобы запустить и начать работу с одним из них, откройте терминал и выполните команду:
```bash
npx nx serve <ИМЯ_ПРИЛОЖЕНИЯ>
```
:::note[Примечание]
Если ты не уверен в названии испытания МЯ_ПРИЛОЖЕНИЯ`, открой файл README.md. Там написана команда `serve` со ссылкой на документацию по испытанию.
Если вы не уверены в названии испытания МЯ_ПРИЛОЖЕНИЯ`, откройте файл README.md. Там написана команда `serve` со ссылкой на документацию по испытанию.
:::
:::note[Примечание]
Если `nx` установлен глобально на твоем компьютере, ты можешь опустить `npx`.
Чтобы установить `nx` глобально, выполни
Если `nx` установлен глобально на вашем компьютере, вы можешь опустить команду `npx`.
Чтобы установить `nx` глобально, выполните
```bash
npm i -g nx
@@ -30,64 +30,64 @@ npm i -g nx
:::
## Создай Git Ветку
## Создайте Git Ветку
Прежде чем приступить к реализации решения испытания, создай ветку git для фиксации своей работы.
Прежде чем приступить к реализации вашего решения испытания, создайте ветку git для фиксации своей работы.
```bash
git checkout -b <BRANCH_NAME>
```
## Пройди испытание
## Пройдите испытание
Следуй инструкция чтобы пройти испытание.
Изучите инструкции чтобы пройти испытание.
## Сделай коммит и отправь код в репозиторий
## Сделайте коммит и отправьте код в репозиторий
Последний шаг это создание коммита, который следовал бы правилам из [Соглашения о коммитах](https://www.conventionalcommits.org/ru/v1.0.0/).
Наконец, отправь свою работу в удаленный репозиторий с помощью следующей команды:
Наконец, отправьте свою работу в удаленный репозиторий с помощью следующей команды:
```bash
git push --set-upstream origin <BRANCH_NAME>
```
:::tip[Не запоминай команду]
Тебе не нужно запоминать команду в точности. Нужно просто запомнить `git push`, и если ты впервые пушишь эту ветку, `git` подскажет тебе полную команду.
Вам не нужно запоминать команду в точности. Нужно просто запомнить `git push`, и если вы впервые загружаешь эту ветку в репозиторий, `git` подскажет вам полную команду.
:::
## Отправь свое решение в основной репозиторий
## Отправьте свое решение в основной репозиторий
Теперь вся твоя работа находится в твоем экземпляре репозитория Angular Challenges.
Теперь все ваше решение находится в вашем экземпляре репозитория Angular Challenges.
Следующий шаг - перейти на главную страницу [Angular Challenges](https://github.com/tomalaforge/angular-challenges) и создать новый запрос на слитие (Pull Request).
Следующий шаг - перейдите на главную страницу [Angular Challenges](https://github.com/tomalaforge/angular-challenges) и создайте новый запрос на слитие (Pull Request).
Github должен показать уведомление, чтобы помочь тебе создать pull request.
Github должен показать уведомление, чтобы помочь вам создать pull request.
Если этого не случилось, то ты либо неправильно выполнил один из предыдущих шагов, либо можешь перейти на вкладку Pull Request и нажать кнопку <span class="github-success-btn">New pull request.</span>
Если этого не случилось, то вы либо неправильно выполнили один из предыдущих шагов, либо вам нужно перейти на вкладку Pull Request и нажать кнопку <span class="github-success-btn">New pull request.</span>
После того как выберешь две ветки для сравнения, ты попадешь на следующую страницу:
После того как вы выберете две ветки для сравнения, вы попадете на следующую страницу:
![New pull request screen](../../../../assets/new-pull-request.png)
В заголовке напиши Answer:, затем номер твоего задания. После этого можешь добавить все, что пожелаешь.
В заголовке напишите Answer:, затем номер вашего испытания. После этого можете добавить все, что пожелаете.
:::danger[Опасно]
Это очень важно. Это позволит другим узнать, какое испытание ты пытаешься решить.
Порядковый номер очень важен. Он позволит другим узнать, какое испытание вы пытаетесь решить.
:::
В разделе описания ты можешь добавить вопросы, проблемы, с которыми столкнулся, или все остальное, чем захочешь поделиться. Если написать нечего, можешь оставить этот раздел пустым.
В разделе описания вы можете добавить вопросы, проблемы, с которыми столкнулись, или все остальное, чем захотите поделиться. Если нечего написать, можете оставить этот раздел пустым.
Теперь можешь нажать на <span class="github-success-btn">Create pull request</span>.
Теперь вы можете нажать на кнопку <span class="github-success-btn">Create pull request</span>.
Я прочитаю и прокомментирую <b>когда у меня будет свободное время.</b>
Я прочитаю и проведу ревью вашего решения <b>когда у меня будет свободное время.</b>
<p class="important-block">Не переживай если я не проревьювил твое решение сразу же. Я делаю это <b>бесплатно</b> в свое <b>свободное время</b>. Если ты хочешь меня поддержать, ты можешь это сделать с помощью <a href="https://github.com/sponsors/tomalaforge">поддержать на github</a>. Это покажет, что моя работа полезна для вас или вашей команды.</p>
<p class="important-block">Не переживайте если я не прокомментировал ваше решение сразу же. Я делаю это <b>бесплатно</b> в свое <b>свободное время</b>. Если вы хотите меня поддержать, вы можете это сделать с помощью <a href="https://github.com/sponsors/tomalaforge">поддержать на github</a>. Это покажет, что моя работа полезна для вас или вашей команды.</p>
:::note[Примечание]
Все желающие могут оставлять комментарии и читать другие PR.
:::
:::tip[OSS чемпион]
🔥 После того как ты пройдешь это руководство, ты готов внести свой вклад в любой другой публичный репозиторий Github и отправить PR. Это настолько просто.🔥
🔥 После того как вы пройдете это руководство, вы сможете внести свой вклад в любой другой публичный репозиторий на Github. Да, это настолько просто.🔥
:::