drowl87/hextra_mirror
1
0
Fork 1
mirror of https://github.com/imfing/hextra.git synced 2025-08-23 14:26:38 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity

chore: update zh-cn translation

Browse Source
This commit is contained in:
Xin
2025-08-14 19:07:25 +08:00
parent 8773081fae
commit f79b1d262c
29 changed files with 993 additions and 495 deletions
Download Patch File Download Diff File Expand all files Collapse all files

66
exampleSite/content/docs/getting-started.zh-cn.md
View File

@@ -1,5 +1,5 @@
---
title: 入门指南
title: 快速开始
weight: 1
tags:
- 文档
@@ -8,28 +8,28 @@ 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/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)。
我们提供了一个[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 项目中：
有两种主要方式将Hextra主题添加到您的Hugo项目中：
1. **Hugo 模块（推荐）**：最简单且推荐的方法。[Hugo 模块](https://gohugo.io/hugo-modules/)允许您直接从在线源拉取主题。主题会自动下载并由 Hugo 管理。
1. **Hugo模块（推荐）**：最简单且推荐的方法。[Hugo模块](https://gohugo.io/hugo-modules/)允许您直接从在线源拉取主题。主题会自动下载并由Hugo管理。
2. **Git 子模块**：或者，将 Hextra 添加为 [Git 子模块](https://git-scm.com/book/en/v2/Git-Tools-Submodules)。主题由 Git 下载并存储在您项目的 `themes` 文件夹中。
2. **Git子模块**：或者，将Hextra添加为[Git子模块](https://git-scm.com/book/en/v2/Git-Tools-Submodules)。主题由Git下载并存储在项目的`themes`文件夹中。
### 将 Hextra 设置为 Hugo 模块
### 将Hextra设置为Hugo模块
#### 先决条件
@@ -43,24 +43,24 @@ prev: /docs
{{% steps %}}
### 初始化一个新的 Hugo 站点
### 初始化一个新的Hugo站点
```shell
hugo new site my-site --format=yaml
```
### 通过模块配置 Hextra 主题
### 通过模块配置Hextra主题
```shell
# 初始化 Hugo 模块
# 初始化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:
@@ -70,7 +70,7 @@ module:
### 创建您的内容页面
为主页和文档页面创建新的内容页面：
为主页和文档页面创建新内容：
```shell
hugo new content/_index.md
@@ -83,30 +83,30 @@ hugo new content/docs/_index.md
hugo server --buildDrafts --disableFastRender
```
恭喜，您的新站点预览可在 `http://localhost:1313/` 查看。
恭喜，您的新站点预览可在`http://localhost:1313/`查看。
{{% /steps %}}
{{% details title="如何更新主题？" %}}
要更新项目中所有 Hugo 模块到最新版本，请运行以下命令：
要更新项目中的所有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 模块](https://gohugo.io/hugo-modules/use-modules/#update-all-modules)。
更多详情请参阅[Hugo模块](https://gohugo.io/hugo-modules/use-modules/#update-all-modules)。
{{% /details %}}
### 将 Hextra 设置为 Git 子模块
### 将Hextra设置为Git子模块
#### 先决条件
@@ -119,28 +119,28 @@ hugo mod get -u github.com/imfing/hextra
{{% steps %}}
### 初始化一个新的 Hugo 站点
### 初始化一个新的Hugo站点
```shell
hugo new site my-site --format=yaml
```
### 将 Hextra 主题添加为 Git 子模块
### 将Hextra主题添加为Git子模块
切换到站点目录并初始化新的 Git 仓库：
切换到站点目录并初始化一个新的Git仓库：
```shell
cd my-site
git init
```
然后，将 Hextra 主题添加为 Git 子模块：
然后，将Hextra主题添加为Git子模块：
```shell
git submodule add https://github.com/imfing/hextra.git themes/hextra
```
配置 `hugo.yaml` 以使用 Hextra 主题，添加以下内容：
配置`hugo.yaml`以使用Hextra主题，添加以下内容：
```yaml
theme: hextra
@@ -148,7 +148,7 @@ theme: hextra
### 创建您的内容页面
为主页和文档页面创建新的内容页面：
为主页和文档页面创建新内容：
```shell
hugo new content/_index.md
@@ -161,35 +161,35 @@ hugo new content/docs/_index.md
hugo server --buildDrafts --disableFastRender
```
您的新站点预览可在 `http://localhost:1313/` 查看。
您的新站点预览可在`http://localhost:1313/`查看。
{{% /steps %}}
当使用 [CI/CD](https://en.wikipedia.org/wiki/CI/CD) 部署 Hugo 网站时，确保在运行 `hugo` 命令之前执行以下命令至关重要。
当使用[CI/CD](https://en.wikipedia.org/wiki/CI/CD)部署Hugo网站时，确保在运行`hugo`命令之前执行以下命令至关重要。
```shell
git submodule update --init
```
如果不运行此命令，主题文件夹将不会被 Hextra 主题文件填充，导致构建失败。
如果不运行此命令，主题文件夹将不会被填充Hextra主题文件，导致构建失败。
{{% details title="如何更新主题？" %}}
要更新仓库中所有子模块到最新提交，请运行以下命令：
要更新仓库中的所有子模块到最新提交，运行以下命令：
```shell
git submodule update --remote
```
要将 Hextra 更新到最新提交，请运行以下命令：
要将Hextra更新到最新提交，运行以下命令：
```shell
git submodule update --remote themes/hextra
```
有关更多详细信息，请参阅 [Git 子模块](https://git-scm.com/book/en/v2/Git-Tools-Submodules)。
更多详情请参阅[Git子模块](https://git-scm.com/book/en/v2/Git-Tools-Submodules)。
{{% /details %}}