Skip to content

Commit

Permalink
Merge branch 'main' into zhcn/auth-content
Browse files Browse the repository at this point in the history
  • Loading branch information
HiDeoo authored Dec 1, 2023
2 parents 412a7fe + dc6d1d7 commit 3f3b37f
Showing 1 changed file with 8 additions and 9 deletions.
17 changes: 8 additions & 9 deletions docs/src/content/docs/zh-cn/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,14 @@ description: 了解如何使用 Astro 的 Starlight 开始构建下一个文档
import { Tabs, TabItem } from '@astrojs/starlight/components';

Starlight 是一个基于 [Astro](https://astro.build) 框架构建的全功能文档主题。
查看 [手动配置](/zh-cn/manual-setup/) 以将Starlight添加到现有的Astro项目中。
这个指南将帮助你开始一个新项目。
查看[手动配置](/zh-cn/manual-setup/)以将 Starlight 添加到现有的 Astro 项目中。

## 快速入门

### 创建一个新项目

在你的终端中运行以下命令来创建一个新的Astro + Starlight项目
在你的终端中运行以下命令来创建一个新的 Astro + Starlight 项目

<Tabs>
<TabItem label="npm">
Expand All @@ -39,7 +39,7 @@ yarn create astro --template starlight
</TabItem>
</Tabs>

这将创建一个新的 [项目目录](/zh-cn/guides/project-structure/),其中包含你网站所需的所有文件和配置。
这将创建一个新的[项目目录](/zh-cn/guides/project-structure/),其中包含你网站所需的所有文件和配置。

:::tip[查看实际效果]
在浏览器中尝试 Starlight:
Expand All @@ -48,7 +48,7 @@ yarn create astro --template starlight

### 启动开发服务器

在本地工作时,[Astro的开发服务器](https://docs.astro.build/zh-cn/reference/cli-reference/#astro-dev)允许你预览你的工作,并在你进行更改时自动刷新你的浏览器。
在本地工作时,[Astro 的开发服务器](https://docs.astro.build/zh-cn/reference/cli-reference/#astro-dev)使你能预览你的工作,并在你进行更改时自动刷新你的浏览器。

在你的项目目录中,运行以下命令来启动开发服务器:

Expand Down Expand Up @@ -81,12 +81,12 @@ yarn dev

### 添加内容

Starlight已经准备好让你添加新内容或导入你现有的文件
Starlight 已经准备好让你添加新内容或导入你现有的文件

#### 文件格式

Starlight支持在Markdown和MDX中编写内容,无需进行任何配置。
你可以通过安装实验性的[Astro Markdoc](https://docs.astro.build/zh-cn/guides/integrations-guide/markdoc/)集成来添加对Markdoc的支持
Starlight 支持使用 Markdown 和 MDX 编写内容,无需进行任何配置。
你可以通过安装实验性的 [Astro Markdoc 集成](https://docs.astro.build/zh-cn/guides/integrations-guide/markdoc/)来添加对 Markdoc 的支持

#### 添加页面

Expand Down Expand Up @@ -126,7 +126,7 @@ description: This is a page in my Starlight-powered site
- **配置:**[自定义 Starlight](/zh-cn/guides/customization/)中了解常见选项。
- **导航:** 使用[侧边栏导航](/zh-cn/guides/sidebar/)指南设置你的侧边栏。
- **组件:**[组件](/zh-cn/guides/components/)指南中发现内置的卡片、标签页等更多内容。
- **部署:** 使用Astro文档中的[部署你的 Astro 站点](https://docs.astro.build/zh-cn/guides/deploy/)指南发布你的站点。
- **部署:** 使用 Astro 文档中的[部署你的 Astro 站点](https://docs.astro.build/zh-cn/guides/deploy/)指南发布你的站点。

## 更新 Starlight

Expand Down Expand Up @@ -167,7 +167,6 @@ yarn upgrade @astrojs/starlight --latest
## Starlight 故障排除

本站点的参考部分提供了 Starlight [项目配置](/zh-cn/reference/configuration/)[单个页面 frontmatter 配置](/zh-cn/reference/frontmatter/)信息。使用这些页面来确保你的 Starlight 网站已正确配置和运行。

请参阅侧边栏中的指南列表,以获取有关添加内容和自定义 Starlight 网站的帮助。

如果你在这些文档中找不到答案,请访问[完整的 Astro 文档](https://docs.astro.build/zh-cn/) 以获取完整的 Astro 文档。
Expand Down

0 comments on commit 3f3b37f

Please sign in to comment.