HUGO中文文档

  • 文档
  • 关于Hugo
  • 用例
  • 新闻
  • 官方主题
  • 官方网站
  • 99元/年云主机
  • 关于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 的论坛是一个活跃的用户和开发者社区,他们回答问题,分享知识,并提供示例。在超过20,000个主题中快速搜索往往可以找到你的问题的答案。在提出你的第一个问题之前,请确保阅读了如何提问的相关信息。

以下仅仅是新用户最常提的几个问题。

提示的错误消息表示某项功能不可用。原因是什么?

Hugo 提供了两个版本:标准版和扩展版。借助扩展版,你可以 (a) 在处理图片时编码为 WebP 格式,及 (b) 使用内置的 LibSass 编译器将 Sass 转换为 CSS。使用 Dart Sass 编译器并不需要扩展版。

当你试图使用上述任何一种操作时,如果你正在使用的是 Hugo 的标准版,Hugo 会报出以下错误:

错误: 在你当前的 Hugo 版本中,此功能不可用

为了解决这个问题,卸载标准版,然后安装扩展版。详情请参见安装一节。

为什么当我访问主页时看到"找不到页面"?

在 content/_index.md 文件中:

  • draft 是否被设为 true?
  • date 是否设置为未来的日期?
  • publishDate 是否设置为未来的日期?
  • expiryDate 是否设置为过去的日期?

如果以上问题的答案有任何一个是肯定的,那么你可以改变字段的值,或者使用以下的命令行选项:--buildDrafts,--buildFuture,或 --buildExpired。

为什么特定的部分没有被发布?

在 content/section/_index.md 文件中:

  • draft 是否被设为 true?
  • date 是否设置为未来的日期?
  • publishDate 是否设置为未来的日期?
  • expiryDate 是否设置为过去的日期?

如果以上问题的答案有任何一个是肯定的,那么你可以改变字段的值,或者使用以下的命令行选项:--buildDrafts,--buildFuture,或 --buildExpired。

为什么特定的页面没有被发布?

在 content/section/page.md 文件中,或者在 content/section/page/index.md 文件中:

  • draft 是否被设为 true?
  • date 是否设置为未来的日期?
  • publishDate 是否设置为未来的日期?
  • expiryDate 是否设置为过去的日期?

如果以上问题的答案有任何一个是肯定的,那么你可以改变字段的值,或者使用以下的命令行选项:--buildDrafts,--buildFuture, 或 --buildExpired。

为什么我看不到页面的任何子页面?

你可能有一个 index.md 文件,而不是 _index.md 文件。详情请参见[详情] (/content-management/page-bundles/).

index.md 文件和 _index.md 文件有什么区别?

一个带有 index.md 文件的目录是一个叶子包。带有 _index.md 文件的目录是一个分支包。详情请参见[详情] (/content-management/page-bundles/)。

为什么我的部分模板没有按预期渲染?

你可能在调用部分模板时忘记传递需求的上下文。例如:

{{/* 不正确 */}}
{{ partial "_internal/pagination.html" }}

{{/* 正确 */}}
{{ partial "_internal/pagination.html" . }}

在模板中,为变量赋值时 := 和 = 有什么区别?

使用 := 初始化一个变量,使用 = 为已经初始化过的变量赋值。详情请参见[详情] (https://pkg.go.dev/text/template#hdr-Variables).

当我给列表页面进行分页时,为什么页面集合没有按照规定被筛选?

你可能在同一页面多次调用 Paginate 或 Paginator 方法。详情请参见[详情] (/templates/pagination/#list-paginator-pages).

为什么有两种方式来调用一个短代码(shortcodes)?

如果短代码模板,或者起止短码标签之间的内容包含 markdown,则使用 {{% 短代码 %}} 格式。否则使用 {{< 短码 >}}格式。请参见[详情] (/content-management/shortcodes/).

我能使用环境变量来控制配置吗?

可以。请参见[详情] (/getting-started/configuration/#configure-with-environment-variables).

为什么我从一次构建到下一次看到的输出结果不一致?

最常见的原因是页面冲突(发布两个页面到同一路径)和并发影响。使用--printPathWarnings命令行选项检查页面冲突,并且在 论坛 发帖如果你怀疑有并发问题。

哪些页面方法触发内容渲染?

以下 Page 对象的方法能触发内容渲染:Content,FuzzyWordCount, Len, Plain, PlainWords,ReadingTime,Summary,Truncated, 和 WordCount。

对于其他问题,请访问 论坛。在超过20,000个主题中快速搜索往往可以找到你的问题的答案。在提出你的第一个问题之前,请确保阅读了 如何提问的相关信息。

See also

  • 常见问题解答
Last updated: January 2, 2024: add pagefind for search (5a7343596)
Improve this page
 
 

copyright © opendocs.io 2024

本站点基于hugo官方文档翻译而来,感谢hugo官方团队的贡献和提供如此出色的工具

  • 文档
  • 关于Hugo
  • 用例
  • 新闻
  • 官方主题
  • 官方网站
  • 99元/年云主机
  • 关于Hugo
  • 安装
  • 起步
  • 内容管理
  • 模板
  • 函数
  • 方法
  • 快速参考
  • 变量
  • Hugo模块
  • Hugo管道
  • 命令行
  • 故障排除
  • 开发者工具
  • 托管和部署
  • 贡献
  • 维护