mirror of
https://github.com/Raghu-Ch/angular-challenges.git
synced 2026-02-13 06:13:03 -05:00
feat: add translation for 2 first guides
This commit is contained in:
58
docs/src/content/docs/ru/guides/getting-started.md
Normal file
58
docs/src/content/docs/ru/guides/getting-started.md
Normal file
@@ -0,0 +1,58 @@
|
|||||||
|
---
|
||||||
|
title: Первые шаги
|
||||||
|
description: Руководство о том, как начать работу с испытаниями Angular.
|
||||||
|
sidebar:
|
||||||
|
order: 1
|
||||||
|
---
|
||||||
|
|
||||||
|
Чтобы начать работу с <b>испытаниями Angular</b>, выполни следующие шаги:
|
||||||
|
|
||||||
|
## Создай аккаунт на 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 странице.
|
||||||
|
|
||||||
|
## Клонируй репозиторий на свой компьютер
|
||||||
|
|
||||||
|
Выбери папку на своем компьютере и клонируй репозиторий.
|
||||||
|
|
||||||
|
Открой терминал, перейди в выбранный каталог, и набери команду:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/[YOUR_GITHUB_NAME]/angular-challenges.git
|
||||||
|
```
|
||||||
|
|
||||||
|
:::note
|
||||||
|
|
||||||
|
Ты можешь найти URL адрес клонированного репозитория нажав на кнопку <span class="github-success-btn"><> Code</span> в <b>твоем собственном</b> экземпляре репозитория Angular Challenges.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
:::
|
||||||
|
|
||||||
|
## Открой проект в своей любимой среде разработки
|
||||||
|
|
||||||
|
Открой проект в любой IDE на твой выбор.
|
||||||
|
|
||||||
|
## Установи все зависимости
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm ci
|
||||||
|
```
|
||||||
|
|
||||||
|
## Выбери задачу
|
||||||
|
|
||||||
|
Твой проект сейчас поднят и запущен. Осталось только выбрать испытание 🚀
|
||||||
|
|
||||||
|
Каждое испытание состоит из:
|
||||||
|
|
||||||
|
- <b>Имя</b>: описывает о чем испытание.
|
||||||
|
- <b>Номер</b>: номер создания. Этот номер не несет какого-то смысла, но служит для ссылки в секции Github Pull Request.
|
||||||
|
- <b>Бейдж</b>: показывает уровень сложности. Полностью субъективно 😅
|
||||||
|
- 🟢 простое
|
||||||
|
- 🟠 среднее
|
||||||
|
- 🔴 сложное
|
||||||
93
docs/src/content/docs/ru/guides/resolve-challenge.md
Normal file
93
docs/src/content/docs/ru/guides/resolve-challenge.md
Normal file
@@ -0,0 +1,93 @@
|
|||||||
|
---
|
||||||
|
title: Пройди испытание
|
||||||
|
description: Инструкция по прохождению испытания
|
||||||
|
sidebar:
|
||||||
|
order: 2
|
||||||
|
---
|
||||||
|
|
||||||
|
В этом руководстве ты узнаешь, как пройти испытание и отправить решение в основной репозиторий Github.
|
||||||
|
|
||||||
|
## Вступление
|
||||||
|
|
||||||
|
Этот репозиторий работает под управлением [Nx](https://nx.dev/getting-started/intro). <b>Nx</b> это монорепозиторий который позволяет тебе хранить несколько приложений в одном рабочем пространстве.
|
||||||
|
Каждое испытание - это отдельное приложение. Если ты откроешь каталог `apps`, то обнаружишь несколько директорий, каждая из которых относится к определенной задаче. Каждый каталог представляет собой полноценное приложение `Nx`. Чтобы запустить и начать работу с одним из них, открой терминал и выполни команду:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npx nx serve <ИМЯ_ПРИЛОЖЕНИЯ>
|
||||||
|
```
|
||||||
|
|
||||||
|
:::note[Примечание]
|
||||||
|
Если ты не уверен в названии испытания `ИМЯ_ПРИЛОЖЕНИЯ`, открой файл README.md. Там написана команда `serve` со ссылкой на документацию по испытанию.
|
||||||
|
:::
|
||||||
|
|
||||||
|
:::note[Примечание]
|
||||||
|
Если `nx` установлен глобально на твоем компьютере, ты можешь опустить `npx`.
|
||||||
|
Чтобы установить `nx` глобально, выполни
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm i -g nx
|
||||||
|
```
|
||||||
|
|
||||||
|
:::
|
||||||
|
|
||||||
|
## Создай 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` подскажет тебе полную команду.
|
||||||
|
:::
|
||||||
|
|
||||||
|
## Отправь свое решение в основной репозиторий
|
||||||
|
|
||||||
|
Теперь вся твоя работа находится в твоем экземпляре репозитория Angular Challenges.
|
||||||
|
|
||||||
|
Следующий шаг - перейти на главную страницу [Angular Challenges](https://github.com/tomalaforge/angular-challenges) и создать новый запрос на слитие (Pull Request).
|
||||||
|
|
||||||
|
Github должен показать уведомление, чтобы помочь тебе создать pull request.
|
||||||
|
|
||||||
|
Если этого не случилось, то ты либо неправильно выполнил один из предыдущих шагов, либо можешь перейти на вкладку Pull Request и нажать кнопку <span class="github-success-btn">New pull request.</span>
|
||||||
|
|
||||||
|
После того как выберешь две ветки для сравнения, ты попадешь на следующую страницу:
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
В заголовке напиши Answer:, затем номер твоего задания. После этого можешь добавить все, что пожелаешь.
|
||||||
|
|
||||||
|
:::danger[Опасно]
|
||||||
|
Это очень важно. Это позволит другим узнать, какое испытание ты пытаешься решить.
|
||||||
|
:::
|
||||||
|
|
||||||
|
В разделе описания ты можешь добавить вопросы, проблемы, с которыми столкнулся, или все остальное, чем захочешь поделиться. Если написать нечего, можешь оставить этот раздел пустым.
|
||||||
|
|
||||||
|
Теперь можешь нажать на <span class="github-success-btn">Create pull request</span>.
|
||||||
|
|
||||||
|
Я прочитаю и прокомментирую <b>когда у меня будет свободное время.</b>
|
||||||
|
|
||||||
|
<p class="important-block">Не переживай если я не проревьювил твое решение сразу же. Я делаю это <b>бесплатно</b> в свое <b>свободное время</b>. Если ты хочешь меня поддержать, ты можешь это сделать с помощью <a href="https://github.com/sponsors/tomalaforge">поддержать на github</a>. Это покажет, что моя работа полезна для вас или вашей команды.</p>
|
||||||
|
|
||||||
|
:::note[Примечание]
|
||||||
|
Все желающие могут оставлять комментарии и читать другие PR.
|
||||||
|
:::
|
||||||
|
|
||||||
|
:::tip[OSS чемпион]
|
||||||
|
🔥 После того как ты пройдешь это руководство, ты готов внести свой вклад в любой другой публичный репозиторий Github и отправить PR. Это настолько просто.🔥
|
||||||
|
:::
|
||||||
@@ -9,11 +9,11 @@ hero:
|
|||||||
file: ../../../assets/angular-challenge.webp
|
file: ../../../assets/angular-challenge.webp
|
||||||
actions:
|
actions:
|
||||||
- text: Начать
|
- text: Начать
|
||||||
link: /es/guides/getting-started/
|
link: /ru/guides/getting-started/
|
||||||
icon: right-arrow
|
icon: right-arrow
|
||||||
variant: primary
|
variant: primary
|
||||||
- text: Перейти к последней задаче
|
- text: Перейти к последней задаче
|
||||||
link: /es/challenges/angular/39-injection-token/
|
link: /ru/challenges/angular/39-injection-token/
|
||||||
icon: rocket
|
icon: rocket
|
||||||
- text: Добавить звезду
|
- text: Добавить звезду
|
||||||
link: https://github.com/tomalaforge/angular-challenges
|
link: https://github.com/tomalaforge/angular-challenges
|
||||||
|
|||||||
Reference in New Issue
Block a user