mirror of
https://github.com/Raghu-Ch/angular-challenges.git
synced 2026-02-10 21:03:03 -05:00
feat: add translation for 2 first guides
This commit is contained in:
Stanislav Gavrilov
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
|
||||
actions:
|
||||
- text: Начать
|
||||
link: /es/guides/getting-started/
|
||||
link: /ru/guides/getting-started/
|
||||
icon: right-arrow
|
||||
variant: primary
|
||||
- text: Перейти к последней задаче
|
||||
link: /es/challenges/angular/39-injection-token/
|
||||
link: /ru/challenges/angular/39-injection-token/
|
||||
icon: rocket
|
||||
- text: Добавить звезду
|
||||
link: https://github.com/tomalaforge/angular-challenges
|
||||
|
||||
Reference in New Issue
Block a user