docs: update zh-cn translations

2024-12-31 00:34:20 +00:00
parent 594b1f190c
commit 9632c4d05a
24 changed files with 1175 additions and 477 deletions
--- a/exampleSite/content/docs/getting-started.zh-cn.md
+++ b/exampleSite/content/docs/getting-started.zh-cn.md
@ -1,49 +1,63 @@
 ---
-title: 快速开始
+title: 入门指南
 weight: 1
 next: /docs/guide
 prev: /docs
 ---

-## 使用模板快速开始
+## 从模板快速开始

 {{< icon "github" >}}&nbsp;[imfing/hextra-starter-template](https://github.com/imfing/hextra-starter-template)

-通过使用上面的模板仓库，您将能够快速地开始。
+您可以通过使用上述模板仓库快速入门。

 <img src="https://docs.github.com/assets/cb-77734/mw-1440/images/help/repository/use-this-template-button.webp" width="500">

-我们提供了一个 [GitHub Actions 工作流](https://docs.github.com/cn/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-with-a-custom-github-actions-workflow)，它可以帮助您自动构建并部署您的网站到 GitHub Pages，并免费托管。
+我们提供了一个 [GitHub Actions 工作流](https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-with-a-custom-github-actions-workflow)，可以帮助自动构建并将您的站点部署到 GitHub Pages，并免费托管。
+更多选项，请查看 [部署站点](../guide/deploy-site)。

 [🌐 演示 ↗](https://imfing.github.io/hextra-starter-template/)

 ## 作为新项目开始

-### 前提条件
+有两种主要方式将 Hextra 主题添加到您的 Hugo 项目中：

-在开始之前，请确保我们已经安装了 [Hugo](https://gohugo.io/)。
-请参考 Hugo 的[官方安装指南](https://gohugo.io/installation/)以获取更多详情。
+1. **Hugo 模块（推荐）**：最简单且推荐的方法。[Hugo 模块](https://gohugo.io/hugo-modules/)允许您直接从在线源拉取主题。主题会自动下载并由 Hugo 管理。

-[Hugo 模块](https://gohugo.io/hugo-modules/)是管理 Hugo 主题的推荐方式。要使用 Hugo 模块，我们需要安装 [Git](https://git-scm.com/) 和 [Go](https://go.dev/)。
+2. **Git 子模块**：或者，将 Hextra 添加为 [Git 子模块](https://git-scm.com/book/en/v2/Git-Tools-Submodules)。主题由 Git 下载并存储在您项目的 `themes` 文件夹中。

-### 初始化 Hugo 站点
+### 将 Hextra 设置为 Hugo 模块
+
+#### 先决条件
+
+在开始之前，您需要安装以下软件：
+
+- [Hugo（扩展版）](https://gohugo.io/installation/)
+- [Git](https://git-scm.com/)
+- [Go](https://go.dev/)
+
+#### 步骤
+
+{{% steps %}}
+
+### 初始化一个新的 Hugo 站点

 ```shell
 hugo new site my-site --format=yaml
 ```

-### 通过 Hugo Module 安装
+### 通过模块配置 Hextra 主题

 ```shell
 # 初始化 Hugo 模块
 cd my-site
 hugo mod init github.com/username/my-site

-# 添加 Hextra 
+# 添加 Hextra 主题
 hugo mod get github.com/imfing/hextra
 ```

-编辑 `hugo.yaml` 以启用 Hextra：
+配置 `hugo.yaml` 以使用 Hextra 主题，添加以下内容：

 ```yaml
 module:
@ -51,92 +65,128 @@ module:
    - path: github.com/imfing/hextra
 ```

-### 通过 Git Submodule 安装
+### 创建您的内容页面

-#### 先决条件
-
-在我们开始之前，你必须先确保以下软件已经安装：
-
- [Hugo (extended version)](https://gohugo.io/installation/)
- [Git](https://git-scm.com/)
-
-#### 步骤
-
-{{% steps %}}
-
-### 初始化 Hugo 站点
-
-```shell
-hugo new site my-site --format=yaml
-```
-
-### 将 Hextra 添加为 Git Submodule
-
-```shell
-git submodule add https://github.com/imfing/hextra.git themes/hextra
-```
-
-添加以下内容来配置 `hugo.yaml` 以使用 Hextra：
-
-```yaml
-theme: hextra
-```
-
-### 创建你的第一个内容页
-
-让我们为主页和文档页面创建一个新的内容页面：
+为主页和文档页面创建新的内容页面：

 ```shell
 hugo new content/_index.md
 hugo new content/docs/_index.md
 ```

-### 在本地预览站点
+### 本地预览站点

 ```shell
 hugo server --buildDrafts --disableFastRender
 ```

-瞧！你现在可以在 `http://localhost:1313/` 看到你的新站点。
+恭喜，您的新站点预览可在 `http://localhost:1313/` 查看。

 {{% /steps %}}


-
-
-使用 [CI/CD](https://en.wikipedia.org/wiki/CI/CD) 进行部署时，必须确保在运行 `hugo` 命令之前执行以下命令。
-
-```shell
-git submodule update --init
-```
-
-如果不运行此命令，theme 中将不会存在 Hextra 文件，进而导致构建失败。
-
-
 {{% details title="如何更新主题？" %}}

-如需把项目中所有的 Hugo Modules 都升级到最新，在终端中运行此命令：
+要更新项目中所有 Hugo 模块到最新版本，请运行以下命令：

 ```shell
 hugo mod get -u
 ```

-如需把 Hextra 升级到[最新的发行版本](https://github.com/imfing/hextra/releases), 在终端中运行此命令：
+要将 Hextra 更新到 [最新发布版本](https://github.com/imfing/hextra/releases)，请运行以下命令：

 ```shell
 hugo mod get -u github.com/imfing/hextra
 ```

-如果你需要获得更多信息，参见 [Hugo Modules](https://gohugo.io/hugo-modules/use-modules/#update-all-modules).
+有关更多详细信息，请参阅 [Hugo 模块](https://gohugo.io/hugo-modules/use-modules/#update-all-modules)。

 {{% /details %}}

-## 接下来
+### 将 Hextra 设置为 Git 子模块

-探索这些文档以便添加更多内容：
+#### 先决条件
+
+在开始之前，您需要安装以下软件：
+
+- [Hugo（扩展版）](https://gohugo.io/installation/)
+- [Git](https://git-scm.com/)
+
+#### 步骤
+
+{{% steps %}}
+
+### 初始化一个新的 Hugo 站点
+
+```shell
+hugo new site my-site --format=yaml
+```
+
+### 将 Hextra 主题添加为 Git 子模块
+
+```shell
+git submodule add https://github.com/imfing/hextra.git themes/hextra
+```
+
+配置 `hugo.yaml` 以使用 Hextra 主题，添加以下内容：
+
+```yaml
+theme: hextra
+```
+
+### 创建您的内容页面
+
+为主页和文档页面创建新的内容页面：
+
+```shell
+hugo new content/_index.md
+hugo new content/docs/_index.md
+```
+
+### 本地预览站点
+
+```shell
+hugo server --buildDrafts --disableFastRender
+```
+
+您的新站点预览可在 `http://localhost:1313/` 查看。
+
+{{% /steps %}}
+
+
+当使用 [CI/CD](https://en.wikipedia.org/wiki/CI/CD) 部署 Hugo 网站时，确保在运行 `hugo` 命令之前执行以下命令至关重要。
+
+```shell
+git submodule update --init
+```
+
+如果不运行此命令，主题文件夹将不会被 Hextra 主题文件填充，导致构建失败。
+
+
+{{% details title="如何更新主题？" %}}
+
+要更新仓库中所有子模块到最新提交，请运行以下命令：
+
+```shell
+git submodule update --remote
+```
+
+要将 Hextra 更新到最新提交，请运行以下命令：
+
+```shell
+git submodule update --remote themes/hextra
+```
+
+有关更多详细信息，请参阅 [Git 子模块](https://git-scm.com/book/en/v2/Git-Tools-Submodules)。
+
+{{% /details %}}
+
+## 下一步
+
+探索以下部分以开始添加更多内容：

 {{< cards >}}
-  {{< card link="../guide/organize-files" title="Organize Files" icon="document-duplicate" >}}
-  {{< card link="../guide/configuration" title="Configuration" icon="adjustments" >}}
+  {{< card link="../guide/organize-files" title="组织文件" icon="document-duplicate" >}}
+  {{< card link="../guide/configuration" title="配置" icon="adjustments" >}}
  {{< card link="../guide/markdown" title="Markdown" icon="markdown" >}}
-{{< /cards >}}
+{{< /cards >}}