Merge commit '475f87f685439de0f907a9ffc29bfd1361eb1c59'

2025-08-25 22:00:58 +02:00 · 2022-06-16 07:22:11 +02:00
parent d863dde6c6 475f87f685
commit 604cfffc5b
18 changed files with 109 additions and 82 deletions
--- a/docs/content/zh/_index.md
+++ b/docs/content/zh/_index.md
@@ -1,49 +1,49 @@
 ---
-title: "世界上最快的网站构建框架 The world’s fastest framework for building websites"
+title: "世界上最快的网站构建框架"
 date: 2017-03-02T12:00:00-05:00
 features:
-  - heading: Blistering Speed
+  - heading: 飞快的速度
    image_path: /images/icon-fast.svg
-    tagline: What's modern about waiting for your site to build?
-    copy: Hugo is the fastest tool of its kind. At <1 ms per page, the average site builds in less than a second.
+    tagline: 摩登发布
+    copy: Hugo 是同类中最快的工具。生成一页小于 1ms，生成一个站点平均不超过 1s。

-  - heading: Robust Content Management
+  - heading: 强大的内容管理
    image_path: /images/icon-content-management.svg
-    tagline: Flexibility rules. Hugo is a content strategist's dream.
-    copy: Hugo supports unlimited content types, taxonomies, menus, dynamic API-driven content, and more, all without plugins.
+    tagline: 灵活的规则。Hugo 是一个设计师的梦想。
+    copy: Hugo 支持无限的内容类型、分类、菜单、动态 API 驱动的内容，以及更多，都不需要插件。

-  - heading: Shortcodes
+  - heading: 短代码
    image_path: /images/icon-shortcodes.svg
-    tagline: Hugo's shortcodes are Markdown's hidden superpower.
-    copy: We love the beautiful simplicity of markdown’s syntax, but there are times when we want more flexibility. Hugo shortcodes allow for both beauty and flexibility.
+    tagline: Hugo 短代码是 Markdown 隐藏的强大功能。
+    copy: 我们喜欢美丽简洁的 markdown 语法，但是有时候我们也想要更灵活一些。Hugo 短代码允许既美丽又灵活。

-  - heading: Built-in Templates
+  - heading: 内置模板
    image_path: /images/icon-built-in-templates.svg
-    tagline: Hugo has common patterns to get your work done quickly.
-    copy: Hugo ships with pre-made templates to make quick work of SEO, commenting, analytics and other functions. One line of code, and you're done.
+    tagline: Hugo 有通用的模式让你快速的完成工作。
+    copy: Hugo 平台预置的模板会快速实现搜索引擎优化、评论、分析和其他的功能。一行代码，你就完成了。

-  - heading: Multilingual and i18n
+  - heading: 多语言和国际化
    image_path: /images/icon-multilingual2.svg
-    tagline: Polyglot baked in.
-    copy: Hugo provides full i18n support for multi-language sites with the same straightforward development experience Hugo users love in single-language sites.
+    tagline: 多语言制作
+    copy: Hugo 为多语言站点提供了完整的国际化支持，并且具有与 Hugo 用户在单语言站点中喜爱的相同的简单开发体验。

-  - heading: Custom Outputs
+  - heading: 自定义输出
    image_path: /images/icon-custom-outputs.svg
-    tagline: HTML not enough?
-    copy: Hugo allows you to output your content in multiple formats, including JSON or AMP, and makes it easy to create your own.
+    tagline: HTML 不够用吗？
+    copy: Hugo 允许您以多种格式输出内容，包括 JSON 或 AMP，并且可以很容易地创建自己的内容。
 sections:
-  - heading: "100s of Themes"
-    cta: Check out the Hugo's themes.
+  - heading: "100 多个主题"
+    cta: 看看 Hugo 的主题
    link: https://themes.gohugo.io/
    color_classes: bg-accent-color white
    image: /images/homepage-screenshot-hugo-themes.jpg
-    copy: "Hugo provides a robust theming system that is easy to implement but capable of producing even the most complicated websites."
-  - heading: "Capable Templating"
-    cta: Get Started.
+    copy: "Hugo 提供了一个强大的主题系统，易于实现，但能够生成即使是最复杂的网站。"
+  - heading: "功能模板"
+    cta: 开始吧。
    link: templates/
    color_classes: bg-primary-color-light black
    image: /images/home-page-templating-example.png
-    copy: "Hugo's Go-based templating provides just the right amount of logic to build anything from the simple to complex. If you prefer Jade/Pug-like syntax, you can also use Amber, Ace, or any combination of the three."
+    copy: "Hugo 基于 Go 的模板提供了恰当的方法来生成从简单到复杂的任何东西。如果你喜欢 Jade/Pug 类似的语法，你也可以使用 Amber、Ace 或三种任意组合。"
 ---

-Hugo is one of the most popular open-source static site generators. With its amazing speed and flexibility, Hugo makes building websites fun again.
+Hugo 是最受欢迎的开源静态站点生成器之一。凭借惊人的速度和灵活性，Hugo 使建设网站的乐趣再现。
--- a/docs/content/zh/documentation.md
+++ b/docs/content/zh/documentation.md
@@ -1,7 +1,7 @@
 ---
 title: Hugo 说明文档
 linktitle: Hugo
-description: Hugo is the world's fastest static website engine. It's written in Go (aka Golang) and developed by bep, spf13 and friends.
+description: Hugo 是世界上最快的静态网站引擎。它是用 Go (即 Golang) 编程语言所写成，由 bep、spf13 和朋友们共同开发。
 date: 2017-02-01
 publishdate: 2017-02-01
 menu:
@@ -16,6 +16,6 @@ toc: false
 layout: documentation-home
 isCJKLanguage: true
 ---
-Hugo 号称**世界上最快的静态网站引擎**。它是以 Go (即 Golang) 编程语言所写成，并由 [bep](https://github.com/bep)、[spf13](https://github.com/spf13) 和[朋友们](https://github.com/gohugoio/hugo/graphs/contributors) 共同开发。
+Hugo 是世界上最快的静态网站引擎。它是用 Go (即 Golang) 编程语言所写成，由 [bep](https://github.com/bep)、[spf13](https://github.com/spf13) 和[朋友们](https://github.com/gohugoio/hugo/graphs/contributors)共同开发。

 下面是我们说明文档中最常用和实用的章节：
--- a/docs/content/zh/tools/_index.md
+++ b/docs/content/zh/tools/_index.md
@@ -0,0 +1,25 @@
+---
+title:  开发者工具
+linktitle:  开发者工具概览
+description: 除了 Hugo 强大的命令外，对于 Hugo 开发者还有大量社区开发的工具链。
+date: 2018-05-29
+publishdate: 2018-05-29
+lastmod: 2018-05-29
+categories: [developer tools]
+keywords: []
+menu:
+  docs:
+    parent: "tools"
+    weight: 01
+weight: 01
+sections_weight: 01
+draft: false
+aliases: [/tools/]
+---
+
+Hugo 最强大的在于它是活跃的——并总在发展的——开发者社区。除了在[语法高亮][syntax] 中提到的 `highlight` 简码外，该章节中的这些工具和其它项目特色都是由商业服务和开源项目提供，很多就是由像你一样的 Hugo 开发者开发的。
+
+[查看 Hugo 的流行程度与其它静态网站生成器的比较。][staticgen]
+
+[staticgen]: https://staticgen.com
+[syntax]: /tools/syntax-highlighting/
--- a/docs/content/zh/tools/search.md
+++ b/docs/content/zh/tools/search.md
@@ -0,0 +1,31 @@
+---
+title: 搜索你的 Hugo 网站
+linktitle: 搜索
+description: 为你最新添加的 Hugo 网站看一些开源和商业搜索选择。
+date: 2018-05-29
+publishdate: 2018-05-29
+lastmod: 2018-05-29
+categories: [developer tools]
+keywords: [search,tools]
+menu:
+  docs:
+    parent: "tools"
+    weight: 60
+weight: 60
+sections_weight: 60
+draft: false
+aliases: []
+toc: true
+---
+
+静态网站还有动态搜索功能？是的。作为可选方案，来自 Google 或者其它搜索引擎的嵌入式脚本，可以给你的访客提供一个自定义的直接基于你的内容文件索引的搜素。
+
+* [GitHub Gist for Hugo Workflow](https://gist.github.com/sebz/efddfc8fdcb6b480f567). Gist 包含一个为你的网站创建索引的简单流程。它使用简单的 Grunt 脚本索引你所有的内容文件，并且 [lunr.js](http://lunrjs.com/) 会提供搜索结果。
+* [hugo-lunr](https://www.npmjs.com/package/hugo-lunr). 一个使用 [lunr.js](http://lunrjs.com/) 为你的 Hugo 静态网站添加搜索的简单方法。Hugo-lunr 将会给你的 Hugo 项目中任意 html 和 markdown 文件创建一个索引文件。
+* [hugo-lunr-zh](https://www.npmjs.com/package/hugo-lunr-zh). 有点像 Hugo-lunr，但是 Hugo-lunr-zh 能帮助你分割中文关键字。
+* [Github Gist for Fuse.js integration](https://gist.github.com/eddiewebb/735feb48f50f0ddd65ae5606a1cb41ae). 该 gist 显示如何借助 Hugo 已有的构建时间在客户端通过 [Fuse.js](http://fusejs.io/) 生成可搜索的 JSON 索引。尽管 gist 使用 Fuse.js 进行模糊匹配，任何有能力读取 JSON 索引的客户端工具都可以运行。不需要 Hugo 以外， npm、grunt 或者其它构建时工具。
+* [hugo-search-index](https://www.npmjs.com/package/hugo-search-index). 一个包含实现了搜索的 Gulp 任务和内置浏览器脚本的库。Gulp 从项目中的 markdown 文件生成索引。
+
+## 商业搜索服务
+
+* [Algolia](https://www.algolia.com/) 的搜索 API 使得在你的应用和网站中提供一个很好的搜索体验变得简单。Algolia 搜索提供托管的全文本、数字化、分面以及地理定位搜索。