HUGO中文文档
文档
关于Hugo
用例
新闻
官方主题
官方网站
99元/年云主机
Search
关于Hugo
概述
什么是Hugo
Hugo 功能特点
静态网站生成器
Hugo安全模型
Hugo和GDPR
许可证
安装
概述
macOS
Linux
Windows
BSD
起步
概述
快速入门
基本用法
目录结构
配置
配置标记语言
术语表
外部学习资源
内容管理
概述
组织
页面捆绑
内容格式
图表
前置格式
构建选项
页面资源
图像处理
短代码
相关内容
Sections
内容类型
雏形
分类法
摘要
链接和交叉引用
URL管理
菜单
静态文件
目录
评论
多语言
语法高亮
模板
概述
模板化
模板查找顺序
基础模板与块
单页模板
列表模板
首页模板
章节模板
分类模板
分页
内容视图模板
部分模板
短代码模板
菜单模板
数据模板
RSS 模板
网站地图模板
本地文件模板
内部模板
渲染钩子
自定义输出格式
404页面
Robots.txt
模板调试
函数
概述
global
Go模板
Hugo
JavaScript
lang
math
os
safe
URL
加密
反射
图像
字符串
数据
时间
格式化
模板
比较
编码
词形变化
调试
资源
路径
转换
转换函数
部分函数
集合
方法
概览
持续时间
时间
网站
菜单项
页面
快速参考
概览
函数
方法
变量
概述
文件变量
Git变量
菜单项变量
页面变量
页面集合变量
短代码变量
网站变量
分类变量
Hugo模块
概述
配置 Hugo 模块
使用 Hugo 模块
主题组件
Hugo管道
概述
简介
将Sass转译为CSS
PostCSS
PostProcess
JavaScript构建
资源压缩
合并资源
指纹和SRI哈希
从字符串创建资源
从模板创建资源
命令行
故障排除
概览
常见问题
构建性能
开发者工具
概述
编辑器插件
前端
搜索
迁移
其他项目
托管和部署
概述
Hugo部署
使用Rclone部署
使用Rsync进行部署
在 Azure 静态 Web 应用上托管
在 Cloudflare Pages 上托管
在 GitHub Pages 上托管
在 Netlify 上托管
在 Render 上托管
在21YunBox上进行托管
在AWS Amplify上托管
在Firebase上托管
在GitLab Pages上托管
在KeyCDN上托管
贡献
概述
开发
文档
主题
维护
内容管理
一个静态站点生成器需要在前置信息和几个模板之外扩展,才能实现可扩展和
可管理
的目标。Hugo不仅考虑到开发者的需求,也考虑到了内容管理者和作者的需求。
内容组织
Hugo假定用于组织源内容的结构与用于组织渲染站点的结构相同。
Read More »
页面捆绑
使用页面捆绑进行内容组织
Read More »
内容格式
支持HTML和Markdown两种内容格式。
Read More »
图表
使用 fenced code blocks 和 markdown 渲染钩子来展示图表。
Read More »
前置格式
Hugo允许您在内容文件中使用yaml、toml或json来添加前置格式。
Read More »
构建选项
构建选项帮助定义Hugo在构建站点时如何处理给定页面。
Read More »
页面资源
页面资源(图片、其他页面、文档等)具有相对于页面的URL和自己的元数据。
Read More »
图像处理
调整大小、裁剪、旋转、过滤和转换图像。
Read More »
短代码
短代码是在内容文件中调用内置或自定义模板的简单片段。
Read More »
相关内容
在“另请参阅”部分列出相关内容。
Read More »
Sections
将内容组织成部分。
Read More »
内容类型
Hugo是围绕按部分组织的内容构建的。
Read More »
雏形
一个雏形是一个新内容的模板。
Read More »
分类法
Hugo支持用户自定义分类法的功能。
Read More »
内容摘要
Hugo可以生成你的内容的摘要。
Read More »
链接和交叉引用
用于创建文档链接的短代码。
Read More »
URL管理
通过前置数据和站点配置中的设置来控制URL的结构和外观。
Read More »
菜单
通过定义条目、本地化每个条目以及呈现生成的数据结构来创建菜单。
Read More »
静态文件
在网站根目录下以
不作修改的形式
提供服务的文件。
Read More »
目录
Hugo可以自动解析Markdown内容并创建一个在模板中可以使用的目录。
Read More »
评论
Hugo 使用内部的 Disqus 模板,但这并不是唯一能与您的 Hugo 网站配合使用的评论系统。
Read More »
多语言模式
Hugo支持创建多语言网站。
Read More »
语法高亮
Hugo使用Chroma来进行快速的语法高亮。
Read More »
字符串的翻译 Hugo使用go-i18n来支持字符串翻译。查看项目的源代码库以找到能帮助你管理翻译工作流程的工具。 翻译内容被收集自themes/<THEME>/i18n/文件夹(内置在主题中),以及位于项目根目录下的i18n/中的翻译内容。在i18n中,翻译将会被合并,并优先于主题文件夹中的内容。语言文件应根据RFC 5646的规定进行命名,例如en-US.toml,fr.toml等。 还支持使用RFC 5646 § 2.2.7中定义的带有私有使用子标记的人造语言。您可以省略art-x-前缀以简洁起见。例如: art-x-hugolang hugolang 私有使用子标记必须不超过8个字母数字字符。 查询基本翻译 在模板中使用i18n函数如下所示: {{ i18n "home" }} 该函数将搜索"home"的id: i18n/en-US. yaml toml json home: other: 主页 [home] other = '主页' { "home": { "other": "主页" } } 结果将会是 主页 查询带有变量的灵活翻译 通常,您希望在翻译字符串中使用页面变量。为此,在调用i18n时通过传递.上下文: {{ i18n "wordCount" . }} 该函数将会将.上下文传递给"wordCount"的id: i18n/en-US. yaml toml json wordCount: other: 本文章有{{ .WordCount }}个单词。 [wordCount] other = '本文章有{{ .WordCount }}个单词。' { "wordCount": { "other": "本文章有{{ .
Read More »
Read More »