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

docs(blog): prepare for v0.10 release post (#746)

Browse Source 
* docs(blog): prepare for v0.10 release post

* Update v0.10.md

* Update v0.10.md to refine upgrade instructions and enhance blog features. Added synchronized tab switching and pagination controls, while improving the search experience and table of contents navigation.

* Enhance v0.10 release documentation with detailed upgrade instructions and migration guide. Added Tailwind theme variable customization section and clarified breaking changes. Improved clarity on CSS class prefix changes for better user experience.

* Update v0.10.md to enhance upgrade instructions, clarify breaking changes, and improve overall readability. Adjusted formatting for consistency and added details on asset management and user experience improvements.

* Add notable new features to v0.10.md, including dropdown menu support, enhanced search experience, and blog list pagination. Updated FlexSearch upgrade details for clarity and improved migration guide by removing redundant breaking change notes.

* chore: update zh-cn translation

* chore: update ja translation

* chore: update fa and ja translations

* chore: prepare release
This commit is contained in:
Xin
2025-08-14 23:49:06 +08:00
committed by GitHub
parent eca7665571
commit ec007d73c0
85 changed files with 4172 additions and 1545 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 %}}