You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Ваш новый Astro-проект, созданный с помощью команды `create-astro`, уже включает в себя некоторые файлы и папки. Другие вы создадите сами и добавите в существующую файловую структуру.
8
+
Новый проект Astro, созданный с помощью команды `create-astro`, уже включает в себя необходимые файлы и папки. Вы можете дополнить уже существующую файловую структуру по своему усмотрению.
9
9
10
-
Ниже описано как Astro организован и какие файлы вы найдете в своем новом проекте.
10
+
Ниже описана структура Astro и основные файлы, которые можно обнаружить после создания нового проекта.
11
11
12
12
## Директории и Файлы
13
13
14
-
Astro использует определенную структуру папок для вашего проекта. Корневая папка каждого проекта на Astro должна включать следующие директории и файлы:
14
+
Astro использует определенную структуру папок. Корневая папка каждого проекта на Astro должна включать следующие директории и файлы:
15
15
16
-
-`src/*`— Исходный код вашего проекта (компоненты, страницы, стили, изображения и т.д.)
17
-
-`public/*`— Ваши статичные файлы, помимо кода (шрифты, иконки, и т.д.)
-[Изображения, для оптимизации и обработки с помощью Astro](/ru/guides/images/)
70
70
71
-
Astro обрабатывает, оптимизирует и объединяет в бандл ваши файлы из `src/`, чтобы создать окончательный сайт, который отправляется в браузер. В отличие от статической директории `public/`, файлы из `src/` собираются в билд и обрабатываются с помощью Astro.
71
+
Astro обрабатывает, оптимизирует и собирает файлы из `src/`, чтобы создать итоговый сайт, отправляемый в браузер. В отличие от статической директории `public/`, файлы из `src/` собираются в билд и обрабатываются с помощью Astro.
72
72
73
-
Некоторые файлы (например, Astro-компоненты) не отправляются в браузер в том виде, в котором они написаны, а вместо этого отображаются статическим HTML. Другие файлы (такие как CSS) отправляются в браузер, но могут быть оптимизированы или объединены в бандл с другими CSS-файлами для производительности.
73
+
Некоторые файлы (например, компоненты Astro) определяются браузером не в том виде, в котором написаны, а в качестве статического HTML. Другие файлы (такие как CSS) отправляются в браузер, но могут быть оптимизированы или объединены с другими CSS-файлами для производительности.
74
74
75
75
:::Tip
76
-
В этом руководстве описываются практики, которые общеприняты в сообществе Astro. Однако единственной зарезервированной директорией в Astro является `src/pages/`. Вы можете переименовывать любые другие директории и организовывать их так, как вам удобно.
76
+
В этом руководстве описываются практики, которые общеприняты в сообществе Astro. Единственной зарезервированной директорией в Astro является `src/pages/`. Любые другие директории вы можете переименовывать и организовывать так, как вам удобно.
77
77
:::
78
78
79
79
### `src/pages`
80
80
81
81
Чтобы задать маршруты страниц для вашего сайта, добавьте [файлы поддерживаемых типов](/ru/basics/astro-pages/#поддерживаемые-типы-файлов-страниц) в эту директорию.
82
82
83
83
:::Caution
84
-
`src/pages` – это **обязательная** под-директория в вашем Astro-проекте. Без нее на вашем сайте не будет страниц и маршрутов!
84
+
`src/pages` – это **обязательная** под-директория в проекте Astro. Без нее на сайте не будет страниц и маршрутов!
85
85
:::
86
86
87
87
### `src/components`
88
88
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. Принято добавлять и группировать все компоненты проекта в этой папке.
90
90
91
-
Это общепринятая практика для Astro-проектов, но она не является обязательной. Вы вольны организовывать компоненты своего проекта так, как вам удобно!
91
+
Это общепринятая практика для проектов Astro, но она не является обязательной. Вы вольны организовывать компоненты своего проекта так, как вам удобно!
92
92
93
93
### `src/layouts`
94
94
@@ -98,15 +98,15 @@ Astro обрабатывает, оптимизирует и объединяет
98
98
99
99
### `src/styles`
100
100
101
-
Общепринято хранить ваши CSS или Sass файлы в директории `src/styles`, но это не обязательно. Пока ваши стили находятся где-то внутри директории `src/` и правильно импортированы, Astro будет обрабатывать и оптимизировать их.
101
+
Общепринято хранить CSS или Sass файлы в директории `src/styles`, но это не обязательно. Пока файлы стилей находятся где-то внутри директории `src/` и импортированы правильно, Astro будет обрабатывать и оптимизировать их.
102
102
103
103
### `public/`
104
104
105
-
Директория `public/` предназначена для файлов и материалов в вашем проекте, которые Astro не должен обрабатывать во время сборки. Файлы в этой папке будут скопированы в папку сборки без изменений, после чего будет создан билд вашего сайт.
105
+
Директория `public/` предназначена для файлов и материалов в проекте, которые Astro не должен обрабатывать во время сборки. Файлы в этой папке будут скопированы в папку сборки без изменений, после чего будет создан билд сайта.
106
106
107
-
Это поведение делает `public/` идеальным местом для материалов, которые не нуждаются в обработке, например картинки и шрифты или специальные файлы, такие как `robots.txt` и `manifest.webmanifest`.
107
+
Это поведение делает `public/` идеальным местом для материалов, которые не нуждаются в обработке, например картинки, шрифты или специальные файлы, такие как `robots.txt` и `manifest.webmanifest`.
108
108
109
-
Вы можете поместить CSS и JavaScript в вашу директорию `public/`, но имейте в виду, что эти файлы не будут объединены в бандл или оптимизированы в вашей конечной сборке.
109
+
Вы можете поместить CSS и JavaScript в директорию `public/`, но имейте в виду, что эти файлы не будут объединены в бандл или оптимизированы в вашей конечной сборке.
110
110
111
111
:::tip
112
112
Как правило, любой CSS или JavaScript, который вы пишете самостоятельно, должен находиться в директории `src/`.
@@ -116,22 +116,22 @@ Astro обрабатывает, оптимизирует и объединяет
116
116
117
117
Это файл, используемый менеджерами пакетов JavaScript для управления зависимостями. Он также определяет скрипты, которые обычно используются для запуска Astro (например, `npm run dev`, `npm run build`).
118
118
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` только при наличии конкретной необходимости.
120
120
121
-
Чтобы создать новый файл `package.json`для вашего проекта, ознакомьтесь с инструкцией по [ручной установке](/ru/install-and-setup/#ручная-установка).
121
+
Чтобы создать новый файл `package.json`в проекте, ознакомьтесь с инструкцией по [ручной установке](/ru/install-and-setup/#ручная-установка).
122
122
123
123
### `astro.config.mjs`
124
124
125
-
Этот файл создается в каждом стартовом шаблоне и включает в себя параметры конфигурации для вашего проекта Astro. Здесь вы можете указать используемые интеграции, параметры сборки, параметры сервера и многое другое.
125
+
Этот файл создается в каждом стартовом шаблоне и включает в себя параметры конфигурации для проекта Astro. Здесь вы можете указать используемые интеграции, параметры сборки, параметры сервера и многое другое.
126
126
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.
128
128
129
-
Загрузка файла конфигурации на TypeScript обрабатывается с помощью [`tsm`](https://github.com/lukeed/tsm) и будет учитывать настройку `tsconfig`вашего проекта.
129
+
Загрузка файла конфигурации на TypeScript обрабатывается с помощью [`tsm`](https://github.com/lukeed/tsm) и будет учитывать настройку `tsconfig` проекта.
130
130
131
131
См. [Руководство по настройке Astro](/ru/reference/configuration-reference/) для детальной настройки.
132
132
133
133
### `tsconfig.json`
134
134
135
135
Этот файл создается в каждом стартовом шаблоне и включает параметры конфигурации TypeScript для вашего Astro-проекта. Некоторые функции (такие как импорт пакетов npm) не полностью поддерживаются в редакторе без файла `tsconfig.json`.
136
136
137
-
См. [Руководство по TypeScript](/ru/guides/typescript/)для деталей по настройке конфигурации.
137
+
См. [Руководство по TypeScript](/ru/guides/typescript/)чтобы узнать подробнее о настройке конфигурации.
0 commit comments