Hugo 中文文档

Abs

Fri, 02 Oct 2026 00:00:00 +0800

{{ $d = time.ParseDuration "-3h" }}
{{ $d.Abs }} → 3h0m0s

AllPages

Fri, 02 Oct 2026 00:00:00 +0800

（0.156.0 起弃用）

详见详情。

and

Fri, 02 Oct 2026 00:00:00 +0800

关于真值与假值

假值包括 false、0、任何 nil 指针或接口值、任何长度为零的数组、切片、映射或字符串，以及零值 time.Time。

其余一切值都是真值。

用法

and 函数从左到右依次求值，一旦结果可以确定就立即返回。

js.Babel

Fri, 02 Oct 2026 00:00:00 +0800

js.Babel 函数使用 Babel 转换 JavaScript。

准备

第 1 步

安装 Node.js。

第 2 步

在项目根目录安装所需的 Node 包。例如，安装 Babel 的核心编译器、它的命令行界面，以及根据目标环境转译现代 JavaScript 的预设：

npm install --save-dev @babel/core @babel/cli @babel/preset-env

第 3 步

在项目根目录创建 Babel 配置文件。例如，使用环境预设，目标为 Google Chrome 79 或更高版本：

babel.config.mjs

export default {
  presets: [
    [
      '@babel/preset-env',
      {
        targets: {
          chrome: "79"
        }
      }
    ]
  ]
};

第 4 步

把 JS 文件放进 assets/js 目录。

第 5 步

在项目配置中把 babel 可执行文件加入 Hugo 的 security.exec.allow 列表：

[security.exec]
  allow = ['^(dart-)?sass$', '^go$', '^git$', '^node$', '^postcss$', '^babel$']

第 6 步

创建一个 partial 模板来处理这段 JavaScript：

layouts/_partials/js.html

{{ with resources.Get "js/main.js" }}
  {{ $opts := dict
    "minified" (cond hugo.IsDevelopment false true)
    "noComments" (cond hugo.IsDevelopment false true)
    "sourceMap" (cond hugo.IsDevelopment "inline" "none")
  }}
  {{ with . | js.Babel $opts }}
    {{ if hugo.IsDevelopment }}
      <script src="{{ .RelPermalink }}"></script>
    {{ else }}
      {{ with . | fingerprint }}
        <script src="{{ .RelPermalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous"></script>
      {{ end }}
    {{ end }}
  {{ end }}
{{ end }}

第 7 步

从 base 模板调用这个 partial 模板：

layouts/baseof.html

<head>
  {{ partial "js.html" . }}
</head>

选项

js.Babel 函数接受一个选项映射。

encoding.Base64Decode

Fri, 02 Oct 2026 00:00:00 +0800

{{ "SHVnbw==" | base64Decode }} → Hugo

用 base64Decode 函数可以解码 API 的响应。例如，调用 GitHub API 得到的响应中，包含仓库 README 文件的 base64 编码表示：

https://api.github.com/repos/gohugoio/hugo/readme

要取回并渲染其中的内容：

{{ $url := "https://api.github.com/repos/gohugoio/hugo/readme" }}
{{ with try (resources.GetRemote $url) }}
  {{ with .Err }}
    {{ errorf "%s" . }}
  {{ else with .Value }}
    {{ with . | transform.Unmarshal }}
      {{ .content | base64Decode | markdownify }}
    {{ end }}
  {{ else }}
    {{ errorf "Unable to get remote resource %q" $url }}
  {{ end }}
{{ end }}

css.Build

Fri, 02 Oct 2026 00:00:00 +0800

（0.158.0 新增）

用 css.Build 函数可以：

递归地把 CSS 文件中的 @import 语句替换为被导入文件的内容
为兼容浏览器做语法转换
为兼容浏览器添加厂商前缀
压缩打包后的 CSS 代码
生成 source map

若 @import 语句带有媒体查询、特性查询或级联层（cascade layer）赋值，该函数会把导入的内容包进对应的 @media、@supports 或 @layer 规则中。

ByDate

Fri, 02 Oct 2026 00:00:00 +0800

按日期排序时，取值由项目配置决定，默认使用前置元数据中的 date 字段。

{{ range .Pages.ByDate }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

要改为降序排列：

{{ range .Pages.ByDate.Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

ByName

Fri, 02 Oct 2026 00:00:00 +0800

Sort 方法返回给定菜单，其条目按 name 排序。

请看下面的菜单定义：

[[menus.main]]
name = 'Services'
pageRef = '/services'
weight = 10

[[menus.main]]
name = 'About'
pageRef = '/about'
weight = 20

[[menus.main]]
name = 'Contact'
pageRef = '/contact'
weight = 30

要按 name 排序条目：

<ul>
  {{ range .Site.Menus.main.ByName }}
    <li><a href="{{ .URL }}">{{ .Name }}</a></li>
  {{ end }}
</ul>

Hugo 渲染结果为：

<ul>
  <li><a href="/about/">About</a></li>
  <li><a href="/contact">Contact</a></li>
  <li><a href="/services/">Services</a></li>
</ul>

也可以使用 sort 函数对菜单条目排序。例如按 name 降序排序：

Children

Fri, 02 Oct 2026 00:00:00 +0800

渲染嵌套菜单时请使用 Children 方法。

项目配置如下：

[[menus.main]]
name = 'Products'
pageRef = '/product'
weight = 10

[[menus.main]]
name = 'Product 1'
pageRef = '/products/product-1'
parent = 'Products'
weight = 1

[[menus.main]]
name = 'Product 2'
pageRef = '/products/product-2'
parent = 'Products'
weight = 2

模板如下：

<ul>
  {{ range .Site.Menus.main }}
    <li>
      <a href="{{ .URL }}">{{ .Name }}</a>
      {{ if .HasChildren }}
        <ul>
          {{ range .Children }}
            <li><a href="{{ .URL }}">{{ .Name }}</a></li>
          {{ end }}
        </ul>
      {{ end }}
    </li>
  {{ end }}
</ul>

Hugo 渲染出如下 HTML：

Colors

Fri, 02 Oct 2026 00:00:00 +0800

Colors 方法返回processable image（可处理的图像）中最主要颜色的切片，从最主要到最次要排序。

用法

该方法很快，但如果先把图像缩小，就可以从更小的资源中提取颜色，从而进一步提升性能。

First

Fri, 02 Oct 2026 00:00:00 +0800

使用 First 方法在分页器之间构建导航。

{{ $pages := where site.RegularPages "Type" "posts" }}
{{ $paginator := .Paginate $pages }}

{{ range $paginator.Pages }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

{{ with $paginator }}
  <ul>
    {{ with .First }}
      <li><a href="{{ .URL }}">First</a></li>
    {{ end }}
    {{ with .Prev }}
      <li><a href="{{ .URL }}">Previous</a></li>
    {{ end }}
    {{ with .Next }}
      <li><a href="{{ .URL }}">Next</a></li>
    {{ end }}
    {{ with .Last }}
      <li><a href="{{ .URL }}">Last</a></li>
    {{ end }}
  </ul>
{{ end }}

hash.FNV32a

Fri, 02 Oct 2026 00:00:00 +0800

{{ hash.FNV32a "Hello world" }} → 1498229191

Get

Fri, 02 Oct 2026 00:00:00 +0800

参数可以按位置或按名称指定。在 Markdown 中调用短代码时，位置参数和命名参数只能用其中一种，不能混用。

位置参数

下面这个短代码调用使用位置参数：

content/about.md

{{< myshortcode "Hello" "world" >}}

要按位置获取参数：

diagrams.Goat

Fri, 02 Oct 2026 00:00:00 +0800

在代码块渲染钩子中使用时很有用：diagrams.Goat 函数返回由给定 GoAT 标记创建的 SVGDiagram 对象。

方法

可在 SVGDiagram 对象上调用下列方法。

Inner: (template.HTML) 返回不带外层 svg 元素的 SVG 子元素，便于你自己创建外层包装。
Wrapped: (template.HTML) 返回包在 svg 元素中的 SVG 子元素。
Width: (int) 返回渲染后图表的宽度，单位像素。
Height: (int) 返回渲染后图表的高度，单位像素。

GoAT 图表

Hugo 通过内建代码块渲染钩子原生支持 GoAT 图表。

crypto.Hash

Fri, 02 Oct 2026 00:00:00 +0800

ALGORITHM 取 md5、sha1、sha256（默认）、sha384、sha512 之一：

{{ crypto.Hash "sha256" "Hello world" }} → 64ec88ca00b268e5ba1a35678a1b5316d212f4f366b2477232534a8aeca37f3c
{{ "Hello world" | crypto.Hash "sha512" }} → b7f783baed8297f0db917462184ff4f08e69c2d5e5f79a942600f9725f58ce1f29c18139bf80b06c0fff2bdd34738452ecf40c488c22a7e3d80cdf6f9c1c0d47

省略算法时默认使用 sha256：

MediaType

Fri, 02 Oct 2026 00:00:00 +0800

要使用该方法，你必须先通过 Get 或 Canonical 方法，从页面的 OutputFormats 集合中选出特定的 output format（输出格式）。

示例

{{ with .Site.Home.OutputFormats.Get "rss" }}
  {{ with .MediaType }}
    {{ .Type }} → application/rss+xml
    {{ .MainType }} → application
    {{ .SubType }} → rss
    {{ .Suffixes }} → [rss]
    {{ .FirstSuffix.Suffix }} → rss
  {{ end }}
{{ end }}

方法

在 MediaType 对象上使用这些方法。

openapi3.Unmarshal

Fri, 02 Oct 2026 00:00:00 +0800

用法

传给 openapi3.Unmarshal 函数的资源必须是 OpenAPI 文档，通常是 JSON 或 YAML 格式。这个资源可以是全局资源，也可以是远程资源。

该函数会自动解析并纳入所有外部引用（本地与远程都包括），返回一份完整的 OpenAPI 描述，完整描述某个 API 的对外接口及其语义。

404 页面

Thu, 01 Oct 2026 00:00:00 +0800

自定义 404 页面

在站点根目录输出一个 404 错误页面，需要在 layouts 目录的根下创建 404 模板。注意它与普通页面模板的位置不同：单页模板、列表模板都放在子目录中（或者按 Hugo 的模板查找规则层层向上查找），而 404 模板只认 layouts 根目录，放在别处不会被采用。

figure

Thu, 01 Oct 2026 00:00:00 +0800

示例

正文里这样写：

{{< figure
  src="/images/examples/zion-national-park.jpg"
  alt="A photograph of Zion National Park"
  link="https://www.nps.gov/zion/index.htm"
  caption="Zion National Park"
  class="ma0 w-75"
>}}

Hugo 渲染出这样的 HTML：

<figure class="ma0 w-75">
  <a href="https://www.nps.gov/zion/index.htm">
    <img
      src="/images/examples/zion-national-park.jpg"
      alt="A photograph of Zion National Park"
    >
  </a>
  <figcaption>
    <p>Zion National Park</p>
  </figcaption>
</figure>

参数

src: （string）img 元素的 src 属性。取值通常是页面资源（page resource）或全局资源（global resource）。
alt: （string）img 元素的 alt 属性。
width: （int）img 元素的 width 属性。
height: （int）img 元素的 height 属性。
loading: （string）img 元素的 loading 属性。
class: （string）figure 元素的 class 属性。
link: （string）包裹 img 元素的锚点元素的 href 属性。
target: （string）包裹 img 元素的锚点元素的 target 属性。
rel: （rel）包裹 img 元素的锚点元素的 rel 属性。
title: （string）在 figurecaption 元素内位于顶部，包裹在 h4 元素中。
caption: （string）在 figurecaption 元素内位于底部，可以包含纯文本或 Markdown。
attr: （string）在 figurecaption 元素内出现在图注旁边，可以包含纯文本或 Markdown。
attrlink: （string）包裹署名文字的锚点元素的 href 属性。

图片位置

figure 短代码解析内部 Markdown 目标地址时，先查找匹配的页面资源（page resource），找不到时回退到匹配的全局资源（global resource）。远程地址原样传递，无法解析目标地址时不会抛出错误或警告。

Glob 模式

Thu, 01 Oct 2026 00:00:00 +0800

什么是 Glob 模式

Glob 模式（glob pattern）是用一组通配符来匹配多个值的写法。它把多个目标压缩成一个简短的表达式，因此适合对成组的数据或配置做批量处理，例如一次匹配某个目录下的全部图片，或一次匹配若干种文件扩展名。

hugo

Thu, 01 Oct 2026 00:00:00 +0800

hugo 是主命令，用来构建项目。Hugo 是用 Go 编写的快速、灵活的静态站点生成器（static site generator）。不带任何子命令直接执行 hugo，就是一次完整构建。

编辑器

Thu, 01 Oct 2026 00:00:00 +0800

简介

Hugo 社区使用的编辑器相当分散，因此针对几款最流行的文本编辑器，都有人开发了插件，用来自动化工作流中的一部分环节。这些插件大多提供语法高亮、代码片段与补全，个别还会代为调用外部命令。下面按编辑器分组列出。

参与开发

Thu, 01 Oct 2026 00:00:00 +0800

概述

参与 Hugo 项目有很多种方式，不限于写代码。你可以：

在论坛回答问题（中文交流见中文分类）；
改进文档；
关注议题队列；
创建或改进主题；
修复缺陷。

文档相关的议题与拉取请求请提交到文档仓库。完整的贡献指南见 CONTRIBUTING.md。

功能提案

如果你有改进或新功能的想法，请先在论坛的 Feature 分类发起新话题。这样做有助于：

常见问题

Thu, 01 Oct 2026 00:00:00 +0800

关于这份常见问题

Hugo 的论坛是活跃的用户与开发者社区，两万多个主题中往往已经有人回答过你的问题；中文提问请用官方论坛的中文分类。提问之前，请先阅读论坛的求助指南。下面列出新用户最常问到的若干问题。

提示某个功能不可用

当你在所安装的版本（edition）中使用它并不提供的功能时，Hugo 会抛出这个错误：

this feature is not available in this edition of Hugo

解决办法是安装另一个版本，详见安装。

简介

Thu, 01 Oct 2026 00:00:00 +0800

Hugo 是什么

Hugo 是用 Go 编写的静态站点生成器，针对速度做了优化，并以灵活性为设计目标。它提供先进的模板系统和快速的资源管道，渲染一个完整站点通常只需数秒，很多时候还要更短。

由于框架灵活、原生支持多语言，并具备强大的分类系统，Hugo 被广泛用于创建以下类型的站点：

企业、政府、非营利组织、教育、新闻、活动和项目站点
文档站点
图片作品集
落地页
商业、专业和个人博客
简历与 CV

这些用途覆盖了从内容发布到项目展示的多数场景；多语言支持与分类系统让同一套站点结构可以同时服务于不同语言、不同维度的内容组织。

简介

Thu, 01 Oct 2026 00:00:00 +0800

模块是什么

Hugo 用模块（module）作为最基本的组织单位。一个模块既可以是一个完整的 Hugo 项目，也可以是更小的、可复用的片段，用来提供 Hugo 七类组件（component）中的一类或几类：

简介

Thu, 01 Oct 2026 00:00:00 +0800

在 assets 中查找资源

这里讨论的是全局资源与远程资源：

全局资源: assets 目录中的文件，或位于任何挂载到 assets 目录的目录中的文件。
远程资源: 位于远程服务器上、可通过 HTTP 或 HTTPS 访问的文件。

若资源的作用域属于某个 Page，请参阅页面资源一节。

简介

Thu, 01 Oct 2026 00:00:00 +0800

默认渲染与自定义渲染

把 Markdown 渲染为 HTML 时，渲染钩子会覆盖这一转换过程。每个钩子都是一个模板，受支持的元素类型各对应一个模板：

快速开始

Thu, 01 Oct 2026 00:00:00 +0800

本教程带你完成四件事：创建项目、添加内容、配置项目、发布项目。

准备条件

开始之前，请先：

安装 Hugo。任何发行版（edition）都可以，但版本不能低于 v0.158.0，安装方式见安装 Hugo。
安装 Git。

你还需要熟悉命令行的基本操作。

内容格式

Thu, 01 Oct 2026 00:00:00 +0800

内容格式（content format）指内容源文件所使用的标记语言。Hugo 首先依据前置元数据（front matter）里的 markup 标识符选择内容渲染器，只有未提供该字段时才回退到文件扩展名。格式是逐文件判定的，因此同一个站点里可以混用多种格式：

配置简介

Thu, 01 Oct 2026 00:00:00 +0800

常规设置与配置分区

项目配置中的每个顶层键要么是常规设置，要么是配置分区。

常规设置是单个值，例如 baseURL 或 title。配置分区则把相关的嵌套设置归为一组，例如 markup、menus 或 params。

用 hugo deploy 部署

Thu, 01 Oct 2026 00:00:00 +0800

hugo deploy 命令可以把你的站点部署到 Amazon S3、Azure Blob Storage 或 Google Cloud Storage。

说明： 该功能需要 deploy 或 extended/deploy 版本的 Hugo，详见安装 Hugo。

前提条件

已经完成快速开始，或者已经有一个准备部署上线的 Hugo 站点。
拥有要部署到的服务商账号：AWS、Azure 或 Google Cloud。

在 Linux 上安装

Thu, 01 Oct 2026 00:00:00 +0800

发行版（edition）

Hugo 提供多个发行版（edition）。除非需要额外功能，否则使用 standard 版即可。

特性	standard	deploy (1)	extended	extended/deploy
核心功能	✓	✓	✓	✓
直接部署到云端 (2)	✗	✓	✗	✓
LibSass 支持 (3)	✗	✗	✓	✓

deploy 版自 v0.159.2 起提供。
把站点直接部署到 Google Cloud Storage 存储桶、AWS S3 存储桶或 Azure Storage 容器，详见用 hugo deploy 部署。
通过内置的 LibSass 把 Sass 转译为 CSS。内置 LibSass 已在 v0.153.0 中弃用，并将在未来版本中移除，请改用任何 edition 都可用的 Dart Sass 转译器。

前置依赖（prerequisites）

Git、Go、Dart Sass 在 Hugo 的日常使用中很常见，但并非所有场景都需要。

urls.AbsLangURL

Fri, 02 Oct 2026 00:00:00 +0800

单语言与多语言配置都可以使用该函数。返回的 URL 取决于：

输入是否以斜杠（/）开头
项目配置中的 baseURL
语言前缀（如果有）

下文示例使用这份项目配置：

defaultContentLanguage = 'en'
defaultContentLanguageInSubdir = true
[languages.en]
weight = 1
[languages.es]
weight = 2

输入不以斜杠开头

如果输入不以斜杠开头，结果 URL 中的路径相对于项目配置里的 baseURL。

Add

Fri, 02 Oct 2026 00:00:00 +0800

{{ $t := time.AsTime "2023-01-27T23:44:58-08:00" }}

{{ $d1 = time.ParseDuration "3h20m10s" }}
{{ $d2 = time.ParseDuration "-3h20m10s" }}

{{ $t.Add $d1 }} → 2023-01-28 03:05:08 -0800 PST
{{ $t.Add $d2 }} → 2023-01-27 20:24:48 -0800 PST

collections.After

Fri, 02 Oct 2026 00:00:00 +0800

基本用法

下面演示 after 与 slice 函数配合使用：

{{ $data := slice "one" "two" "three" "four" }}
<ul>
  {{ range after 2 $data }}
    <li>{{ . }}</li>
  {{ end }}
</ul>

上面的模板渲染为：

<ul>
  <li>three</li>
  <li>four</li>
</ul>

与 first 配合使用

你可以把 after 与 first 函数以及 Hugo 强大的排序方法组合使用。假设你在 example.org/articles 有一个 section 页面，共有 10 篇文章，但希望模板只显示两行：

Aliases

Fri, 02 Oct 2026 00:00:00 +0800

Page 对象上的 Aliases 方法返回 aliases 前置元数据字段中定义的值，形式为服务器相对 URL，并按当前内容维度解析。

Aliases 方法适合用来生成 _redirects 文件：其中为每个别名给出源 URL、目标 URL 与 HTTP 状态码。Cloudflare、GitLab Pages、Netlify 等托管服务都可以使用 _redirects 文件。

Alphabetical

Fri, 02 Oct 2026 00:00:00 +0800

Taxonomy 对象上的 Alphabetical 方法返回一个 ordered taxonomy（有序分类法），按 term（术语）的字母序排序。

Taxonomy 对象是 map（映射），而有序分类法是一个 slice（切片），其中每个元素都是一个对象，包含术语以及该术语的 weighted pages（加权页面）切片。

在使用 Taxonomy 方法之前，需要先取得一个 Taxonomy 对象。

取得 Taxonomy 对象

考虑如下项目配置：

time.AsTime

Fri, 02 Oct 2026 00:00:00 +0800

概述

Hugo 提供了函数与方法来格式化、本地化、解析、比较与操作日期/时间值。要对日期/时间值的字符串表示做这些操作，必须先使用 time.AsTime 函数把它们转换成 time.Time 值。

{{ $t := "2023-10-15T13:18:50-07:00" }}
{{ time.AsTime $t }} → 2023-10-15 13:18:50 -0700 PDT (time.Time)

可解析的字符串

如上所示，第一个参数必须是可解析的日期/时间值字符串表示。例如：

格式	时区
`2023-10-15T13:18:50-07:00`	`America/Los_Angeles`
`2023-10-15T13:18:50-0700`	`America/Los_Angeles`
`2023-10-15T13:18:50Z`	`Etc/UTC`
`2023-10-15T13:18:50`	默认为 `Etc/UTC`
`2023-10-15`	默认为 `Etc/UTC`
`15 Oct 2023`	默认为 `Etc/UTC`

最后三个示例不是完整限定的时间，默认使用 Etc/UTC 时区。

images.AutoOrient

Fri, 02 Oct 2026 00:00:00 +0800

用法

创建滤镜：

{{ $filter := images.AutoOrient }}

用 images.Filter 函数应用该滤镜：

{{ with resources.Get "images/original.jpg" }}
  {{ with . | images.Filter $filter }}
    <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
  {{ end }}
{{ end }}

也可以在 Resource 对象上调用 Filter 方法应用该滤镜：

{{ with resources.Get "images/original.jpg" }}
  {{ with .Filter $filter }}
    <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
  {{ end }}
{{ end }}

path.Base

Fri, 02 Oct 2026 00:00:00 +0800

{{ path.Base "a/news.html" }} → news.html
{{ path.Base "news.html" }} → news.html
{{ path.Base "a/b/c" }} → c
{{ path.Base "/x/y/z/" }} → z
{{ path.Base "" }} → .

encoding.Base64Encode

Fri, 02 Oct 2026 00:00:00 +0800

{{ "Hugo" | base64Encode }} → SHVnbw==

BaseURL

Fri, 02 Oct 2026 00:00:00 +0800

项目配置：

baseURL = 'https://example.org/docs/'

模板：

{{ .Site.BaseURL }} → https://example.org/docs/

js.Batch

Fri, 02 Oct 2026 00:00:00 +0800

批次 ID 用于创建该批次的基础目录，允许使用正斜杠。js.Batch 函数返回一个对象，其 API 结构如下：

block

Fri, 02 Oct 2026 00:00:00 +0800

用法

block 是「定义模板」的简写：

{{ define "name" }} T1 {{ end }}

随后在当前位置执行它：

{{ template "name" pipeline }}

典型用法是先定义一组根模板，再通过重新定义其中的 block 模板来定制它们。

layouts/baseof.html

<body>
  <main>
    {{ block "main" . }}
      {{ print "default value if 'main' template is empty" }}
    {{ end }}
  </main>
</body>

layouts/page.html

{{ define "main" }}
  <h1>{{ .Title }}</h1>
  {{ .Content }}
{{ end }}

layouts/section.html

{{ define "main" }}
  <h1>{{ .Title }}</h1>
  {{ .Content }}
  {{ range .Pages }}
    <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
  {{ end }}
{{ end }}

更多信息参见 Go 的 text/template 文档。

ByExpiryDate

Fri, 02 Oct 2026 00:00:00 +0800

按过期日期排序时，取值由项目配置决定，默认使用前置元数据中的 expiryDate 字段。

{{ range .Pages.ByExpiryDate }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

要改为降序排列：

{{ range .Pages.ByExpiryDate.Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

resources.ByType

Fri, 02 Oct 2026 00:00:00 +0800

媒体类型通常是 image、text、audio、video 或 application 之一。

{{ range resources.ByType "image" }}
  <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}

ByWeight

Fri, 02 Oct 2026 00:00:00 +0800

ByWeight 方法返回给定菜单，其条目先按 weight、再按 name、最后按 identifier 排序。这是默认的排序方式。

请看下面的菜单定义：

[[menus.main]]
identifier = 'about'
name = 'About'
pageRef = '/about'
weight = 20

[[menus.main]]
identifier = 'services'
name = 'Services'
pageRef = '/services'
weight = 10

[[menus.main]]
identifier = 'contact'
name = 'Contact'
pageRef = '/contact'
weight = 30

要按 weight、再按 name、最后按 identifier 排序条目：

transform.CanHighlight

Fri, 02 Oct 2026 00:00:00 +0800

{{ transform.CanHighlight "go" }} → true
{{ transform.CanHighlight "klingon" }} → false

cast.ToFloat

Fri, 02 Oct 2026 00:00:00 +0800

输入为十进制（base 10）时：

{{ float 11 }} → 11 (float64)
{{ float "11" }} → 11 (float64)

{{ float 11.1 }} → 11.1 (float64)
{{ float "11.1" }} → 11.1 (float64)

{{ float 11.9 }} → 11.9 (float64)
{{ float "11.9" }} → 11.9 (float64)

输入为二进制（base 2）时：