Skip to content

Commit d3b969f

Browse files
Update ru lang project-structure.mdx (#13846)
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
1 parent 9d30f99 commit d3b969f

1 file changed

Lines changed: 29 additions & 29 deletions

File tree

src/content/docs/ru/basics/project-structure.mdx

Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,27 @@
11
---
22
title: Структура проекта
3-
description: Введение в основы файловой структуры Astro-проекта.
3+
description: Введение в файловую структуру проекта Astro.
44
i18nReady: true
55
---
66
import { FileTree } from '@astrojs/starlight/components';
77

8-
Ваш новый Astro-проект, созданный с помощью команды `create-astro`, уже включает в себя некоторые файлы и папки. Другие вы создадите сами и добавите в существующую файловую структуру.
8+
Новый проект Astro, созданный с помощью команды `create-astro`, уже включает в себя необходимые файлы и папки. Вы можете дополнить уже существующую файловую структуру по своему усмотрению.
99

10-
Ниже описано как Astro организован и какие файлы вы найдете в своем новом проекте.
10+
Ниже описана структура Astro и основные файлы, которые можно обнаружить после создания нового проекта.
1111

1212
## Директории и Файлы
1313

14-
Astro использует определенную структуру папок для вашего проекта. Корневая папка каждого проекта на Astro должна включать следующие директории и файлы:
14+
Astro использует определенную структуру папок. Корневая папка каждого проекта на Astro должна включать следующие директории и файлы:
1515

16-
- `src/*` Исходный код вашего проекта (компоненты, страницы, стили, изображения и т.д.)
17-
- `public/*` — Ваши статичные файлы, помимо кода (шрифты, иконки, и т.д.)
18-
- `package.json` Манифест проекта.
19-
- `astro.config.mjs` Файл конфигурации Astro. (рекомендован)
20-
- `tsconfig.json` Файл конфигурации TypeScript. (рекомендован)
16+
- `src/*` - Исходный код проекта (компоненты, страницы, стили, изображения и т.д.)
17+
- `public/*` - Статичные файлы, не являющиеся кодом (шрифты, иконки, и т.д.)
18+
- `package.json` - Манифест проекта.
19+
- `astro.config.mjs` - Файл конфигурации Astro. (рекомендуется)
20+
- `tsconfig.json` - Файл конфигурации TypeScript. (рекомендуется)
2121

2222
### Пример дерева проекта
2323

24-
Структура простого Astro проекта может выглядеть так:
24+
Структура простого проекта Astro может выглядеть так:
2525

2626
<FileTree>
2727
- public/
@@ -58,37 +58,37 @@ Astro использует определенную структуру папо
5858

5959
### `src/`
6060

61-
Папка `src/` это место где живет большая часть вашего исходного кода. Здесь находятся:
61+
Папка `src/` - это место, где расположена большая часть исходного кода. Здесь находятся:
6262

6363
- [Страницы](/ru/basics/astro-pages/)
6464
- [Макеты](/ru/basics/layouts/)
65-
- [Astro компоненты](/ru/basics/astro-components/)
65+
- [Компоненты Astro](/ru/basics/astro-components/)
6666
- [Компоненты UI-фреймворков (React и т.д.)](/ru/guides/framework-components/)
6767
- [Стили (CSS, Sass)](/ru/guides/styling/)
68-
- [Markdown](/ru/guides/markdown-content/)
68+
- [Разметка Markdown](/ru/guides/markdown-content/)
6969
- [Изображения, для оптимизации и обработки с помощью Astro](/ru/guides/images/)
7070

71-
Astro обрабатывает, оптимизирует и объединяет в бандл ваши файлы из `src/`, чтобы создать окончательный сайт, который отправляется в браузер. В отличие от статической директории `public/`, файлы из `src/` собираются в билд и обрабатываются с помощью Astro.
71+
Astro обрабатывает, оптимизирует и собирает файлы из `src/`, чтобы создать итоговый сайт, отправляемый в браузер. В отличие от статической директории `public/`, файлы из `src/` собираются в билд и обрабатываются с помощью Astro.
7272

73-
Некоторые файлы (например, Astro-компоненты) не отправляются в браузер в том виде, в котором они написаны, а вместо этого отображаются статическим HTML. Другие файлы (такие как CSS) отправляются в браузер, но могут быть оптимизированы или объединены в бандл с другими CSS-файлами для производительности.
73+
Некоторые файлы (например, компоненты Astro) определяются браузером не в том виде, в котором написаны, а в качестве статического HTML. Другие файлы (такие как CSS) отправляются в браузер, но могут быть оптимизированы или объединены с другими CSS-файлами для производительности.
7474

7575
:::Tip
76-
В этом руководстве описываются практики, которые общеприняты в сообществе Astro. Однако единственной зарезервированной директорией в Astro является `src/pages/`. Вы можете переименовывать любые другие директории и организовывать их так, как вам удобно.
76+
В этом руководстве описываются практики, которые общеприняты в сообществе Astro. Единственной зарезервированной директорией в Astro является `src/pages/`. Любые другие директории вы можете переименовывать и организовывать так, как вам удобно.
7777
:::
7878

7979
### `src/pages`
8080

8181
Чтобы задать маршруты страниц для вашего сайта, добавьте [файлы поддерживаемых типов](/ru/basics/astro-pages/#поддерживаемые-типы-файлов-страниц) в эту директорию.
8282

8383
:::Caution
84-
`src/pages` – это **обязательная** под-директория в вашем Astro-проекте. Без нее на вашем сайте не будет страниц и маршрутов!
84+
`src/pages` – это **обязательная** под-директория в проекте Astro. Без нее на сайте не будет страниц и маршрутов!
8585
:::
8686

8787
### `src/components`
8888

89-
**Компоненты** - это повторяющиеся блоки кода для ваших HTML-страниц. Это могут быть [компоненты Astro](/ru/basics/astro-components/) или [компоненты UI-фреймворка](/ru/guides/framework-components/) такие как React или Vue. Обычно принято группировать и упорядочивать все компоненты вашего проекта в этой папке.
89+
**Компоненты** - это повторяющиеся блоки кода для HTML-страниц. Это могут быть [компоненты Astro](/ru/basics/astro-components/) или [компоненты UI-фреймворков](/ru/guides/framework-components/) таких как React или Vue. Принято добавлять и группировать все компоненты проекта в этой папке.
9090

91-
Это общепринятая практика для Astro-проектов, но она не является обязательной. Вы вольны организовывать компоненты своего проекта так, как вам удобно!
91+
Это общепринятая практика для проектов Astro, но она не является обязательной. Вы вольны организовывать компоненты своего проекта так, как вам удобно!
9292

9393
### `src/layouts`
9494

@@ -98,15 +98,15 @@ Astro обрабатывает, оптимизирует и объединяет
9898

9999
### `src/styles`
100100

101-
Общепринято хранить ваши CSS или Sass файлы в директории `src/styles`, но это не обязательно. Пока ваши стили находятся где-то внутри директории `src/` и правильно импортированы, Astro будет обрабатывать и оптимизировать их.
101+
Общепринято хранить CSS или Sass файлы в директории `src/styles`, но это не обязательно. Пока файлы стилей находятся где-то внутри директории `src/` и импортированы правильно, Astro будет обрабатывать и оптимизировать их.
102102

103103
### `public/`
104104

105-
Директория `public/` предназначена для файлов и материалов в вашем проекте, которые Astro не должен обрабатывать во время сборки. Файлы в этой папке будут скопированы в папку сборки без изменений, после чего будет создан билд вашего сайт.
105+
Директория `public/` предназначена для файлов и материалов в проекте, которые Astro не должен обрабатывать во время сборки. Файлы в этой папке будут скопированы в папку сборки без изменений, после чего будет создан билд сайта.
106106

107-
Это поведение делает `public/` идеальным местом для материалов, которые не нуждаются в обработке, например картинки и шрифты или специальные файлы, такие как `robots.txt` и `manifest.webmanifest`.
107+
Это поведение делает `public/` идеальным местом для материалов, которые не нуждаются в обработке, например картинки, шрифты или специальные файлы, такие как `robots.txt` и `manifest.webmanifest`.
108108

109-
Вы можете поместить CSS и JavaScript в вашу директорию `public/`, но имейте в виду, что эти файлы не будут объединены в бандл или оптимизированы в вашей конечной сборке.
109+
Вы можете поместить CSS и JavaScript в директорию `public/`, но имейте в виду, что эти файлы не будут объединены в бандл или оптимизированы в вашей конечной сборке.
110110

111111
:::tip
112112
Как правило, любой CSS или JavaScript, который вы пишете самостоятельно, должен находиться в директории `src/`.
@@ -116,22 +116,22 @@ Astro обрабатывает, оптимизирует и объединяет
116116

117117
Это файл, используемый менеджерами пакетов JavaScript для управления зависимостями. Он также определяет скрипты, которые обычно используются для запуска Astro (например, `npm run dev`, `npm run build`).
118118

119-
Вы можете указать [два вида зависимостей](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file) в файле `package.json`: `dependencies` и `devDependencies`. В большинстве случаев они работают одинаково: Astro нуждается во всех зависимостях на этапе сборки, и ваш менеджер пакетов установит оба. Мы рекомендуем поместить все зависимости в `dependencies` для начала, и использовать `devDependencies` только при наличии конкретной необходимости.
119+
Вы можете указать [два вида зависимостей](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file) в файле `package.json`: `dependencies` и `devDependencies`. В большинстве случаев они работают одинаково: Astro нуждается во всех зависимостях на этапе сборки, и ваш менеджер пакетов установит оба. Рекомендуется поместить все зависимости в `dependencies` для начала, и использовать `devDependencies` только при наличии конкретной необходимости.
120120

121-
Чтобы создать новый файл `package.json` для вашего проекта, ознакомьтесь с инструкцией по [ручной установке](/ru/install-and-setup/#ручная-установка).
121+
Чтобы создать новый файл `package.json` в проекте, ознакомьтесь с инструкцией по [ручной установке](/ru/install-and-setup/#ручная-установка).
122122

123123
### `astro.config.mjs`
124124

125-
Этот файл создается в каждом стартовом шаблоне и включает в себя параметры конфигурации для вашего проекта Astro. Здесь вы можете указать используемые интеграции, параметры сборки, параметры сервера и многое другое.
125+
Этот файл создается в каждом стартовом шаблоне и включает в себя параметры конфигурации для проекта Astro. Здесь вы можете указать используемые интеграции, параметры сборки, параметры сервера и многое другое.
126126

127-
Astro поддерживает несколько форматов файлов конфигурации JavaScript: `astro.config.js`, `astro.config.mjs` и `astro.config.ts`. В большинстве случаев мы рекомендуем использовать `.mjs`, либо `.ts` если вы хотите писать конфигурации на TypeScript.
127+
Astro поддерживает несколько форматов файлов конфигурации JavaScript: `astro.config.js`, `astro.config.mjs` и `astro.config.ts`. В большинстве случаев рекомендуется использовать `.mjs`, либо `.ts` если вы хотите писать конфигурации на TypeScript.
128128

129-
Загрузка файла конфигурации на TypeScript обрабатывается с помощью [`tsm`](https://github.com/lukeed/tsm) и будет учитывать настройку `tsconfig` вашего проекта.
129+
Загрузка файла конфигурации на TypeScript обрабатывается с помощью [`tsm`](https://github.com/lukeed/tsm) и будет учитывать настройку `tsconfig` проекта.
130130

131131
См. [Руководство по настройке Astro](/ru/reference/configuration-reference/) для детальной настройки.
132132

133133
### `tsconfig.json`
134134

135135
Этот файл создается в каждом стартовом шаблоне и включает параметры конфигурации TypeScript для вашего Astro-проекта. Некоторые функции (такие как импорт пакетов npm) не полностью поддерживаются в редакторе без файла `tsconfig.json`.
136136

137-
См. [Руководство по TypeScript](/ru/guides/typescript/) для деталей по настройке конфигурации.
137+
См. [Руководство по TypeScript](/ru/guides/typescript/) чтобы узнать подробнее о настройке конфигурации.

0 commit comments

Comments
 (0)