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上托管
贡献
概述
开发
文档
主题
维护
模板
模板是一个包含
模板操作
的HTML文件,位于项目、主题或模块的layouts目录中。请按照下面的顺序查看相关主题,了解模板的选择和创建方法。
模板化
Hugo使用Go的html/template和text/template作为模板的基础。
Read More »
模板查找顺序
Hugo 使用下面的规则来选择给定页面的模板,从最具体的开始。
Read More »
基础模板与块
基础模板和块结构允许您定义主模板的外壳(即页面的框架)。
Read More »
单页模板
在Hugo中,内容的主要展示是通过单个视图来展示的。Hugo会为每个Markdown文件提供对应的单页模板进行渲染。
Read More »
Hugo中的内容列表
在Hugo中,列表在呈现站点首页、部分页面、分类列表或分类术语列表时有特定的含义和用途。
Read More »
首页模板
网站的首页通常与其他页面的格式不同。因此,Hugo使您能够将新站点的首页定义为独特的模板,简化了操作。
Read More »
章节页面模板
用于章节页面的模板是
列表
,因此拥有适用于列出页面的所有变量和方法。
Read More »
分类模板
分类模板包括分类列表页面、分类词汇页面和在单页面模板中使用分类。
Read More »
分页
Hugo 支持对主页、部分页面和分类进行分页。
Read More »
内容视图模板
Hugo 可以呈现你的内容的替代视图,在列表和摘要视图中非常有用。
Read More »
部分模板
部分模板是您列表和页面模板中的更小、上下文感知的组件,可以经济地用来保持模板的DRY。
Read More »
创建自定义短代码
通过使用与单页和列表页面相同的模板语法来创建自己的短代码,您可以扩展Hugo内置的短代码功能。
Read More »
菜单模板
使用菜单变量和方法在模板中渲染菜单。
Read More »
数据模板
除了Hugo内置的变量,您还可以在模板或短代码中指定自定义数据,这些数据可以从本地和动态来源获取。
Read More »
RSS 模板
使用内置的 RSS 模板,或者创建自己的模板。
Read More »
网站地图模板
Hugo 提供了内置的网站地图模板。
Read More »
本地文件模板
Hugo的
readDir
和
readFile
函数使得遍历项目目录结构和将文件内容写入模板变得非常容易。
Read More »
内部模板
Hugo附带了一组模板样板,涵盖了静态网站最常见的用例。
Read More »
Markdown渲染钩子
渲染钩子允许自定义模板覆盖markdown渲染功能。
Read More »
自定义输出格式
Hugo可以输出多种格式的内容,包括日历事件、电子书格式、Google AMP和JSON搜索索引,或任何自定义文本格式。
Read More »
自定义404页面
如果你知道如何创建单页模板,你就可以有无限的选择来创建自定义的404页面。
Read More »
Robots.txt 文件
Hugo 可以像其他模板一样生成自定义的 robots.txt 文件。
Read More »
模板调试
您可以使用 Go 模板的
printf
函数来调试您的 Hugo 模板。这些代码片段提供了一种快速和简便的方式来可视化不同上下文中可用的变量。
Read More »