Skip to content

Commit

Permalink
chore(i18n): improve translations of zh-cn (#14)
Browse files Browse the repository at this point in the history
  • Loading branch information
imfing authored Aug 30, 2023
1 parent e1a2109 commit b709452
Show file tree
Hide file tree
Showing 17 changed files with 269 additions and 113 deletions.
8 changes: 4 additions & 4 deletions exampleSite/content/about/index.zh-cn.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,15 @@ title: 关于
toc: false
---

Hextra 是一款简洁, 快速, 灵活的主题, 适用于构建现代化静态站点. Hextra 特别适用于文档网站, 但也可用于构建,博客, 投资组合网站等各种类型的网站.
Hextra 是一款简洁、快速、灵活的主题适用于构建现代化静态站点Hextra 特别适用于文档网站,但也可用于构建博客、个人网站等各种类型的网站。

Hugo 和 Jekyll 类似, 是一个静态网站生成器, 但与其他生成器不同, Hugo 只有单个可执行文件, 这使得它可以轻松地在各种平台上安装和运行. Hugo 的运行速度非常快且可靠性高, 能够在几毫秒内渲染数千页的网站.
Hugo 和 Jekyll 类似是一个静态网站生成器但与其他生成器不同Hugo 只有单个可执行文件这使得它可以轻松地在各种平台上安装和运行Hugo 的运行速度非常快且可靠性高能够在几毫秒内渲染数千页的网站

Hextra 被设计为轻量级, 具有最小化的内存占用. 使用 Hextra 无需安装繁杂的依赖, 比如 Node.js; 相反, 你只需要一个简单的 YAML 配置文件和 Markdown 内容. 因此, 我们可以专注于内容而非在配置环境上浪费精力
Hextra 被设计为轻量级具有最小化的内存占用使用 Hextra 无需安装繁杂的依赖比如 Node.js;相反,你只需要一个简单的 YAML 配置文件和 Markdown 内容。因此,我们可以专注于内容而非在配置环境上浪费精力

## 鸣谢

Hextra 的设计离不开这些项目的支持和其提供的灵感:
Hextra 的设计离不开这些项目的支持和其提供的灵感

- [Hugo](https://gohugo.io/)
- [Tailwind CSS](https://tailwindcss.com/)
Expand Down
137 changes: 137 additions & 0 deletions exampleSite/content/blog/markdown.zh-cn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,137 @@
---
title: Markdown 语法指南
date: 2020-01-01
authors:
- name: John Doe
link: https://example.com/johndoe
excludeSearch: true
---

这篇文章提供了一些基础的 Markdown 语法样例,这些可以在 Hugo 的内容文件中使用。

<!--more-->

## 基础语法

### 标题

```
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
```

## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

```text
*这段文字将是斜体*
_这也将是斜体_
**这段文字将是粗体**
__这也将是粗体__
_你 **可以** 组合它们_
```

*这段文字将是斜体*
_这也将是斜体_

**这段文字将是粗体**
__这也将是粗体__

_**可以** 组合它们_

### 列表

#### 无序列表

* 项目 1
* 项目 2
* 项目 2a
* 项目 2b

#### 有序列表

1. 项目 1
2. 项目 2
3. 项目 3
1. 项目 3a
2. 项目 3b

### 图片

```markdown
![GitHub Logo](https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png)
```

![GitHub Logo](https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png)

### 链接

```markdown
[Hugo](https://gohugo.io)
```

[Hugo](https://gohugo.io)

### 块引用

```markdown
牛顿曾说:

> 如果我看得更远,那是因为我站在巨人的肩膀上。
```

> 如果我看得更远,那是因为我站在巨人的肩膀上。
### 行内代码

```markdown
行内 `代码` 有 `反引号` 包围。
```

行内 `代码``反引号` 包围。

### 代码块

#### 语法高亮

````markdown
```go
func main() {
fmt.Println("Hello World")
}
```
````

```go
func main() {
fmt.Println("Hello World")
}
```

### 表格

```markdown
| Syntax | Description |
| --------- | ----------- |
| Header | Title |
| Paragraph | Text |
```

| Syntax | Description |
| --------- | ----------- |
| Header | Title |
| Paragraph | Text |

## 参考

- [Markdown Syntax](https://www.markdownguide.org/basic-syntax/)
- [Hugo Markdown](https://gohugo.io/content-management/formats/#markdown)
31 changes: 16 additions & 15 deletions exampleSite/content/docs/_index.zh-cn.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,37 +3,38 @@ linkTitle: "文档"
title: 介绍
---

👋 嘿, 你好! 欢迎来到 Hextra 的文档!
👋 你好!欢迎来到 Hextra 文档!

<!--more-->

## Hextra 是什么?
Hextra 是一个现代化, 快速和开箱即用的 [Hugo][hugo] 主题, 使用 [Tailwind CSS][tailwind-css] 构建.
被设计于构建美观的文档, 博客等网站, Hextra 提供了一些开箱即用的功能和强大的可扩展性以面对各种而样的需求.
## Hextra 是什么?

## 功能
Hextra 是一款现代、快速且内置丰富功能的 [Hugo][hugo] 主题,它是用 [Tailwind CSS][tailwind-css] 构建的。该主题旨在创建美观的文档、博客和网站,提供了开箱即用的功能和灵活性以满足各种需求。

- **美观的设计** - 受 Nextra 的启发,Hextra 利用 Tailwind CSS 提供现代化的设计,使您的网站看起来美观有加.
- **响应式布局和深色模式支持** - 在任何设备上看起来都足够美观, 无论是手机, 平板电脑或者电脑. 深色模式的支持使 Hextra 可以应对各种照明环境.
- **快速且轻量** - 由 Hugo 强力支持, Hugo 是一个快如闪电的静态站点生成器, 这一切都只需一个可执行文件, Hextra 始终保持最小化, 无需 Javascript 或者 Node.js.
- **全文搜索** - 集成了 Flexsearch 的全文搜索, 无需额外的配置.
- **网站中的瑞士军刀** - Markdown, 代码高亮, LaTex 数学公式, diagrams 图表和 Shortcodes 都可以用于丰富你的内容. 目录, 面包屑导航, 分页, 侧边栏等均由 Hextra 自动生成。
- **多语言和 SEO Ready** - Hugo 的多语言模式使得构建多语言网站更简单. 具有 SEO tags, Open Graph, 和 Twitter Cards 等诸多开箱即用的功能.
## 功能特点

## 有问题或反馈?
- **优美的设计** - 受到 Nextra 的启发,Hextra 利用 Tailwind CSS 提供了一种现代设计,使您的网站看起来出色。
- **响应式布局和深色模式** - 无论是在移动设备、平板还是桌面上,都表现出色。同时支持深色模式以适应各种光线条件。
- **快速和轻量级** - 由 Hugo 驱动,一个轻量级且超快的静态网站生成器,封装在一个单一的二进制文件中,Hextra 保持其占用极小。使用它不需要 Javascript 或 Node.js。
- **全文搜索** - 内置的离线全文搜索由 FlexSearch 提供支持,无需额外配置。
- **功能全面** - 支持 Markdown、语法高亮、LaTeX 数学公式、图表以及 Shortcodes 元素以增强您的内容。目录、面包屑、分页、侧边栏导航等都会自动生成。
- **多语言和 SEO 支持** - Hugo 的多语言模式轻松支持多语言网站。对于 SEO 标签、Open Graph 和 Twitter 卡片,也提供了开箱即用的支持。

## 有问题或反馈?

{{< callout emoji="❓" >}}
Hextra 仍在持续开发中. 有问题或者反馈? 在 GitHub 上 [创建 Issues](https://github.com/imfing/hextra/issues)!
Hextra 仍在积极开发中。
有问题或反馈?请随时[提出问题](https://github.com/imfing/hextra/issues)
{{< /callout >}}

## 接下来

直接进入以下部分开始:

{{< cards >}}
{{< card link="getting-started" title="快速开始" icon="document-text" subtitle="学习如何使用 Hextra 创建网站" >}}
{{< card link="getting-started" title="入门指南" icon="document-text" subtitle="学习如何使用 Hextra 创建网站" >}}
{{< /cards >}}

[hugo]: https://gohugo.io/
[flex-search]: https://github.com/nextapps-de/flexsearch
[tailwind-css]: https://tailwindcss.com/
[tailwind-css]: https://tailwindcss.com/
4 changes: 2 additions & 2 deletions exampleSite/content/docs/advanced/_index.zh-cn.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@ prev: /docs/guide/shortcodes/tabs
next: /docs/advanced/multi-language
---

此部分提供了 Hextra 的一些高级配置.
此部分提供了 Hextra 的一些高级配置

<!--more-->

{{< cards >}}
{{< card link="multi-language" title="多语言" icon="translate" >}}
{{< card link="customization" title="定制化" icon="pencil" >}}
{{< /cards >}}
{{< /cards >}}
20 changes: 10 additions & 10 deletions exampleSite/content/docs/advanced/customization.zh-cn.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@ 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 {
Expand All @@ -30,29 +30,29 @@ Hextra 在 `hugo.yaml` 中提供了一些自定义选项来配置主题.

### 代码高亮

代码高亮风格的详细信息可在 [Chroma Styles Gallery](https://xyproto.github.io/splash/docs/all.html) 中找到. 可以使用以下命令生成样式表:
代码高亮风格的详细信息可在 [Chroma Styles Gallery](https://xyproto.github.io/splash/docs/all.html) 中找到 可以使用以下命令生成样式表:

```bash
$ hugo gen chromastyles --style=github
```

可将生成的样式添加到自定义 CSS 文件中以覆盖默认代码高亮样式.
可将生成的样式添加到自定义 CSS 文件中以覆盖默认代码高亮样式

## 自定义 Script

你可以添加以下文件以自定义 `script` 添加到每页的 `head` `end`.
你可以添加以下文件以自定义 `script` 添加到每页的 `head` 最后:

```
layouts/partials/custom/head-end.html
```

## 自定义布局

可以在站点的 `layouts` 目录中创建同名文件来覆盖主题的默认布局.
例如,要覆盖文档的 `single.html` 布局,在站点中创建文件 `layouts/docs/single.html`.
可以在站点的 `layouts` 目录中创建同名文件来覆盖主题的默认布局
例如,要覆盖文档的 `single.html` 布局,在站点中创建文件 `layouts/docs/single.html`

如需或许更多信息, 转至 [Hugo Templates](https://gohugo.io/templates/).
如需或许更多信息转至 [Hugo Templates](https://gohugo.io/templates/)

## 进一步定制 Hextra

没有找到你想修改的东西?在 GitHub 上[创建 Issues](https://github.com/imfing/hextra/issues) 或为 Hextra 贡献你的智慧!
没有找到你想修改的东西?在 GitHub 上[创建 Issues](https://github.com/imfing/hextra/issues) 或为 Hextra 贡献你的智慧
12 changes: 6 additions & 6 deletions exampleSite/content/docs/advanced/multi-language.zh-cn.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@ weight: 1
prev: /docs/advanced
---

Hextra 支持使用 Hugo 的[多语言模式](https://gohugo.io/content-management/multilingual/) 创建多语言的网站.
Hextra 支持使用 Hugo 的[多语言模式](https://gohugo.io/content-management/multilingual/) 创建多语言的网站

<!--more-->

## 启用多语言支持

为了使我们的网站支持多语言,我们需要告诉 Hugo 需要支持的语言. 在站点配置文件中添加:
为了使我们的网站支持多语言,我们需要告诉 Hugo 需要支持的语言 在站点配置文件中添加:

```yaml {filename="hugo.yaml"}
defaultContentLanguage: en
Expand All @@ -28,7 +28,7 @@ languages:
## 按文件名管理翻译
Hugo 支持按文件名管理翻译. 例如, 如果我们有一个英文文件 `content/docs/_index.md`, 我们可以创建一个翻译为法语的文件 `content/docs/_index.fr.md`.
Hugo 支持按文件名管理翻译。例如,如果我们有一个英文文件 `content/docs/_index.md`我们可以创建一个翻译为法语的文件 `content/docs/_index.fr.md`

{{< filetree/container >}}
{{< filetree/folder name="content" >}}
Expand All @@ -40,11 +40,11 @@ Hugo 支持按文件名管理翻译. 例如, 如果我们有一个英文文件 `
{{< /filetree/folder >}}
{{< /filetree/container >}}

注意:Hugo 还支持[按内容目录管理翻译](https://gohugo.io/content-management/multilingual/#translation-by-content-directory).
注意:Hugo 还支持[按内容目录管理翻译](https://gohugo.io/content-management/multilingual/#translation-by-content-directory)

## 翻译菜单项

要翻译导航栏中的菜单项,我们需要设置 `identifier` 字段:
要翻译导航栏中的菜单项,我们需要设置 `identifier` 字段

```yaml {filename="hugo.yaml"}
menu:
Expand All @@ -61,7 +61,7 @@ menu:

## 翻译字符串

要翻译其他地方的字符串, 我们需要将翻译添加到相应的 i18n 文件中:
要翻译其他地方的字符串我们需要将翻译添加到相应的 `i18n` 文件中

```yaml {filename="i18n/fr.yaml"}
readMore: Lire la suite
Expand Down
Loading

0 comments on commit b709452

Please sign in to comment.