From f561dce1de5f6856ba2d705d725bc2569b03eafd Mon Sep 17 00:00:00 2001 From: Stanislav Gavrilov Date: Tue, 23 Jan 2024 23:58:20 +0300 Subject: [PATCH 01/11] feat(ru): add index.mdx translation --- docs/astro.config.mjs | 6 +++ docs/src/content/docs/ru/index.mdx | 79 ++++++++++++++++++++++++++++++ 2 files changed, 85 insertions(+) create mode 100644 docs/src/content/docs/ru/index.mdx diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs index 75d4821c2..ff9502693 100644 --- a/docs/astro.config.mjs +++ b/docs/astro.config.mjs @@ -18,6 +18,10 @@ export const locales = { label: 'Português', lang: 'pt', }, + ru: { + label: 'Русский', + lang: 'ru', + }, }; // https://astro.build/config @@ -44,6 +48,7 @@ export default defineConfig({ es: 'Guías', fr: 'Guides', pt: 'Guias', + ru: 'Руководство', }, }, { @@ -53,6 +58,7 @@ export default defineConfig({ es: 'Desafíos', fr: 'Challenges', pt: 'Desafios', + ru: 'Задачи', }, }, ], diff --git a/docs/src/content/docs/ru/index.mdx b/docs/src/content/docs/ru/index.mdx new file mode 100644 index 000000000..6bb6ab45b --- /dev/null +++ b/docs/src/content/docs/ru/index.mdx @@ -0,0 +1,79 @@ +--- +title: Добро пожаловать в испытания Angular +description: Начни с прохождения этих испытаний и прокачайcя как Angular фронтенд инженер. +template: splash +noCommentSection: true +hero: + tagline: Начни сейчас и стань экспертом Angular! + image: + file: ../../../assets/angular-challenge.webp + actions: + - text: Начать + link: /es/guides/getting-started/ + icon: right-arrow + variant: primary + - text: Перейти к последней задаче + link: /es/challenges/angular/39-injection-token/ + icon: rocket + - text: Добавить звезду + link: https://github.com/tomalaforge/angular-challenges + icon: github + variant: secondary +--- + +import { Card, CardGrid } from '@astrojs/starlight/components'; +import MyIcon from '../../../components/MyIcon.astro'; + + + + Этот репозиторий содержит 43 испытания, связанных с Angular, Nx, RxJS, Ngrx and Typescript. + Испытания основаны на реальных проблемах или инструментах, чтобы прокачать тебя. + + + + Одна из целей этого репозитория снизить барьер для входа в разработку + открытого программного обеспечения (OSS). Решив эти задачи, ты узнаешь, + как начать вносить свой вклад в любой другой проект с открытым исходным кодом. + + + + Изучение и использование нового фреймворка всегда сопряжено с трудностями. + В этом наборе задач содержатся реальные примеры применения полученных знаний. + Любой может оставить комментарий или предложить помощь. + + Учиться одному - здорово, но обучение вместе с другими поможет тебе добиться большего. + + + + + У тебя есть идея или интересный баг? Не стесняйся;{' '} + создавай свои собственные испытания не теряя времени. + + + + Решение этих задач подготовит тебя к любым техническим задачм, с которыми ты + можешь столкнуться на позиции фронтенд-разработчика во время собеседований. + + + + Это бесплатный проект и он стремится оставаться таковым как можно дольше. + Однако все работы ведутся в мое свободное время, включая создание задач и ревью (PRs). + Спонсорство может поддержать меня и способствовать развитию проекта. + + + + +--- + +
+ + + Поддержать проект + +
+ +
+ Создано{' '} + Thomas Laforge - + Работает на 🌟 Starlight +
From 58662777fd93d2a8d231caa29e6e6c9b29d98e0f Mon Sep 17 00:00:00 2001 From: Stanislav Gavrilov Date: Thu, 25 Jan 2024 00:12:25 +0300 Subject: [PATCH 02/11] feat: add translation for 2 first guides --- .../content/docs/ru/guides/getting-started.md | 58 ++++++++++++ .../docs/ru/guides/resolve-challenge.md | 93 +++++++++++++++++++ docs/src/content/docs/ru/index.mdx | 4 +- 3 files changed, 153 insertions(+), 2 deletions(-) create mode 100644 docs/src/content/docs/ru/guides/getting-started.md create mode 100644 docs/src/content/docs/ru/guides/resolve-challenge.md diff --git a/docs/src/content/docs/ru/guides/getting-started.md b/docs/src/content/docs/ru/guides/getting-started.md new file mode 100644 index 000000000..78e64e128 --- /dev/null +++ b/docs/src/content/docs/ru/guides/getting-started.md @@ -0,0 +1,58 @@ +--- +title: Первые шаги +description: Руководство о том, как начать работу с испытаниями Angular. +sidebar: + order: 1 +--- + +Чтобы начать работу с испытаниями Angular, выполни следующие шаги: + +## Создай аккаунт на Github + +Если ты захочешь отправить решение, тебе потребуется аккаунт на GitHub. Кроме того, иметь учетную запись на GitHub всегда полезно. Тем более это бесплатно. + +## Скопируй github проект + +Перейди в [Angular Challenges Repository](https://github.com/tomalaforge/angular-challenges) и нажми на кнопку Fork в вверху страницы. Это создаст копию этого репозитория на твоей GitHub странице. + +## Клонируй репозиторий на свой компьютер + +Выбери папку на своем компьютере и клонируй репозиторий. + +Открой терминал, перейди в выбранный каталог, и набери команду: + +```bash +git clone https://github.com/[YOUR_GITHUB_NAME]/angular-challenges.git +``` + +:::note + +Ты можешь найти URL адрес клонированного репозитория нажав на кнопку <> Code в твоем собственном экземпляре репозитория Angular Challenges. + +![Header of github workpspace](../../../../assets/header-github.png) + +::: + +## Открой проект в своей любимой среде разработки + +Открой проект в любой IDE на твой выбор. + +## Установи все зависимости + +```bash +npm ci +``` + +## Выбери задачу + +Твой проект сейчас поднят и запущен. Осталось только выбрать испытание 🚀 + +Каждое испытание состоит из: + +- Имя: описывает о чем испытание. +- Номер: номер создания. Этот номер не несет какого-то смысла, но служит для ссылки в секции Github Pull Request. +- Бейдж: показывает уровень сложности. Полностью субъективно 😅 + - 🟢 простое + - 🟠 среднее + - 🔴 сложное diff --git a/docs/src/content/docs/ru/guides/resolve-challenge.md b/docs/src/content/docs/ru/guides/resolve-challenge.md new file mode 100644 index 000000000..0adb40baf --- /dev/null +++ b/docs/src/content/docs/ru/guides/resolve-challenge.md @@ -0,0 +1,93 @@ +--- +title: Пройди испытание +description: Инструкция по прохождению испытания +sidebar: + order: 2 +--- + +В этом руководстве ты узнаешь, как пройти испытание и отправить решение в основной репозиторий Github. + +## Вступление + +Этот репозиторий работает под управлением [Nx](https://nx.dev/getting-started/intro). Nx это монорепозиторий который позволяет тебе хранить несколько приложений в одном рабочем пространстве. +Каждое испытание - это отдельное приложение. Если ты откроешь каталог `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 +``` + +## Пройди испытание + +Следуй инструкция чтобы пройти испытание. + +## Сделай коммит и отправь код в репозиторий + +Последний шаг это создание коммита, который следовал бы правилам из [Соглашения о коммитах](https://www.conventionalcommits.org/ru/v1.0.0/). + +Наконец, отправь свою работу в удаленный репозиторий с помощью следующей команды: + +```bash + git push --set-upstream origin +``` + +:::tip[Не запоминай команду] +Тебе не нужно запоминать команду в точности. Нужно просто запомнить `git push`, и если ты впервые пушишь эту ветку, `git` подскажет тебе полную команду. +::: + +## Отправь свое решение в основной репозиторий + +Теперь вся твоя работа находится в твоем экземпляре репозитория Angular Challenges. + +Следующий шаг - перейти на главную страницу [Angular Challenges](https://github.com/tomalaforge/angular-challenges) и создать новый запрос на слитие (Pull Request). + +Github должен показать уведомление, чтобы помочь тебе создать pull request. + +Если этого не случилось, то ты либо неправильно выполнил один из предыдущих шагов, либо можешь перейти на вкладку Pull Request и нажать кнопку New pull request. + +После того как выберешь две ветки для сравнения, ты попадешь на следующую страницу: + +![New pull request screen](../../../../assets/new-pull-request.png) + +В заголовке напиши Answer:, затем номер твоего задания. После этого можешь добавить все, что пожелаешь. + +:::danger[Опасно] +Это очень важно. Это позволит другим узнать, какое испытание ты пытаешься решить. +::: + +В разделе описания ты можешь добавить вопросы, проблемы, с которыми столкнулся, или все остальное, чем захочешь поделиться. Если написать нечего, можешь оставить этот раздел пустым. + +Теперь можешь нажать на Create pull request. + +Я прочитаю и прокомментирую когда у меня будет свободное время. + +

Не переживай если я не проревьювил твое решение сразу же. Я делаю это бесплатно в свое свободное время. Если ты хочешь меня поддержать, ты можешь это сделать с помощью поддержать на github. Это покажет, что моя работа полезна для вас или вашей команды.

+ +:::note[Примечание] +Все желающие могут оставлять комментарии и читать другие PR. +::: + +:::tip[OSS чемпион] +🔥 После того как ты пройдешь это руководство, ты готов внести свой вклад в любой другой публичный репозиторий Github и отправить PR. Это настолько просто.🔥 +::: diff --git a/docs/src/content/docs/ru/index.mdx b/docs/src/content/docs/ru/index.mdx index 6bb6ab45b..2593c0b5c 100644 --- a/docs/src/content/docs/ru/index.mdx +++ b/docs/src/content/docs/ru/index.mdx @@ -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 From f86daac528d9ff6725f1f916d1481e8f270f6496 Mon Sep 17 00:00:00 2001 From: Stanislav Gavrilov Date: Thu, 25 Jan 2024 20:50:31 +0300 Subject: [PATCH 03/11] feat: ru translate checkout-answer --- .../content/docs/ru/guides/checkout-answer.md | 48 +++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 docs/src/content/docs/ru/guides/checkout-answer.md diff --git a/docs/src/content/docs/ru/guides/checkout-answer.md b/docs/src/content/docs/ru/guides/checkout-answer.md new file mode 100644 index 000000000..b320cd6bc --- /dev/null +++ b/docs/src/content/docs/ru/guides/checkout-answer.md @@ -0,0 +1,48 @@ +--- +title: Изучай чужие решения +description: Руководство по просмотру чужого ответа. +sidebar: + order: 3 +--- + +Все ответы на испытания Angular представлены в виде Pull Request (PR). Чтобы их просмотреть и изучить, перейди на страницу **Files Changes** на GitHub. Однако, если ты не знаком с интерфейсом, процесс может быть не очевидным. Иногда просмотреть решение в твоей любимой IDE может быть удобнее. + +Это руководство поможет тебе с этим. + +## Проверьте чужой PR локально + +### Синхронизируй свой репозиторий + +В начале тебе нужно синхронизировать твою копию репозитория, чтобы убедиться, что она находится в актуальном состоянии. + +Это можно сделать, нажав кнопку **Sync fork** на главной странице репозитория. + +![Sync project header](../../../../assets/fork-sync.png) + +На изображении выше видно, что моя ветка отстает от основной ветки на 8 коммитов, и мне нужно синхронизировать ее, чтобы она была в актуальном состоянии. + +![Sync project update modal](../../../../assets/sync-fork-update.png) + +### Перейди на PR + +Перейди к PR, который ты хочешь изучить локально, и узнай его ID. Ты найдешь его в заголовке PR (как показано ниже). + +![PR header](../../../../assets/PR-header.png) + +Далее открой терминал в каталоге проекта и выполни следующую команду: + +```bash +gh pr checkout +``` + +Если ты не помнишь команду, нажми на кнопку "Code" в правой части заголовка, и ты сможешь легко скопировать/вставить команду. + +![PR code modal](../../../../assets/PR-code-btn-modal.png) + +:::note[Примечание] +Если команда не сработала или не выполнилась, Github CLI подскажет что делать. +::: + +🔥Теперь ты можешь изучать решение локально и запускать его для тестирования.🔥 + + From c1ed17b0158d190c7f792a60333fc1caf67d4495 Mon Sep 17 00:00:00 2001 From: Stanislav Gavrilov Date: Thu, 25 Jan 2024 21:31:11 +0300 Subject: [PATCH 04/11] feat: add ru translate for contribute page --- docs/src/content/docs/ru/guides/contribute.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 docs/src/content/docs/ru/guides/contribute.md diff --git a/docs/src/content/docs/ru/guides/contribute.md b/docs/src/content/docs/ru/guides/contribute.md new file mode 100644 index 000000000..26e5aa308 --- /dev/null +++ b/docs/src/content/docs/ru/guides/contribute.md @@ -0,0 +1,20 @@ +--- +title: Вноси свой вклад +description: Описание как помочь проекту +sidebar: + order: 4 +--- + +Ты можешь помочь проекту многими способами: + +🔥 Создавай новые испытания, следуя инструкциям [тут](/guides/create-challenge). + +🔥 Проходи испытания и отправляй свои решения. (руководство [тут](/guides/resolve-challenge)). + +🔥 Проводи ревью чужих решений, давая конструктивные и дружелюбные комментарии. + +🔥 Исправляй опечатки и ошибки в документации. + +🔥 Оставляй заявки, чтобы предложить идеи новых испытаний или чтобы сообщить об ошибках. + +🔥 Поддерживай проект [тут](https://github.com/sponsors/tomalaforge). From ca5b2a5300fe3f495ead5fa805e7f2cf61435556 Mon Sep 17 00:00:00 2001 From: Stanislav Gavrilov Date: Thu, 25 Jan 2024 21:38:29 +0300 Subject: [PATCH 05/11] feat: add ru translation for faq --- docs/src/content/docs/ru/guides/faq.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 docs/src/content/docs/ru/guides/faq.md diff --git a/docs/src/content/docs/ru/guides/faq.md b/docs/src/content/docs/ru/guides/faq.md new file mode 100644 index 000000000..ad12e0ac7 --- /dev/null +++ b/docs/src/content/docs/ru/guides/faq.md @@ -0,0 +1,17 @@ +--- +title: Часто задаваемые вопросы +description: Ответы на вопросы +sidebar: + order: 7 +--- + +
+ Почему мое приложение не запускается, или почему я вижу ошибки в терминале при запуске `nx serve`? + +Чаще всего эта проблема возникает из-за того, что фnode_modules устарели, и тебе нужно обновить их, выполнив команду `npm ci`. + +Если установка завершилась неудачно, ты можешь решить эту проблему, удалив папку node_modules с помощью команды `rm -rf node_modules` или `npx npkill` а затем снова выполнить `npm ci`. + +Если проблема сохраняется, пожалуйста сообщи о ней [тут](https://github.com/tomalaforge/angular-challenges/issues/new). + +
From 7f384feabceee5ee0e823e20c66b04ba05b36d3b Mon Sep 17 00:00:00 2001 From: Stanislav Gavrilov Date: Thu, 25 Jan 2024 21:58:51 +0300 Subject: [PATCH 06/11] feat: add ru translation for create-challenge --- .../docs/ru/guides/create-challenge.md | 54 +++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/src/content/docs/ru/guides/create-challenge.md diff --git a/docs/src/content/docs/ru/guides/create-challenge.md b/docs/src/content/docs/ru/guides/create-challenge.md new file mode 100644 index 000000000..781097392 --- /dev/null +++ b/docs/src/content/docs/ru/guides/create-challenge.md @@ -0,0 +1,54 @@ +--- +title: Создай свое испытание +description: Руководство по созданию испытания +sidebar: + order: 5 +--- + +У тебя есть идея, которой ты хочешь поделиться, интересная ошибка, с которой ты борешься в одном из своих приватных или побочных проектов, или трюк Angular, который ты обнаружил. Все эти возможности - хорошая отправная точка, чтобы создать задачу и поделиться ее решением с другими. + +Но как начать создавать испытания? + +## Шаблон создания испытания + +Чтобы упростить этот процесс, я создал генератор Nx, который настроит все за тебя и поможет тебе быстрее начать. Проще всего его запустить в консоли Nx: перейди в раздел Nx Console > generate > @angular-challenges/cli - challenge + +### Параметры + +#### обязательные параметры + +- title: Название, которое ты хочешь дать испытанию. + :::note[Примечание] + Название должно быть не больше 25 символов. + ::: + +- challengeDifficulty: Сложность испытания. Есть три уровня сложности : 🟢 простой / 🟠 средний / 🔴 трудный +- name: Имя NX приложения. + :::note[Примечание] + Имя должно быть написано **kebab-case** + ::: +- docRepository: Категория испытания: Nx, Angular, Angular Performance, Rxjs, NgRx, Typescript. + +#### не обязательные параметры + +- directory: Если ты хочешь, чтобы приложение находилось в определенной папке внутри `apps`. +- addTest: Если хочешь добавить конфигурацию теста. + +### Что будет создано + +- Генератор создаст все файлы, необходимые для нового рабочего приложения. Все эти файлы будут созданы внутри `apps/${directory}/${name}` +- Файл Markdown с минимальными настройками будет создан внутри `docs/src/content/docs/challenges/${docRepository}` + +## Создание испытания + +Все что осталось - создать испытание. 🚀 + +:::danger[Опасно] +Не забудь обновить документацию, чтобы описать свою задачу и дать инструкции. +::: + +Дальше действовать будешь ты!!! 💪 + +## Отправка решения + +Через неделю или около того не забудь представить свое решение задачи. From 8374234377a8de1e31e063185422603fc7ac1e93 Mon Sep 17 00:00:00 2001 From: Stanislav Gavrilov Date: Thu, 25 Jan 2024 22:17:40 +0300 Subject: [PATCH 07/11] feat: add ru translation for rebase page --- docs/src/content/docs/ru/guides/rebase.md | 55 +++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 docs/src/content/docs/ru/guides/rebase.md diff --git a/docs/src/content/docs/ru/guides/rebase.md b/docs/src/content/docs/ru/guides/rebase.md new file mode 100644 index 000000000..12efc34e0 --- /dev/null +++ b/docs/src/content/docs/ru/guides/rebase.md @@ -0,0 +1,55 @@ +--- +title: Сделай rebase своей ветки +description: Руководство по rebase ветки на последние изменения +sidebar: + order: 6 +--- + +Иногда в проект могут вноситься изменения. Я стараюсь вносить изменения, которые ничего не сломают, но иногда это неизбежно. + +В большинстве случаев тебе не придется делать rebase твоего решения, но вот руководство, которое поможет тебе узнать, как это сделать. + +:::note[Примечание] +Это руководство применимо к любому проекту с открытым исходным кодом. +::: + +## Шаги rebase + +### Синхронизируй свой репозиторий + +Во-первых, тебе нужно синхронизировать твою копию, чтобы убедиться, что она содержит последние изменения. + +Ты можешь сделать это, нажав на кнопку Sync fork на главной странице твоего репозитория. + +![Sync project header](../../../../assets/fork-sync.png) + +На изображении выше видно, что моя ветка отстает от основной ветки на 8 коммитов, и мне нужно синхронизировать ее, чтобы она была в актуальном состоянии. + +![Sync project update modal](../../../../assets/sync-fork-update.png) + +### Открой терминал + +Откройте любой терминал, будь то терминал в любимой IDE или отдельное приложение. + +### Гит + +Выполните следующие команды, чтобы сделать rebase локальной ветки: + +- git checkout main +- git pull +- git checkout [your branch] +- git rebase main +- Реши конфликты + +На этом этапе rebase может остановиться, потому что в твоей локальной ветке есть конфликтующие файлы с основной веткой. Исправь это. После того как закончишь: + +- git add . +- git rebase --continue + +Если в твоей ветке нет конфликтов, будет показано сообщение об успехе. + +### Отправь свою работу в удаленный репозиторий + +Наконец, отправь свою работу на GitHub: + +- git push -f From a1bf3fa14156b19702fee4c61b385ea1e7cb9779 Mon Sep 17 00:00:00 2001 From: Stanislav Gavrilov Date: Sat, 27 Jan 2024 14:12:22 +0300 Subject: [PATCH 08/11] refactor: changed the translation a little bit --- .../content/docs/ru/guides/checkout-answer.md | 24 ++++----- docs/src/content/docs/ru/guides/contribute.md | 16 +++--- .../docs/ru/guides/create-challenge.md | 18 +++---- docs/src/content/docs/ru/guides/faq.md | 6 +-- .../content/docs/ru/guides/getting-started.md | 32 +++++------ docs/src/content/docs/ru/guides/rebase.md | 24 ++++----- .../docs/ru/guides/resolve-challenge.md | 54 +++++++++---------- 7 files changed, 87 insertions(+), 87 deletions(-) diff --git a/docs/src/content/docs/ru/guides/checkout-answer.md b/docs/src/content/docs/ru/guides/checkout-answer.md index b320cd6bc..375cf87ba 100644 --- a/docs/src/content/docs/ru/guides/checkout-answer.md +++ b/docs/src/content/docs/ru/guides/checkout-answer.md @@ -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 ``` -Если ты не помнишь команду, нажми на кнопку "Code" в правой части заголовка, и ты сможешь легко скопировать/вставить команду. +Если вы не помните команду, нажмите на кнопку "Code" в правой части заголовка, и вы сможете легко скопировать/вставить команду. ![PR code modal](../../../../assets/PR-code-btn-modal.png) :::note[Примечание] -Если команда не сработала или не выполнилась, Github CLI подскажет что делать. +Если команда не сработала, Github CLI подскажет что делать. ::: -🔥Теперь ты можешь изучать решение локально и запускать его для тестирования.🔥 +🔥Теперь вы можете изучить решение локально и запустить его для тестирования.🔥 diff --git a/docs/src/content/docs/ru/guides/contribute.md b/docs/src/content/docs/ru/guides/contribute.md index 26e5aa308..e4855471f 100644 --- a/docs/src/content/docs/ru/guides/contribute.md +++ b/docs/src/content/docs/ru/guides/contribute.md @@ -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). diff --git a/docs/src/content/docs/ru/guides/create-challenge.md b/docs/src/content/docs/ru/guides/create-challenge.md index 781097392..7234e38a6 100644 --- a/docs/src/content/docs/ru/guides/create-challenge.md +++ b/docs/src/content/docs/ru/guides/create-challenge.md @@ -1,23 +1,23 @@ --- -title: Создай свое испытание +title: Создайте свое испытание description: Руководство по созданию испытания sidebar: order: 5 --- -У тебя есть идея, которой ты хочешь поделиться, интересная ошибка, с которой ты борешься в одном из своих приватных или побочных проектов, или трюк Angular, который ты обнаружил. Все эти возможности - хорошая отправная точка, чтобы создать задачу и поделиться ее решением с другими. +У вас есть идея, которой вы хотите поделиться, интересная ошибка, с которой вы боретесь в одном из своих проектов, или что-то необычное в Angular, что вы обнаружили. Всё это - хорошая отправная точка, чтобы создать испытание и поделиться её решением с другими. Но как начать создавать испытания? ## Шаблон создания испытания -Чтобы упростить этот процесс, я создал генератор Nx, который настроит все за тебя и поможет тебе быстрее начать. Проще всего его запустить в консоли Nx: перейди в раздел Nx Console > generate > @angular-challenges/cli - challenge +Чтобы упростить этот процесс, я создал генератор Nx, который настроит все за вас и поможет вам быстрее начать. Проще всего его запустить в консоли Nx: перейдите в раздел Nx Console > generate > @angular-challenges/cli - challenge ### Параметры #### обязательные параметры -- title: Название, которое ты хочешь дать испытанию. +- title: Название, которое вы хотите дать испытанию. :::note[Примечание] Название должно быть не больше 25 символов. ::: @@ -31,8 +31,8 @@ sidebar: #### не обязательные параметры -- directory: Если ты хочешь, чтобы приложение находилось в определенной папке внутри `apps`. -- addTest: Если хочешь добавить конфигурацию теста. +- directory: Если вы не хотите, чтобы приложение находилось в стандартной папке внутри `apps`. +- addTest: Если хотите добавить конфигурацию теста. ### Что будет создано @@ -44,11 +44,11 @@ sidebar: Все что осталось - создать испытание. 🚀 :::danger[Опасно] -Не забудь обновить документацию, чтобы описать свою задачу и дать инструкции. +Не забудьте обновить документацию, чтобы описать свою задачу и дать инструкции. ::: -Дальше действовать будешь ты!!! 💪 +Дальше действовать будете вы!!! 💪 ## Отправка решения -Через неделю или около того не забудь представить свое решение задачи. +Через неделю или около того не забудьте представить своё решение задачи. diff --git a/docs/src/content/docs/ru/guides/faq.md b/docs/src/content/docs/ru/guides/faq.md index ad12e0ac7..1e68687fc 100644 --- a/docs/src/content/docs/ru/guides/faq.md +++ b/docs/src/content/docs/ru/guides/faq.md @@ -8,10 +8,10 @@ sidebar:
Почему мое приложение не запускается, или почему я вижу ошибки в терминале при запуске `nx serve`? -Чаще всего эта проблема возникает из-за того, что ф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).
diff --git a/docs/src/content/docs/ru/guides/getting-started.md b/docs/src/content/docs/ru/guides/getting-started.md index 78e64e128..714501617 100644 --- a/docs/src/content/docs/ru/guides/getting-started.md +++ b/docs/src/content/docs/ru/guides/getting-started.md @@ -5,22 +5,22 @@ sidebar: order: 1 --- -Чтобы начать работу с испытаниями Angular, выполни следующие шаги: +Чтобы начать работу с испытаниями Angular, выполните следующие шаги: -## Создай аккаунт на Github +## Создайте аккаунт на Github -Если ты захочешь отправить решение, тебе потребуется аккаунт на GitHub. Кроме того, иметь учетную запись на GitHub всегда полезно. Тем более это бесплатно. +Если вы захотите отправить свое решение для испытания, вам потребуется аккаунт на GitHub. Кроме того, иметь учетную запись на GitHub всегда полезно. Тем более это бесплатно. -## Скопируй github проект +## Скопируйте github проект -Перейди в [Angular Challenges Repository](https://github.com/tomalaforge/angular-challenges) и нажми на кнопку Fork в вверху страницы. Это создаст копию этого репозитория на твоей GitHub странице. +Перейдите в [Angular Challenges Repository](https://github.com/tomalaforge/angular-challenges) и нажмите на кнопку Fork в вверху страницы. Это создаст копию репозитория на вашей 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 адрес клонированного репозитория нажав на кнопку <> Code в твоем собственном экземпляре репозитория Angular Challenges. +Вы можете найти URL адрес клонированного репозитория нажав на кнопку <> Code в вашем собственном экземпляре репозитория Angular Challenges. ![Header of github workpspace](../../../../assets/header-github.png) ::: -## Открой проект в своей любимой среде разработки +## Откройте проект в вашей любимой среде разработки -Открой проект в любой IDE на твой выбор. +Откройте проект в любой IDE на ваш выбор. -## Установи все зависимости +## Установите все зависимости ```bash npm ci ``` -## Выбери задачу +## Выберите задачу -Твой проект сейчас поднят и запущен. Осталось только выбрать испытание 🚀 +Ваш проект сейчас поднят и запущен. Осталось только выбрать испытание 🚀 Каждое испытание состоит из: - Имя: описывает о чем испытание. -- Номер: номер создания. Этот номер не несет какого-то смысла, но служит для ссылки в секции Github Pull Request. +- Номер: порядковый номер создания. Этот номер не несет какого-то смысла, но служит для ссылки в секции Github Pull Request. - Бейдж: показывает уровень сложности. Полностью субъективно 😅 - 🟢 простое - 🟠 среднее diff --git a/docs/src/content/docs/ru/guides/rebase.md b/docs/src/content/docs/ru/guides/rebase.md index 12efc34e0..7ca098f2f 100644 --- a/docs/src/content/docs/ru/guides/rebase.md +++ b/docs/src/content/docs/ru/guides/rebase.md @@ -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 diff --git a/docs/src/content/docs/ru/guides/resolve-challenge.md b/docs/src/content/docs/ru/guides/resolve-challenge.md index 0adb40baf..09c5f4c99 100644 --- a/docs/src/content/docs/ru/guides/resolve-challenge.md +++ b/docs/src/content/docs/ru/guides/resolve-challenge.md @@ -1,28 +1,28 @@ --- -title: Пройди испытание +title: Пройдите испытание description: Инструкция по прохождению испытания sidebar: order: 2 --- -В этом руководстве ты узнаешь, как пройти испытание и отправить решение в основной репозиторий Github. +В этом руководстве вы узнаете, как пройти испытание и отправить свое решение. ## Вступление -Этот репозиторий работает под управлением [Nx](https://nx.dev/getting-started/intro). Nx это монорепозиторий который позволяет тебе хранить несколько приложений в одном рабочем пространстве. -Каждое испытание - это отдельное приложение. Если ты откроешь каталог `apps`, то обнаружишь несколько директорий, каждая из которых относится к определенной задаче. Каждый каталог представляет собой полноценное приложение `Nx`. Чтобы запустить и начать работу с одним из них, открой терминал и выполни команду: +Этот репозиторий работает под управлением [Nx](https://nx.dev/getting-started/intro). Nx это монорепозиторий который позволяет вам хранить несколько приложений в одном рабочем пространстве. +Каждое испытание - это отдельное приложение. Если вы откроете каталог `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 ``` -## Пройди испытание +## Пройдите испытание -Следуй инструкция чтобы пройти испытание. +Изучите инструкции чтобы пройти испытание. -## Сделай коммит и отправь код в репозиторий +## Сделайте коммит и отправьте код в репозиторий Последний шаг это создание коммита, который следовал бы правилам из [Соглашения о коммитах](https://www.conventionalcommits.org/ru/v1.0.0/). -Наконец, отправь свою работу в удаленный репозиторий с помощью следующей команды: +Наконец, отправьте свою работу в удаленный репозиторий с помощью следующей команды: ```bash git push --set-upstream origin ``` :::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 и нажать кнопку New pull request. +Если этого не случилось, то вы либо неправильно выполнили один из предыдущих шагов, либо вам нужно перейти на вкладку Pull Request и нажать кнопку New pull request. -После того как выберешь две ветки для сравнения, ты попадешь на следующую страницу: +После того как вы выберете две ветки для сравнения, вы попадете на следующую страницу: ![New pull request screen](../../../../assets/new-pull-request.png) -В заголовке напиши Answer:, затем номер твоего задания. После этого можешь добавить все, что пожелаешь. +В заголовке напишите Answer:, затем номер вашего испытания. После этого можете добавить все, что пожелаете. :::danger[Опасно] -Это очень важно. Это позволит другим узнать, какое испытание ты пытаешься решить. +Порядковый номер очень важен. Он позволит другим узнать, какое испытание вы пытаетесь решить. ::: -В разделе описания ты можешь добавить вопросы, проблемы, с которыми столкнулся, или все остальное, чем захочешь поделиться. Если написать нечего, можешь оставить этот раздел пустым. +В разделе описания вы можете добавить вопросы, проблемы, с которыми столкнулись, или все остальное, чем захотите поделиться. Если нечего написать, можете оставить этот раздел пустым. -Теперь можешь нажать на Create pull request. +Теперь вы можете нажать на кнопку Create pull request. -Я прочитаю и прокомментирую когда у меня будет свободное время. +Я прочитаю и проведу ревью вашего решения когда у меня будет свободное время. -

Не переживай если я не проревьювил твое решение сразу же. Я делаю это бесплатно в свое свободное время. Если ты хочешь меня поддержать, ты можешь это сделать с помощью поддержать на github. Это покажет, что моя работа полезна для вас или вашей команды.

+

Не переживайте если я не прокомментировал ваше решение сразу же. Я делаю это бесплатно в свое свободное время. Если вы хотите меня поддержать, вы можете это сделать с помощью поддержать на github. Это покажет, что моя работа полезна для вас или вашей команды.

:::note[Примечание] Все желающие могут оставлять комментарии и читать другие PR. ::: :::tip[OSS чемпион] -🔥 После того как ты пройдешь это руководство, ты готов внести свой вклад в любой другой публичный репозиторий Github и отправить PR. Это настолько просто.🔥 +🔥 После того как вы пройдете это руководство, вы сможете внести свой вклад в любой другой публичный репозиторий на Github. Да, это настолько просто.🔥 ::: From 50e483999992f6486c8d2147691398745d6bfb57 Mon Sep 17 00:00:00 2001 From: Stanislav Gavrilov Date: Sat, 27 Jan 2024 14:13:18 +0300 Subject: [PATCH 09/11] refactor: changed the translation a little bit --- docs/src/content/docs/ru/index.mdx | 34 +++++++++++++++--------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/src/content/docs/ru/index.mdx b/docs/src/content/docs/ru/index.mdx index 2593c0b5c..331b306ea 100644 --- a/docs/src/content/docs/ru/index.mdx +++ b/docs/src/content/docs/ru/index.mdx @@ -1,10 +1,10 @@ --- title: Добро пожаловать в испытания Angular -description: Начни с прохождения этих испытаний и прокачайcя как Angular фронтенд инженер. +description: Начните с прохождения этих испытаний и прокачайтесь как Angular разработчик. template: splash noCommentSection: true hero: - tagline: Начни сейчас и стань экспертом Angular! + tagline: Начните сейчас и станьте экспертом Angular! image: file: ../../../assets/angular-challenge.webp actions: @@ -27,37 +27,37 @@ import MyIcon from '../../../components/MyIcon.astro'; Этот репозиторий содержит 43 испытания, связанных с Angular, Nx, RxJS, Ngrx and Typescript. - Испытания основаны на реальных проблемах или инструментах, чтобы прокачать тебя. + Испытания основаны на реальных задачах или инструментах, для того чтобы прокачать вас. - - Одна из целей этого репозитория снизить барьер для входа в разработку - открытого программного обеспечения (OSS). Решив эти задачи, ты узнаешь, + + Одна из целей этого репозитория снизить барьер для разработки + открытого программного обеспечения (OSS). Решив эти задачи, вы поймете как начать вносить свой вклад в любой другой проект с открытым исходным кодом. - + Изучение и использование нового фреймворка всегда сопряжено с трудностями. - В этом наборе задач содержатся реальные примеры применения полученных знаний. + В этом наборе испытаний содержатся реальные примеры задач, чтобы закрепить на практике то чему вы научились. Любой может оставить комментарий или предложить помощь. - Учиться одному - здорово, но обучение вместе с другими поможет тебе добиться большего. + Учиться одному - здорово, но обучение вместе с другими поможет вам добиться большего. - - У тебя есть идея или интересный баг? Не стесняйся;{' '} - создавай свои собственные испытания не теряя времени. + + У вас есть идея или интересный баг? Не стесняйтесь;{' '} + Создавайте свои собственные испытания не теряя времени. - - Решение этих задач подготовит тебя к любым техническим задачм, с которыми ты - можешь столкнуться на позиции фронтенд-разработчика во время собеседований. + + Прохождение этих испытаний подготовит вас к техническим задачам, с которыми вы + можете столкнуться во время собеседований на позицию фронтенд-разработчика. - Это бесплатный проект и он стремится оставаться таковым как можно дольше. - Однако все работы ведутся в мое свободное время, включая создание задач и ревью (PRs). + Это бесплатный проект и он будет оставаться таковым как можно дольше. + Однако вся работа ведется в мое свободное время, включая создание новых испытаний и ревью их решении(PRs). Спонсорство может поддержать меня и способствовать развитию проекта. From a05af066831eed0ad5b875dc59c85f5d0c8437ed Mon Sep 17 00:00:00 2001 From: Stanislav Gavrilov Date: Sat, 27 Jan 2024 22:48:58 +0300 Subject: [PATCH 10/11] refactor: fix typos --- docs/src/content/docs/ru/guides/checkout-answer.md | 2 +- docs/src/content/docs/ru/guides/contribute.md | 6 +++--- docs/src/content/docs/ru/guides/create-challenge.md | 4 ++-- docs/src/content/docs/ru/guides/faq.md | 2 +- docs/src/content/docs/ru/guides/getting-started.md | 6 +++--- docs/src/content/docs/ru/guides/resolve-challenge.md | 12 ++++++------ docs/src/content/docs/ru/index.mdx | 10 +++++----- 7 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/src/content/docs/ru/guides/checkout-answer.md b/docs/src/content/docs/ru/guides/checkout-answer.md index 375cf87ba..57b54d49c 100644 --- a/docs/src/content/docs/ru/guides/checkout-answer.md +++ b/docs/src/content/docs/ru/guides/checkout-answer.md @@ -40,7 +40,7 @@ gh pr checkout ![PR code modal](../../../../assets/PR-code-btn-modal.png) :::note[Примечание] -Если команда не сработала, Github CLI подскажет что делать. +Если команда не сработала, Github CLI подскажет, что делать. ::: 🔥Теперь вы можете изучить решение локально и запустить его для тестирования.🔥 diff --git a/docs/src/content/docs/ru/guides/contribute.md b/docs/src/content/docs/ru/guides/contribute.md index e4855471f..ed83760a4 100644 --- a/docs/src/content/docs/ru/guides/contribute.md +++ b/docs/src/content/docs/ru/guides/contribute.md @@ -9,12 +9,12 @@ sidebar: 🔥 Создавайте новые испытания, следуя инструкциям [тут](/guides/create-challenge). -🔥 Проходите испытания и отправляйте свои решения на ревью. (руководство [тут](/guides/resolve-challenge)). +🔥 Проходите испытания и отправляйте свои решения на ревью (руководство [тут](/guides/resolve-challenge)). -🔥 Проводите ревью чужих решений, оставляя конструктивные и дружелюбные комментарии. +🔥 Проводите ревью чужих решений, оставляя конструктивные и вежливые комментарии. 🔥 Исправляйте опечатки и ошибки в документации. -🔥 Оставляйте issues, чтобы предложить идеи новых испытаний или чтобы сообщить об ошибках. +🔥 Оставляйте issues, чтобы предложить идеи новых испытаний или сообщить об ошибках. 🔥 Поддерживайте проект [тут](https://github.com/sponsors/tomalaforge). diff --git a/docs/src/content/docs/ru/guides/create-challenge.md b/docs/src/content/docs/ru/guides/create-challenge.md index 7234e38a6..7f09f370d 100644 --- a/docs/src/content/docs/ru/guides/create-challenge.md +++ b/docs/src/content/docs/ru/guides/create-challenge.md @@ -29,7 +29,7 @@ sidebar: ::: - docRepository: Категория испытания: Nx, Angular, Angular Performance, Rxjs, NgRx, Typescript. -#### не обязательные параметры +#### необязательные параметры - directory: Если вы не хотите, чтобы приложение находилось в стандартной папке внутри `apps`. - addTest: Если хотите добавить конфигурацию теста. @@ -51,4 +51,4 @@ sidebar: ## Отправка решения -Через неделю или около того не забудьте представить своё решение задачи. +Не забудьте представить своё решение задачи в течение недели. diff --git a/docs/src/content/docs/ru/guides/faq.md b/docs/src/content/docs/ru/guides/faq.md index 1e68687fc..f3fe0c6a5 100644 --- a/docs/src/content/docs/ru/guides/faq.md +++ b/docs/src/content/docs/ru/guides/faq.md @@ -12,6 +12,6 @@ sidebar: Если установка завершилась неудачно, вы можете попробовать решить эту проблему, удалив папку 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). diff --git a/docs/src/content/docs/ru/guides/getting-started.md b/docs/src/content/docs/ru/guides/getting-started.md index 714501617..163b468ab 100644 --- a/docs/src/content/docs/ru/guides/getting-started.md +++ b/docs/src/content/docs/ru/guides/getting-started.md @@ -9,7 +9,7 @@ sidebar: ## Создайте аккаунт на Github -Если вы захотите отправить свое решение для испытания, вам потребуется аккаунт на GitHub. Кроме того, иметь учетную запись на GitHub всегда полезно. Тем более это бесплатно. +Если вы захотите отправить свое решение для испытания, вам потребуется аккаунт на GitHub. Кроме того, иметь учетную запись на GitHub всегда полезно, тем более это бесплатно. ## Скопируйте github проект @@ -20,7 +20,7 @@ sidebar: Выберите папку на своем компьютере и клонируйте репозиторий. -Откройте терминал, перейдите в выбранный каталог, и наберите команду: +Откройте терминал, перейдите в выбранный каталог и наберите команду: ```bash git clone https://github.com/[YOUR_GITHUB_NAME]/angular-challenges.git @@ -28,7 +28,7 @@ git clone https://github.com/[YOUR_GITHUB_NAME]/angular-challenges.git :::note -Вы можете найти URL адрес клонированного репозитория нажав на кнопку <> Code в вашем собственном экземпляре репозитория Angular Challenges. +Вы можете найти URL адрес клонированного репозитория, нажав на кнопку <> Code в вашем собственном экземпляре репозитория Angular Challenges. ![Header of github workpspace](../../../../assets/header-github.png) diff --git a/docs/src/content/docs/ru/guides/resolve-challenge.md b/docs/src/content/docs/ru/guides/resolve-challenge.md index 09c5f4c99..4a26d9dca 100644 --- a/docs/src/content/docs/ru/guides/resolve-challenge.md +++ b/docs/src/content/docs/ru/guides/resolve-challenge.md @@ -9,7 +9,7 @@ sidebar: ## Вступление -Этот репозиторий работает под управлением [Nx](https://nx.dev/getting-started/intro). Nx это монорепозиторий который позволяет вам хранить несколько приложений в одном рабочем пространстве. +Этот репозиторий работает под управлением [Nx](https://nx.dev/getting-started/intro). Nx - это монорепозиторий, который позволяет вам хранить несколько приложений в одном рабочем пространстве. Каждое испытание - это отдельное приложение. Если вы откроете каталог `apps`, то обнаружите несколько директорий, каждая из которых относится к определенной задаче. Каждый каталог представляет собой полноценное приложение `Nx`. Чтобы запустить и начать работу с одним из них, откройте терминал и выполните команду: ```bash @@ -21,7 +21,7 @@ npx nx serve <ИМЯ_ПРИЛОЖЕНИЯ> ::: :::note[Примечание] -Если `nx` установлен глобально на вашем компьютере, вы можешь опустить команду `npx`. +Если `nx` установлен глобально на вашем компьютере, вы можете опустить команду `npx`. Чтобы установить `nx` глобально, выполните ```bash @@ -40,11 +40,11 @@ git checkout -b ## Пройдите испытание -Изучите инструкции чтобы пройти испытание. +Изучите инструкции, чтобы пройти испытание. ## Сделайте коммит и отправьте код в репозиторий -Последний шаг это создание коммита, который следовал бы правилам из [Соглашения о коммитах](https://www.conventionalcommits.org/ru/v1.0.0/). +Последний шаг - это создание коммита, который следовал бы правилам из [Соглашения о коммитах](https://www.conventionalcommits.org/ru/v1.0.0/). Наконец, отправьте свою работу в удаленный репозиторий с помощью следующей команды: @@ -53,7 +53,7 @@ git checkout -b ``` :::tip[Не запоминай команду] -Вам не нужно запоминать команду в точности. Нужно просто запомнить `git push`, и если вы впервые загружаешь эту ветку в репозиторий, `git` подскажет вам полную команду. +Вам не нужно запоминать команду в точности. Нужно просто запомнить `git push`, и если вы впервые загружаете эту ветку в репозиторий, `git` подскажет вам полную команду. ::: ## Отправьте свое решение в основной репозиторий @@ -80,7 +80,7 @@ Github должен показать уведомление, чтобы помо Теперь вы можете нажать на кнопку Create pull request. -Я прочитаю и проведу ревью вашего решения когда у меня будет свободное время. +Я прочитаю и проведу ревью вашего решения, когда у меня будет свободное время.

Не переживайте если я не прокомментировал ваше решение сразу же. Я делаю это бесплатно в свое свободное время. Если вы хотите меня поддержать, вы можете это сделать с помощью поддержать на github. Это покажет, что моя работа полезна для вас или вашей команды.

diff --git a/docs/src/content/docs/ru/index.mdx b/docs/src/content/docs/ru/index.mdx index 331b306ea..f95ea5873 100644 --- a/docs/src/content/docs/ru/index.mdx +++ b/docs/src/content/docs/ru/index.mdx @@ -27,18 +27,18 @@ import MyIcon from '../../../components/MyIcon.astro'; Этот репозиторий содержит 43 испытания, связанных с Angular, Nx, RxJS, Ngrx and Typescript. - Испытания основаны на реальных задачах или инструментах, для того чтобы прокачать вас. + Испытания основаны на реальных задачах или инструментах для того, чтобы прокачать вас. Одна из целей этого репозитория снизить барьер для разработки - открытого программного обеспечения (OSS). Решив эти задачи, вы поймете + открытого программного обеспечения (OSS). Решив эти задачи, вы поймете, как начать вносить свой вклад в любой другой проект с открытым исходным кодом. Изучение и использование нового фреймворка всегда сопряжено с трудностями. - В этом наборе испытаний содержатся реальные примеры задач, чтобы закрепить на практике то чему вы научились. + В этом наборе испытаний содержатся реальные примеры задач, чтобы закрепить на практике то, чему вы научились. Любой может оставить комментарий или предложить помощь. Учиться одному - здорово, но обучение вместе с другими поможет вам добиться большего. @@ -56,8 +56,8 @@ import MyIcon from '../../../components/MyIcon.astro'; - Это бесплатный проект и он будет оставаться таковым как можно дольше. - Однако вся работа ведется в мое свободное время, включая создание новых испытаний и ревью их решении(PRs). + Это бесплатный проект, и он будет оставаться таковым как можно дольше. + Однако вся работа ведется в мое свободное время, включая создание новых испытаний и ревью их решений(PRs). Спонсорство может поддержать меня и способствовать развитию проекта. From 71dbaea6c6913645b9503d5097f1d974ee6f1f0d Mon Sep 17 00:00:00 2001 From: Stanislav Gavrilov Date: Sun, 28 Jan 2024 12:35:11 +0300 Subject: [PATCH 11/11] feat: add russian lang for the content file --- docs/src/content/i18n/ru.json | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 docs/src/content/i18n/ru.json diff --git a/docs/src/content/i18n/ru.json b/docs/src/content/i18n/ru.json new file mode 100644 index 000000000..3974f45a5 --- /dev/null +++ b/docs/src/content/i18n/ru.json @@ -0,0 +1,22 @@ +{ + "page.title.challenge": "Испытание", + "author.createdBy": "Создано", + "buttons.star": "Дать звезду", + "buttons.sponsor": "Спонсор", + + "404.text": "Страница не найдена. Проверьте URL-адрес или воспользуйтесь строкой поиска.", + + "challenge.footer": { + "note": "Примечание", + "running": "Запустите проект, выполнив команду:", + "start": "Название вашего PR должно начинаться со слов", + "reminder": "Не забудьте", + "communityAnswers": "Решения сообщества", + "authorAnswer": "Решение автора", + "blogPost": "Статья", + "gettingStarted": { + "title": "Чтобы пройти это испытание, прочитайте:", + "link": "Первые шаги" + } + } +}