Skip to content

Commit 61c1c33

Browse files
tomalaforgetomalaforge
authored
Merge pull request #544 from stillst/feat-ru
feat(docs): add russian lang
2 parents 9e26960 + 71dbaea commit 61c1c33

File tree

10 files changed

+452
-0
lines changed

10 files changed

+452
-0
lines changed

Diff for: ‎docs/astro.config.mjs

+6
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,10 @@ export const locales = {
1818
label: 'Português',
1919
lang: 'pt',
2020
},
21+
ru: {
22+
label: 'Русский',
23+
lang: 'ru',
24+
},
2125
};
2226

2327
// https://astro.build/config
@@ -44,6 +48,7 @@ export default defineConfig({
4448
es: 'Guías',
4549
fr: 'Guides',
4650
pt: 'Guias',
51+
ru: 'Руководство',
4752
},
4853
},
4954
{
@@ -53,6 +58,7 @@ export default defineConfig({
5358
es: 'Desafíos',
5459
fr: 'Challenges',
5560
pt: 'Desafios',
61+
ru: 'Задачи',
5662
},
5763
},
5864
],

Diff for: ‎docs/src/content/docs/ru/guides/checkout-answer.md

+48
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
title: Изучайте чужие решения
3+
description: Руководство по просмотру чужого ответа.
4+
sidebar:
5+
order: 3
6+
---
7+
8+
Все ответы на испытания Angular представлены в виде Pull Request (PR). Чтобы их просмотреть и изучить, нужно перейти на страницу **Files Changes** на GitHub. Однако, если вы не знакомы с интерфейсом, процесс может быть не очевидным. Иногда посмотреть на решение в вашей любимой IDE может быть удобнее.
9+
10+
Это руководство поможет вам с этим.
11+
12+
## Проверьте чужой PR локально
13+
14+
### Синхронизируйте свой репозиторий
15+
16+
В начале вам нужно синхронизировать вашу копию репозитория, чтобы убедиться, что она находится в актуальном состоянии.
17+
18+
Это можно сделать, нажав на кнопку **Sync fork** на главной странице репозитория.
19+
20+
![Sync project header](../../../../assets/fork-sync.png)
21+
22+
На изображении выше видно, что моя ветка отстает от основной ветки на 8 коммитов, и мне нужно синхронизировать ее, чтобы она была в актуальном состоянии.
23+
24+
![Sync project update modal](../../../../assets/sync-fork-update.png)
25+
26+
### Перейдите к PR
27+
28+
Перейдите к PR, который вы хотите изучить локально, и узнайте его ID. Вы найдете его в заголовке PR (как показано ниже).
29+
30+
![PR header](../../../../assets/PR-header.png)
31+
32+
Далее откройте терминал в каталоге проекта и выполните следующую команду:
33+
34+
```bash
35+
gh pr checkout <ID>
36+
```
37+
38+
Если вы не помните команду, нажмите на кнопку "Code" в правой части заголовка, и вы сможете легко скопировать/вставить команду.
39+
40+
![PR code modal](../../../../assets/PR-code-btn-modal.png)
41+
42+
:::note[Примечание]
43+
Если команда не сработала, Github CLI подскажет, что делать.
44+
:::
45+
46+
🔥Теперь вы можете изучить решение локально и запустить его для тестирования.🔥
47+
48+
<!-- gh repo set-default -->

Diff for: ‎docs/src/content/docs/ru/guides/contribute.md

+20
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
title: Вносите свой вклад
3+
description: Описание как помочь проекту
4+
sidebar:
5+
order: 4
6+
---
7+
8+
Вы можете помочь проекту многими способами:
9+
10+
🔥 Создавайте новые испытания, следуя инструкциям [тут](/guides/create-challenge).
11+
12+
🔥 Проходите испытания и отправляйте свои решения на ревью (руководство [тут](/guides/resolve-challenge)).
13+
14+
🔥 Проводите ревью чужих решений, оставляя конструктивные и вежливые комментарии.
15+
16+
🔥 Исправляйте опечатки и ошибки в документации.
17+
18+
🔥 Оставляйте issues, чтобы предложить идеи новых испытаний или сообщить об ошибках.
19+
20+
🔥 Поддерживайте проект [тут](https://github.com/sponsors/tomalaforge).

Diff for: ‎docs/src/content/docs/ru/guides/create-challenge.md

+54
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
---
2+
title: Создайте свое испытание
3+
description: Руководство по созданию испытания
4+
sidebar:
5+
order: 5
6+
---
7+
8+
У вас есть идея, которой вы хотите поделиться, интересная ошибка, с которой вы боретесь в одном из своих проектов, или что-то необычное в Angular, что вы обнаружили. Всё это - хорошая отправная точка, чтобы создать испытание и поделиться её решением с другими.
9+
10+
Но как начать создавать испытания?
11+
12+
## Шаблон создания испытания
13+
14+
Чтобы упростить этот процесс, я создал генератор Nx, который настроит все за вас и поможет вам быстрее начать. Проще всего его запустить в консоли Nx: перейдите в раздел <b>Nx Console > generate > @angular-challenges/cli - challenge</b>
15+
16+
### Параметры
17+
18+
#### обязательные параметры
19+
20+
- <b>title</b>: Название, которое вы хотите дать испытанию.
21+
:::note[Примечание]
22+
Название должно быть не больше 25 символов.
23+
:::
24+
25+
- <b>challengeDifficulty</b>: Сложность испытания. Есть три уровня сложности : 🟢 простой / 🟠 средний / 🔴 трудный
26+
- <b>name</b>: Имя NX приложения.
27+
:::note[Примечание]
28+
Имя должно быть написано **kebab-case**
29+
:::
30+
- <b>docRepository</b>: Категория испытания: Nx, Angular, Angular Performance, Rxjs, NgRx, Typescript.
31+
32+
#### необязательные параметры
33+
34+
- <b>directory</b>: Если вы не хотите, чтобы приложение находилось в стандартной папке внутри `apps`.
35+
- <b>addTest</b>: Если хотите добавить конфигурацию теста.
36+
37+
### Что будет создано
38+
39+
- Генератор создаст все файлы, необходимые для нового рабочего приложения. Все эти файлы будут созданы внутри `apps/${directory}/${name}`
40+
- Файл Markdown с минимальными настройками будет создан внутри `docs/src/content/docs/challenges/${docRepository}`
41+
42+
## Создание испытания
43+
44+
Все что осталось - создать испытание. 🚀
45+
46+
:::danger[Опасно]
47+
Не забудьте обновить документацию, чтобы описать свою задачу и дать инструкции.
48+
:::
49+
50+
Дальше действовать будете вы!!! 💪
51+
52+
## Отправка решения
53+
54+
Не забудьте представить своё решение задачи в течение недели.

Diff for: ‎docs/src/content/docs/ru/guides/faq.md

+17
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
title: Часто задаваемые вопросы
3+
description: Ответы на вопросы
4+
sidebar:
5+
order: 7
6+
---
7+
8+
<details>
9+
<summary>Почему мое приложение не запускается, или почему я вижу ошибки в терминале при запуске `nx serve`?</summary>
10+
11+
Чаще всего эта проблема возникает из-за того, что node_modules устарели, и вам нужно обновить их, выполнив команду `npm ci`.
12+
13+
Если установка завершилась неудачно, вы можете попробовать решить эту проблему, удалив папку node_modules с помощью команды `rm -rf node_modules` или `npx npkill` а затем снова выполнить `npm ci`.
14+
15+
Если проблема сохранится, пожалуйста, сообщите о ней [тут](https://github.com/tomalaforge/angular-challenges/issues/new).
16+
17+
</details>

Diff for: ‎docs/src/content/docs/ru/guides/getting-started.md

+58
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
---
2+
title: Первые шаги
3+
description: Руководство о том, как начать работу с испытаниями Angular.
4+
sidebar:
5+
order: 1
6+
---
7+
8+
Чтобы начать работу с <b>испытаниями Angular</b>, выполните следующие шаги:
9+
10+
## Создайте аккаунт на Github
11+
12+
Если вы захотите отправить свое решение для испытания, вам потребуется аккаунт на GitHub. Кроме того, иметь учетную запись на GitHub всегда полезно, тем более это бесплатно.
13+
14+
## Скопируйте github проект
15+
16+
Перейдите в [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">
17+
<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 странице.
18+
19+
## Клонируйте репозиторий на свой компьютер
20+
21+
Выберите папку на своем компьютере и клонируйте репозиторий.
22+
23+
Откройте терминал, перейдите в выбранный каталог и наберите команду:
24+
25+
```bash
26+
git clone https://github.com/[YOUR_GITHUB_NAME]/angular-challenges.git
27+
```
28+
29+
:::note
30+
31+
Вы можете найти URL адрес клонированного репозитория, нажав на кнопку <span class="github-success-btn"><> Code</span> в <b>вашем собственном</b> экземпляре репозитория Angular Challenges.
32+
33+
![Header of github workpspace](../../../../assets/header-github.png)
34+
35+
:::
36+
37+
## Откройте проект в вашей любимой среде разработки
38+
39+
Откройте проект в любой IDE на ваш выбор.
40+
41+
## Установите все зависимости
42+
43+
```bash
44+
npm ci
45+
```
46+
47+
## Выберите задачу
48+
49+
Ваш проект сейчас поднят и запущен. Осталось только выбрать испытание 🚀
50+
51+
Каждое испытание состоит из:
52+
53+
- <b>Имя</b>: описывает о чем испытание.
54+
- <b>Номер</b>: порядковый номер создания. Этот номер не несет какого-то смысла, но служит для ссылки в секции Github Pull Request.
55+
- <b>Бейдж</b>: показывает уровень сложности. Полностью субъективно 😅
56+
- 🟢 простое
57+
- 🟠 среднее
58+
- 🔴 сложное

Diff for: ‎docs/src/content/docs/ru/guides/rebase.md

+55
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
title: Сделайте rebase вашей ветки
3+
description: Руководство по rebase ветки на последние изменения
4+
sidebar:
5+
order: 6
6+
---
7+
8+
Иногда в проект могут вноситься изменения. Я стараюсь вносить изменения, которые ничего не сломают, но иногда этого не избежать.
9+
10+
В большинстве случаев вам не придется делать rebase вашего решения, но вот руководство, которое поможет вам понять, как это сделать.
11+
12+
:::note[Примечание]
13+
Это руководство применимо к любому проекту с открытым исходным кодом.
14+
:::
15+
16+
## Шаги rebase
17+
18+
### Синхронизируйте ваш репозиторий
19+
20+
Во-первых, вам нужно синхронизировать вашу копию, чтобы убедиться, что она содержит последние изменения.
21+
22+
Вы можете сделать это, нажав на кнопку Sync fork на главной странице вашего репозитория.
23+
24+
![Sync project header](../../../../assets/fork-sync.png)
25+
26+
На изображении выше видно, что моя ветка отстает от основной ветки на 8 коммитов, и мне нужно синхронизировать ее, чтобы она была в актуальном состоянии.
27+
28+
![Sync project update modal](../../../../assets/sync-fork-update.png)
29+
30+
### Откройте терминал
31+
32+
Откройте любой терминал, будь то терминал в любимой IDE или отдельное приложение.
33+
34+
### Гит
35+
36+
Выполните следующие команды, чтобы сделать rebase локальной ветки:
37+
38+
- git checkout main
39+
- git pull
40+
- git checkout [your branch]
41+
- git rebase main
42+
- Разрешите конфликты
43+
44+
На этом этапе rebase может остановиться, потому что в вашей локальной ветке есть конфликтующие файлы с основной веткой. Исправьте это. После того как закончите:
45+
46+
- git add .
47+
- git rebase --continue
48+
49+
Если в вашей ветке нет конфликтов, будет показано сообщение об успехе.
50+
51+
### Отправьте свою работу в удаленный репозиторий
52+
53+
Наконец, отправьте свою работу на GitHub:
54+
55+
- git push -f

0 commit comments

Comments
 (0)