Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 19 additions & 13 deletions src/content/docs/zh-cn/basics/project-structure.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -31,14 +31,20 @@ Astro 为你的项目提供了一个有想法的文件夹布局。每个 Astro
- components/
- Header.astro
- Button.jsx
- content/
- config.ts
- posts/
- post1.md
- post2.md
- post3.md
- layouts/
- PostLayout.astro
- pages/
- posts/
- post1.md
- post2.md
- post3.md
- index.astro
- [post].astro
- about.astro
- **index.astro**
- rss.xml.js
- styles/
- global.css
- astro.config.mjs
Expand All @@ -65,6 +71,14 @@ Astro 处理、压缩和打包你的 `src/` 文件以创建最终传递到浏览
虽然本指南描述了 Astro 社区中使用的一些流行约定,但 Astro 保留的目录只有 `src/pages/` 和 `src/content/` 。你可以自由的以最适合自己的方式重命名和重新组织任何其他目录。
:::

### `src/pages`

[页面](/zh-cn/basics/astro-pages/)是一种用于创建新的页面的特殊组件。一个页面可以是一个 Astro 组件,也可以是表示站点某些页面内容的 Markdown 文件。

:::caution
`src/pages` 是 Astro 项目中**必须要有的**子目录。没有它,你的网站将没有任何页面或路径!
:::

### `src/components`

**组件**是你在 HTML 页面中可重复使用的代码单元。它可以是 [Astro 组件](/zh-cn/basics/astro-components/) 或是像 React 或 Vue 这样的[UI 框架组件](/zh-cn/guides/framework-components/)。通常将你项目中所有组件都分组放在这个文件夹中。
Expand All @@ -73,22 +87,14 @@ Astro 处理、压缩和打包你的 `src/` 文件以创建最终传递到浏览

### `src/content`

`src/content/` 目录是被保留用于存储内容集合和可选的集合配置文件。此文件夹中不允许有其他文件。
`src/content/` 目录是被保留用于存储内容集合和集合配置文件的。此文件夹中不允许有其他文件。

### `src/layouts`

[布局](/zh-cn/basics/layouts/)是定义一个或多个[页面](/zh-cn/basics/astro-pages/)共享的 UI 结构的 Astro 组件。

和 `src/components` 一样,这个目录也只是约定俗成,但不是必需的。

### `src/pages`

[页面](/zh-cn/basics/astro-pages/)是一种用于创建新的页面的特殊组件。一个页面可以是一个 Astro 组件,也可以是表示站点某些页面内容的 Markdown 文件。

:::caution
`src/pages` 是 Astro 项目中**必须要有的**子目录。没有它,你的网站将没有任何页面或路径!
:::

### `src/styles`

将 CSS 或 Sass 文件存储在 `src/styles` 目录中是一种常见的约定,但这不是必需的。只要你的样式位于 `src/` 目录中的某个位置并且正确导入,Astro 就会处理和压缩它们。
Expand Down