Skip to content

Commit

Permalink
feat(docs) Перевод текстов Deploy
Browse files Browse the repository at this point in the history
  • Loading branch information
Ivan Bochkarev committed Jun 3, 2024
1 parent ad918fb commit 27fe3a4
Show file tree
Hide file tree
Showing 20 changed files with 383 additions and 373 deletions.
40 changes: 20 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,69 +1,69 @@
<a href="https://nuxt.com"><img width="1200" alt="Nuxt Website" src="https://github.com/nuxt/nuxt.com/assets/904724/22772d8b-4fff-4cf9-a592-85c5ff5d6d58"></a>

# nuxt.com
# <https://nuxt-ru.vercel.app>

Welcome to the Nuxt website repository available on [nuxt.com](https://nuxt.com).
Добро пожаловать на сайт-репозиторий Nuxt, доступный по адресу [https://nuxt-ru.vercel.app](https://nuxt-ru.vercel.app).

[![Nuxt UI Pro](https://img.shields.io/badge/Made%20with-Nuxt%20UI%20Pro-00DC82?logo=nuxt.js&labelColor=020420)](https://ui.nuxt.com/pro)

## Setup
## Настройка

Make sure to install the dependencies
Убедитесь в том, что установили зависимости

```bash
pnpm install
```

Copy the `.env.example` file to `.env`:
Скопируйте файл `.env.example` в файл `.env`:

```bash
cp .env.example .env
```

Clone/Fork [nuxt/nuxt](https://github.com/nuxt/nuxt) repo where you want (but not in the Nuxt.com project) and inside the `docs/` directory, run:
Клон/форк [translation-gang/nuxt](https://github.com/translation-gang/nuxt) репо в нужном вам месте (но не в проекте Nuxt.com) и внутри директории `docs/`, запустите:

```bash
pwd
```

If you are on Windows, you can use the following command instead:
Если вы работаете под Windows, вместо этого можно использовать следующую команду:

```bash
echo %cd%
```

Copy the output of the command above and paste it in the `NUXT_DOCS_PATH` variable in the `.env` file.
Скопируйте вывод команды выше и вставьте его в переменную `NUXT_DOCS_PATH` в файле `.env`.

## Development
## Разработка

Start the development server:
Запустите сервер разработки:

```bash
npm run dev
```

### Add a Nuxt Template
### Добавьте шаблон Nuxt

To list a Nuxt template, add it to the list on [./content/4.templates.yml](./content/4.templates.yml).
Чтобы добавить шаблон Nuxt в список, добавьте его в список на странице [./content/4.templates.yml](./content/4.templates.yml).

Make sure to start the development server in order to generate the screenshot for the template and go to http://localhost:3000/templates to see the result.
Обязательно запустите сервер разработки, чтобы сгенерировать скриншот для шаблона, и перейдите по адресу <http://localhost:3000/templates>, чтобы увидеть результат.

If you want to update the url where we take the automated screenshot, use the `screenshotUrl` property.
Если вы хотите обновить url, по которому мы делаем автоматический скриншот, используйте свойство `screenshotUrl`.

To regenerate the image, delete the generated one in `public/assets/templates`.
Чтобы сгенерировать изображение заново, удалите сгенерированное в папке `public/assets/templates`.

## Production
## Продакшен

In order to build the application for production, you need to have a [Nuxt UI Pro](https://ui.nuxt.com/pro) license and set the `NUXT_UI_PRO_LICENSE` variable in the `.env` file.
Для того чтобы собрать приложение для продакшена, вам необходимо иметь лицензию [Nuxt UI Pro](https://ui.nuxt.com/pro) и установить переменную `NUXT_UI_PRO_LICENSE` в файле `.env`.

Note that this is not required to run in development and contribute to the Nuxt website or documentation.
Обратите внимание, что это не требуется для запуска в разработке и внесения вклада на сайт Nuxt или в документацию.

Build the application for production:
Соберите приложение для производства:

```bash
npm run generate
```

## License
## Лицензия

[MIT License](./LICENSE)
28 changes: 14 additions & 14 deletions content/3.deploy/aws-amplify.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,34 @@
---
title: AWS Amplify
description: 'Deploy your Nuxt Application to AWS Amplify infrastructure.'
description: 'Разверните ваше приложение Nuxt на AWS Amplify инфраструктуре.'
componentImg: Amplify
logoIcon: 'i-logos-aws-amplify'
category: Hosting
category: Хостинг
nitroPreset: 'aws-amplify'
website: 'https://aws.amazon.com/amplify/?trk=bed847b4-6e9f-4e09-ba09-0d4680a0447b&sc_channel=el'
---

::tip
**Zero Configuration**
**Нулевая конфигурация**
:br
Integration with AWS Amplify is possible with zero configuration, [learn more](https://nitro.unjs.io/deploy#zero-config-providers).
Интеграция с AWS Amplify возможна с нулевой конфигурацией, [узнать больше](https://nitro.unjs.io/deploy#zero-config-providers).
::

## Setup
## Настройка

1. Login to the [AWS Amplify Hosting Console](https://console.aws.amazon.com/amplify/?trk=01c5a476-5997-4e6a-88b9-fd0a0a5bbe34&sc_channel=el)
2. Click on "Get Started" > Amplify Hosting (Host your web app)
3. Select and authorize access to your Git repository provider and select the main branch
4. Choose a name for your app, make sure build settings are auto-detected and optionally set requirement environment variables under the advanced section
5. Optionally, select Enable SSR logging to enable server-side logging to your Amazon CloudWatch account
6. Confirm configuration and click on "Save and Deploy"
1. Войдите в [AWS Amplify Hosting Console](https://console.aws.amazon.com/amplify/?trk=01c5a476-5997-4e6a-88b9-fd0a0a5bbe34&sc_channel=el).
2. Нажмите «Начать» > Amplify Hosting (размещение вашего веб-приложения).
3. Выберите и авторизуйте доступ к вашему провайдеру репозитория Git и выберите основную ветку.
4. Выберите имя для приложения, убедитесь, что настройки сборки автоматически определяются, и установите переменные среды требований в разделе «Дополнительно».
5. В качестве опции выберите Enable SSR logging, чтобы включить ведение журнала на стороне сервера в вашем аккаунте Amazon CloudWatch.
6. Подтвердите конфигурацию и нажмите «Сохранить и развернуть».

## Learn more
## Узнать больше

::read-more{to="https://www.youtube.com/watch?v=CAk5_XGkOG4" target="_blank"}
Watch an Amplify Hosting tutorial with Nuxt
Посмотрите руководство по хостингу Amplify Hosting с помощью Nuxt
::

::read-more{to="https://nitro.unjs.io/deploy/providers/aws-amplify" target="_blank"}
Head over **Nitro documentation** to learn more about the aws-amplify deployment preset.
Перейдите по ссылке **Документация Nitro**, чтобы узнать больше о предустановке развертывания aws-amplify.
::
60 changes: 30 additions & 30 deletions content/3.deploy/azure.md
Original file line number Diff line number Diff line change
@@ -1,50 +1,50 @@
---
title: Azure
description: 'Deploy your Nuxt Application to Azure infrastructure.'
description: 'Разверните ваше приложение Nuxt на Azure инфраструктуре.'
logoIcon: 'i-logos-azure-icon'
category: Hosting
category: Хостинг
nitroPreset: 'azure'
website: 'https://azure.microsoft.com/en-us/services/app-service/static/'
---

## Azure Static Web Apps

::tip
**Zero Configuration**
**Нулевая конфигурация**
:br
Integration with Azure Static Web Apps provider is possible with zero configuration, [learn more](https://nitro.unjs.io/deploy#zero-config-providers).
Интеграция с провайдером Azure Static Web Apps возможна с нулевой настройкой, [подробнее](https://nitro.unjs.io/deploy#zero-config-providers).
::

Azure Static Web Apps are designed to be deployed continuously in a [GitHub Actions workflow](https://docs.microsoft.com/en-us/azure/static-web-apps/github-actions-workflow). By default, Nuxt will detect this deployment environment to enable the `azure` preset.
Статические веб-приложения Azure предназначены для постоянного развертывания в рамках рабочего процесса [GitHub Actions](https://docs.microsoft.com/en-us/azure/static-web-apps/github-actions-workflow). По умолчанию Nuxt определяет эту среду развертывания, чтобы включить предустановку `azure`.

### Local preview
### Локальный предварительный просмотр

Install [Azure Functions Core Tools](https://docs.microsoft.com/en-us/azure/azure-functions/functions-run-local) if you want to test locally.
Установите [Azure Functions Core Tools](https://docs.microsoft.com/en-us/azure/azure-functions/functions-run-local), если хотите протестировать локально.

You can invoke a development environment to preview before deploying.
Вы можете вызвать среду разработки для предварительного просмотра перед развертыванием.

```bash [Terminal]
npx nuxi build --preset=azure
npx @azure/static-web-apps-cli start .output/public --api-location .output/server
```

### Configuration
### Конфигурация

Azure Static Web Apps are [configured](https://learn.microsoft.com/en-us/azure/static-web-apps/configuration) using the `staticwebapp.config.json` file.
Статические веб-приложения Azure [настраиваются](https://learn.microsoft.com/en-us/azure/static-web-apps/configuration) с помощью файла `staticwebapp.config.json`.

Nuxt automatically generates this configuration file whenever the application is built with the `azure` preset.
Nuxt автоматически генерирует этот конфигурационный файл, когда приложение собирается с предустановкой `azure`.

It adds the following properties based on the following criteria:
Он добавляет следующие свойства, основываясь на следующих критериях:

| Property | Criteria | Default |
| Свойство | Критерии | По умолчанию |
| --- | --- | --- |
| **[platform.apiRuntime](https://learn.microsoft.com/en-us/azure/static-web-apps/configuration#platform)** | Will automatically set to `node:16` or `node:14` depending on your package configuration. | `node:16` |
| **[navigationFallback.rewrite](https://learn.microsoft.com/en-us/azure/static-web-apps/configuration#fallback-routes)** | Is always `/api/server` | `/api/server` |
| **[routes](https://learn.microsoft.com/en-us/azure/static-web-apps/configuration#routes)** | All prerendered routes are added. Additionally, if you do not have an `index.html` file an empty one is created for you for compatibility purposes and also requests to `/index.html` are redirected to the root directory which is handled by `/api/server`. | `[]` |
| **[platform.apiRuntime](https://learn.microsoft.com/en-us/azure/static-web-apps/configuration#platform)** | Будет автоматически установлен на `node:16` или `node:14` в зависимости от конфигурации вашего пакета. | `node:16` |
| **[navigationFallback.rewrite](https://learn.microsoft.com/en-us/azure/static-web-apps/configuration#fallback-routes)** | Всегда `/api/server` | `/api/server` |
| **[routes](https://learn.microsoft.com/en-us/azure/static-web-apps/configuration#routes)** | Добавляются все пререндеренные маршруты. Кроме того, если у вас нет файла `index.html`, то в целях совместимости будет создан пустой файл, а также запросы к `/index.html` будут перенаправлены в корневой каталог, который обрабатывается `/api/server`. | `[]` |

### Custom Configuration
### Пользовательская конфигурация

You can alter the generated configuration using `azure.config` option. For instance, if you wanted to specify a Node runtime for your Azure Functions, edit your `nuxt.config.ts` file to the following:
Вы можете изменить сгенерированную конфигурацию с помощью опции `azure.config`. Например, если вы хотите указать время выполнения Node для ваших Azure Functions, измените файл `nuxt.config.ts` следующим образом:

```ts [nuxt.config.ts]
export default defineNuxtConfig({
Expand All @@ -62,38 +62,38 @@ export default defineNuxtConfig({
})
```

Custom routes will be added and matched first. In the case of a conflict (determined if an object has the same route property), custom routes will override generated ones.
Пользовательские маршруты будут добавлены и сопоставлены первыми. В случае конфликта (определяется, если объект имеет одинаковое свойство route) пользовательские маршруты будут преобладать над сгенерированными.

### Deploy from CI/CD via GitHub Actions
### Развертывание с помощью CI/CD через GitHub Actions

When you link your GitHub repository to Azure Static Web Apps, a workflow file is added to the repository.
Когда вы связываете свой репозиторий GitHub с Azure Static Web Apps, в репозиторий добавляется файл воркфлоу.

When you are asked to select your framework, select custom and provide the following information:
Когда вам будет предложено выбрать фреймворк, выберите пользовательский и укажите следующую информацию:

| Input | Value |
| Входные данные | Значение |
| --- | --- |
| **app_location** | '/' |
| **api_location** | '.output/server' |
| **output_location** | '.output/public' |

If you miss this step, you can always find the build configuration section in your workflow and update the build configuration:
Если вы пропустите этот шаг, вы всегда можете найти раздел конфигурации сборки в своем рабочем процессе и обновить конфигурацию сборки:

```yaml [.github/workflows/azure-static-web-apps-<RANDOM_NAME>.yml]
###### Repository/Build Configurations ######
###### Конфигурация репозитория/сборкии ######
app_location: '/'
api_location: '.output/server'
output_location: '.output/public'
###### End of Repository/Build Configurations ######
###### Завершение конфигурации репозитория/сборки ######
```

::alert
That's it! Now Azure Static Web Apps will automatically deploy your Nitro-powered application on push.
Вот и все! Теперь Azure Static Web Apps будет автоматически разворачивать ваше приложение на базе Nitro в режиме push.
::

If you are using `runtimeConfig`, you will likely want to configure the corresponding [environment variables on Azure](https://docs.microsoft.com/en-us/azure/static-web-apps/application-settings).
Если вы используете `runtimeConfig`, вам, скорее всего, потребуется настроить соответствующие [переменные окружения в Azure](https://docs.microsoft.com/en-us/azure/static-web-apps/application-settings).

## More options
## Дополнительные параметры

::read-more{to="https://nitro.unjs.io/deploy/providers/azure" target="_blank"}
Learn about the other Azure deployment presets on Nitro documentation.
Узнайте о других предустановках развертывания Azure в документации Nitro.
::
26 changes: 13 additions & 13 deletions content/3.deploy/cleavr.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,31 @@
---
title: Cleavr
description: 'Deploy your Nuxt Application to Cleavr infrastructure.'
description: 'Разверните ваше приложение Nuxt на Cleavr инфраструктуре.'
logoSrc: '/assets/integrations/cleavr.svg'
category: Hosting
category: Хостинг
nitroPreset: 'cleavr'
website: 'https://cleavr.io/'
---

::tip
**Zero Configuration**
**Нулевая конфигурация**
:br
Integration with this provider is possible with zero configuration, [learn more](https://nitro.unjs.io/deploy#zero-config-providers).
Интеграция с этим провайдером возможна с нулевой конфигурацией, [узнать больше](https://nitro.unjs.io/deploy#zero-config-providers).
::

## Setup
## Настройка

**In your [Cleavr.io](https://cleavr.io/) panel:**
**В вашей панели [Cleavr.io](https://cleavr.io/):**

1. Provision a new server
2. Add a website, selecting **Nuxt 3** as the app type
3. In web app > settings > Code Repo, point to your project's code repository
4. In web app > settings > Environment variables, set `SERVER_PRESET=cleavr`
1. Создайте новый сервер
2. Добавьте веб-сайт, выбрав в качестве типа приложения **Nuxt 3**.
3. В веб-приложении > настройки > Code Repo укажите на репозиторий кода вашего проекта.
4. В веб-приложении > настройки > переменные окружения установите `SERVER_PRESET=cleavr`.

You're now all set to deploy your project!
Теперь вы готовы к развертыванию проекта!

## Learn more
## Узнать больше

::read-more{to="https://nitro.unjs.io/deploy/providers/cleavr" target="_blank"}
Head over **Nitro documentation** to learn more about the cleavr deployment preset.
Перейдите по ссылке **Документация Nitro**, чтобы узнать больше о предустановке развертывания cleavr.
::
Loading

0 comments on commit 27fe3a4

Please sign in to comment.