docs: update zh-cn translations

Author: imfing

exampleSite/content/docs/_index.zh-cn.md

@@ -7,29 +7,29 @@ title: 介绍
 
 <!--more-->
 
-## Hextra 是什么？
+## 什么是 Hextra？
 
-Hextra 是一款现代、快速且内置丰富功能的 [Hugo][hugo] 主题，它是用 [Tailwind CSS][tailwind-css] 构建的。该主题旨在创建美观的文档、博客和网站，提供了开箱即用的功能和灵活性以满足各种需求。
+Hextra 是一个现代、快速且功能齐全的 [Hugo][hugo] 主题，基于 [Tailwind CSS][tailwind-css] 构建。专为构建美观的文档、博客和网站而设计，它提供了开箱即用的功能和灵活性，以满足各种需求。
 
-## 功能特点
+## 特性
 
-- **优美的设计** - 受到 Nextra 的启发，Hextra 利用 Tailwind CSS 提供了一种现代设计，使您的网站看起来出色。
-- **响应式布局和深色模式** - 无论是在移动设备、平板还是桌面上，都表现出色。同时支持深色模式以适应各种光线条件。
-- **快速和轻量级** - 由 Hugo 驱动，一个轻量级且超快的静态网站生成器，封装在一个单一的二进制文件中，Hextra 保持其占用极小。使用它不需要 Javascript 或 Node.js。
-- **全文搜索** - 内置的离线全文搜索由 FlexSearch 提供支持，无需额外配置。
-- **功能全面** - 支持 Markdown、语法高亮、LaTeX 数学公式、图表以及 Shortcodes 元素以增强您的内容。目录、面包屑、分页、侧边栏导航等都会自动生成。
-- **多语言和 SEO 支持** - Hugo 的多语言模式轻松支持多语言网站。对于 SEO 标签、Open Graph 和 Twitter 卡片，也提供了开箱即用的支持。
+- **精美设计** - 灵感源自 Nextra，Hextra 利用 Tailwind CSS 提供现代设计，使您的网站脱颖而出。
+- **响应式布局与暗黑模式** - 在所有设备上都能完美呈现，从手机、平板到桌面。暗黑模式也得到支持，以适应不同的光照条件。
+- **快速且轻量** - 由 Hugo 驱动，这是一个闪电般快速的静态网站生成器，仅需一个二进制文件，Hextra 保持其占用空间最小。无需 JavaScript 或 Node.js 即可使用。
+- **全文搜索** - 内置离线全文搜索，由 FlexSearch 提供支持，无需额外配置。
+- **功能齐全** - Markdown、语法高亮、LaTeX 数学公式、图表和 Shortcodes 元素，丰富您的内容。目录、面包屑导航、分页、侧边栏导航等均自动生成。
+- **多语言与 SEO 就绪** - 通过 Hugo 的多语言模式轻松创建多语言网站。开箱即用支持 SEO 标签、Open Graph 和 Twitter Cards。
 
 ## 有问题或反馈？
 
 {{< callout emoji="❓" >}}
   Hextra 仍在积极开发中。
-  有问题或反馈？请随时[提出问题](https://github.com/imfing/hextra/issues)！
+  有问题或反馈？欢迎[提交问题](https://github.com/imfing/hextra/issues)！
 {{< /callout >}}
 
-## 接下来
+## 下一步
 
-直接进入以下部分开始：
+立即深入以下部分，开始使用：
 
 {{< cards >}}
   {{< card link="getting-started" title="入门指南" icon="document-text" subtitle="学习如何使用 Hextra 创建网站" >}}
@@ -38,3 +38,4 @@ Hextra 是一款现代、快速且内置丰富功能的 [Hugo][hugo] 主题，
 [hugo]: https://gohugo.io/
 [flex-search]: https://github.com/nextapps-de/flexsearch
 [tailwind-css]: https://tailwindcss.com/
+```

exampleSite/content/docs/advanced/_index.zh-cn.md

@@ -1,15 +1,16 @@
 ---
-linkTitle: 高级配置
-title: 高级配置
+linkTitle: 高级
+title: 高级主题
 prev: /docs/guide/shortcodes/tabs
 next: /docs/advanced/multi-language
 ---
 
-此部分提供了 Hextra 的一些高级配置。
+本节涵盖了一些主题的高级内容。
 
 <!--more-->
 
 {{< cards >}}
   {{< card link="multi-language" title="多语言" icon="translate" >}}
-  {{< card link="customization" title="定制化" icon="pencil" >}}
-{{< /cards >}}
+  {{< card link="customization" title="自定义" icon="pencil" >}}
+  {{< card link="comments" title="评论系统" icon="chat-alt" >}}
+{{< /cards >}}

exampleSite/content/docs/advanced/comments.zh-cn.md

@@ -1,18 +1,18 @@
 ---
 title: 评论系统
-linkTitle: Comments
+linkTitle: 评论
 ---
 
-Hextra 支持在你的网站中添加评论系统。
-目前已经支持 [giscus](https://giscus.app/).
+Hextra 支持为您的网站添加评论系统。
+目前支持 [giscus](https://giscus.app/)。
 
 <!--more-->
 
 ## giscus
 
-[giscus](https://giscus.app/) 是由 [GitHub Discussions](https://docs.github.com/en/discussions)驱动的评论系统。Giscus 免费并且开源。
+[giscus](https://giscus.app/) 是一个由 [GitHub Discussions](https://docs.github.com/en/discussions) 提供支持的评论系统。它是免费且开源的。
 
-如需启用 Giscus, 你需要在配置文件中添加以下内容：
+要启用 giscus，您需要在网站配置文件中添加以下内容：
 
 ```yaml {filename="hugo.yaml"}
 params:
@@ -21,19 +21,19 @@ params:
     type: giscus
 
     giscus:
-      repo: <repository>
-      repoId: <repository ID>
-      category: <category>
-      categoryId: <category ID>
+      repo: <仓库>
+      repoId: <仓库 ID>
+      category: <分类>
+      categoryId: <分类 ID>
 ```
 
-Giscus 配置可以参考 [giscus.app](https://giscus.app/)，还可以在那里找到更多详细信息。
+giscus 的配置可以从 [giscus.app](https://giscus.app/) 网站生成。更多详细信息也可以在那里找到。
 
-可以在 front matter 中启用或禁用特定页面的评论：
+可以在页面的 front matter 中为特定页面启用或禁用评论：
 
 ```yaml {filename="content/docs/about.md"}
 ---
-title: About
+title: 关于
 comments: true
 ---
-```
+```

exampleSite/content/docs/advanced/customization.zh-cn.md

@@ -3,56 +3,209 @@ title: 自定义 Hextra
 linkTitle: 自定义
 ---
 
-Hextra 在 `hugo.yaml` 中提供了一些自定义选项来配置主题。
-本页介绍了可用选项以及如何进一步自定义主题。
+Hextra 在 `hugo.yaml` 配置文件中提供了一些默认的自定义选项，用于配置主题。
+本页描述了可用的选项以及如何进一步自定义主题。
 
 <!--more-->
 
 ## 自定义 CSS
 
-要添加自定义 CSS，我们需要在站点中创建一个文件 `assets/css/custom.css`。Hextra 将自动加载该文件，比如自定义字体：
+要添加自定义 CSS，我们需要在站点中创建一个文件 `assets/css/custom.css`。Hextra 会自动加载此文件。
+
+### 字体
+
+内容的字体可以通过以下方式自定义：
 
 ```css {filename="assets/css/custom.css"}
 .content {
   font-family: "Times New Roman", Times, serif;
 }
 ```
 
-### 主题色
+### 内联代码元素
 
-主题色可以通过设置 `--primary-hue` 变量来自定义：
+与 `其他文本` 混合的文本颜色可以通过以下方式自定义：
+
+```css {filename="assets/css/custom.css"}
+.content code:not(.code-block code) {
+  color: #c97c2e;
+}
+```
+
+### 主色调
+
+主题的主色调可以通过设置 `--primary-hue`、`--primary-saturation` 和 `--primary-lightness` 变量来自定义：
 
 ```css {filename="assets/css/custom.css"}
 :root {
   --primary-hue: 100deg;
+  --primary-saturation: 90%;
+  --primary-lightness: 50%;
+}
+```
+
+### 进一步的主题自定义
+
+可以通过覆盖暴露的 CSS 类来进一步自定义主题。以下是一个自定义页脚元素的示例：
+
+```css {filename="assets/css/custom.css"}
+.hextra-footer {
+  /* 样式将应用于页脚元素 */
+}
+
+.hextra-footer:is(html[class~="dark"] *) {
+  /* 样式将应用于暗模式下的页脚元素 */
 }
 ```
 
-### 代码高亮
+以下类可用于自定义主题的各个部分。
+
+#### 通用
+
+- `hextra-scrollbar` - 滚动条元素
+- `content` - 页面内容容器
+
+#### 短代码
+
+##### 徽章
+
+- `hextra-badge` - 徽章元素
+
+##### 卡片
+
+- `hextra-card` - 卡片元素
+- `hextra-card-image` - 卡片图片元素
+- `hextra-card-icon` - 卡片图标元素
+- `hextra-card-subtitle` - 卡片副标题元素
+
+##### 卡片组
+
+- `hextra-cards` - 卡片网格容器
+
+##### Jupyter Notebook
+
+- `hextra-jupyter-code-cell` - Jupyter 代码单元容器
+- `hextra-jupyter-code-cell-outputs-container` - Jupyter 代码单元输出容器
+- `hextra-jupyter-code-cell-outputs` - Jupyter 代码单元输出 div 元素
+
+##### PDF
+
+- `hextra-pdf` - PDF 容器元素
+
+##### 步骤
+
+- `steps` - 步骤容器
+
+##### 标签页
+
+- `hextra-tabs-panel` - 标签页面板容器
+- `hextra-tabs-toggle` - 标签页切换按钮
+
+##### 文件树
+
+- `hextra-filetree` - 文件树容器
 
-代码高亮风格的详细信息可在 [Chroma Styles Gallery](https://xyproto.github.io/splash/docs/all.html) 中找到。可以使用以下命令生成样式表：
+##### 文件夹
+
+- `hextra-filetree-folder` - 文件树文件夹容器
+
+#### 导航栏
+
+- `nav-container` - 导航栏容器
+- `nav-container-blur` - 导航栏模糊元素
+- `hamburger-menu` - 汉堡菜单按钮
+
+#### 页脚
+
+- `hextra-footer` - 页脚元素
+- `hextra-custom-footer` - 自定义页脚部分容器
+
+#### 搜索
+
+- `search-wrapper` - 搜索包装容器
+- `search-input` - 搜索输入元素
+- `search-results` - 搜索结果列表容器
+
+#### 目录
+
+- `hextra-toc` - 目录容器
+
+#### 侧边栏
+
+- `mobile-menu-overlay` - 移动菜单的覆盖元素
+- `sidebar-container` - 侧边栏容器
+- `sidebar-active-item` - 侧边栏中的活动项
+
+#### 语言切换器
+
+- `language-switcher` - 语言切换按钮
+- `language-options` - 语言选项容器
+
+#### 主题切换
+
+- `theme-toggle` - 主题切换按钮
+
+#### 代码复制按钮
+
+- `hextra-code-copy-btn-container` - 代码复制按钮容器
+- `hextra-code-copy-btn` - 代码复制按钮
+
+#### 代码块
+
+- `hextra-code-block` - 代码块容器
+
+#### 功能卡片
+
+- `hextra-feature-card` - 功能卡片链接元素
+
+#### 功能网格
+
+- `hextra-feature-grid` - 功能网格容器
+
+#### 面包屑导航
+
+面包屑导航没有特定的类。
+
+### 语法高亮
+
+可用的语法高亮主题列表可在 [Chroma 样式库](https://xyproto.github.io/splash/docs/all.html) 中找到。可以使用以下命令生成样式表：
 
 ```shell
 hugo gen chromastyles --style=github
 ```
 
-可将生成的样式添加到自定义 CSS 文件中以覆盖默认代码高亮样式。
+要覆盖默认的语法高亮主题，可以将生成的样式添加到自定义 CSS 文件中。
 
-## 自定义 Script
+## 自定义脚本
 
-你可以添加以下文件以自定义 `script` 添加到每页的 `head` 最后：
+你可以通过添加以下文件在每个页面的 head 末尾添加自定义脚本：
 
 ```
 layouts/partials/custom/head-end.html
 ```
 
+## 自定义页脚额外部分
+
+你可以通过在站点中创建文件 `layouts/partials/custom/footer.html` 来在页脚中添加额外部分。
+
+```html {filename="layouts/partials/custom/footer.html"}
+<!-- 你的页脚元素在这里 -->
+```
+
+添加的部分将出现在页脚的版权部分之前。
+你可以使用 [HTML](https://developer.mozilla.org/en-US/docs/Web/HTML) 和 [Hugo 模板语法](https://gohugo.io/templates/) 来添加自己的内容。
+
+页脚部分可用的 Hugo 变量有：`.switchesVisible` 和 `.copyrightVisible`。
+
 ## 自定义布局
 
-可以在站点的 `layouts` 目录中创建同名文件来覆盖主题的默认布局。
-例如，要覆盖文档的 `single.html` 布局，在站点中创建文件 `layouts/docs/single.html`。
+可以通过在站点的 `layouts` 目录中创建同名文件来覆盖主题的布局。
+例如，要覆盖文档的 `single.html` 布局，可以在站点中创建文件 `layouts/docs/single.html`。
+
+更多信息，请参阅 [Hugo 模板文档][hugo-template-docs]。
 
-如需或许更多信息，转至 [Hugo Templates](https://gohugo.io/templates/)。
+## 进一步自定义
 
-## 进一步定制 Hextra
+没有找到你想要的？欢迎 [发起讨论](https://github.com/imfing/hextra/discussions) 或为主题做出贡献！
 
-没有找到你想修改的内容？在 GitHub 上[创建 Discussion](https://github.com/imfing/hextra/discussions) 或为 Hextra 贡献你的智慧！
+[hugo-template-docs]: https://gohugo.io/templates/