From ab990b220472fb50074985059513528c72cb4c29 Mon Sep 17 00:00:00 2001 From: Paul Mineev Date: Tue, 12 Oct 2021 20:03:25 +0300 Subject: [PATCH] [docs/ru] add translation for quick start (#1524) * [ru] add translation for quick start * fix mistakes --- docs/src/config.ts | 1 + docs/src/pages/ru/getting-started.md | 2 +- docs/src/pages/ru/quick-start.md | 72 ++++++++++++++++++++++++++++ 3 files changed, 74 insertions(+), 1 deletion(-) create mode 100644 docs/src/pages/ru/quick-start.md diff --git a/docs/src/config.ts b/docs/src/config.ts index 07ff18d47..597ecb796 100644 --- a/docs/src/config.ts +++ b/docs/src/config.ts @@ -139,6 +139,7 @@ export const SIDEBAR = { ru: [ { text: 'Введение', header: true }, { text: 'Начало работы', link: 'ru/getting-started' }, + { text: 'Быстрый старт', link: 'ru/quick-start' }, ], }; diff --git a/docs/src/pages/ru/getting-started.md b/docs/src/pages/ru/getting-started.md index 342ba1931..5f43b083a 100644 --- a/docs/src/pages/ru/getting-started.md +++ b/docs/src/pages/ru/getting-started.md @@ -9,7 +9,7 @@ Astro – это современный сборщик статических с Самый простой способ попробовать Astro — запустить команду `npm init astro` в новой директории на вашем компьютере. Наш CLI установщик поможет вам в разворачивании нового проекта на Astro. -Для быстрого старта с Astro в 5 простых шагов, посетите страницу руководства по [быстрому старту](quick-start). +Для быстрого старта с Astro в 5 простых шагов, посетите страницу руководства по [быстрому старту](ru/quick-start). Также вы можете развернуть проект с помощью [руководства по установке](/installation), которое пошагово проведёт через процесс разворачивания проекта с Astro. diff --git a/docs/src/pages/ru/quick-start.md b/docs/src/pages/ru/quick-start.md new file mode 100644 index 000000000..586a8da1d --- /dev/null +++ b/docs/src/pages/ru/quick-start.md @@ -0,0 +1,72 @@ +--- +layout: ~/layouts/MainLayout.astro +title: Быстрый старт +--- + +```shell +# Заметка: проверьте, что у вас установлена Node.js версии 12.20.0+, 14.13.1+, или 16+ +node --version + +# Создайте новую директорию и перейдите в неё +mkdir my-astro-project && cd $_ + +# подготовка к запуску... +npm init astro + +# установка зависимостей +npm install + +# начинаем разработку! +npm run dev + +# когда все готово: запустите сборку вашего статического сайта в директорию `dist/` +npm run build +``` + +Чтобы узнать больше об установке и использовании Astro, пожалуйста, [прочитайте нашу инструкцию по установке.](installation) + +Если вы предпочитаете обучаться по примерам, обратите внимание на [нашу библиотеку примеров](https://github.com/snowpackjs/astro/tree/main/examples) на GitHub. Вы можете развернуть любой из примеров локально, запустив команду `npm init astro -- --template "EXAMPLE_NAME"`. + +## Запуск вашего проекта + +Находясь в директории проекта запустите команду ниже в терминале: + +```bash +npm run dev +``` + +Astro запустит сервер для разработки по адресу [http://localhost:3000](http://localhost:3000). При открытии этого URL в вашем браузере, вы должны увидеть "Hello, World" от Astro. + +Сервер будет следить за изменениями в директории `src/`, значит вам не нужно будет перезапускать сервер каждый раз после внесения изменений. + +## Сборка проекта + +Чтобы собрать ваш проект, находясь в директории проекта, введите и запустите следующую команду в терминале: + +```bash +npm run build +``` + +Эта команда запустит процесс сборки и сохранит собранный сайт на диск. После выполнения ваш сайт будет находиться в директории `dist/`. + +## Деплой вашего сайта + +Сайты, созданные с помощью Astro, являются статичными. Это значит, что они могут быть размещены на любом из хостингов, который вы предпочитаете: + +- [AWS S3 bucket](https://aws.amazon.com/s3/) +- [Google Firebase](https://firebase.google.com/) +- [Netlify](https://www.netlify.com/) +- [Vercel](https://vercel.com/) +- [Читайте больше о деплое сайтов, собранных с помощью Astro, в нашем руководстве по деплою.](/guides/deploy) + +## Следующие шаги + +Ура! Теперь вы готовы к разработке! + +Мы рекомендуем вам потратить немного времени, чтобы познакомиться с работой Astro ближе. Вы можете сделать это с помощью дальнейшего ознакомления с документацией. Мы советуем изучить следующие материалы: + +📚 Узнать больше [о структуре проектов Astro.](/core-concepts/project-structure) + +📚 Узнать больше [о синтаксисе компонентов Astro.](/core-concepts/astro-components) + +📚 Узнать больше [о роутинге, основанном на файловой структуре.](core-concepts/astro-pages)