术语表
A B C D E F G H I K L M N O P R S T U V W Z
动作
参见 模板动作。
原型
新内容的模板。请参阅 详细信息。
参数
传递给 函数、方法 或 简码 的 标量、数组、切片、映射 或 对象。
数组
元素的编号序列。与 Go 的 切片 数据类型不同,数组具有固定长度。数组中的元素可以是标量、切片、映射、页面或其他数组。有关详细信息,请参阅 Go 文档。
布尔值
参见 布尔值。
布尔值
具有两个可能值的数据类型,即 true
或 false
。
分支包
包含 _index.md
文件和零个或多个资源的目录。类似于物理分支,分支包可能具有后代,包括叶包和其他分支包。带有或不带有 _index.md
文件的顶级目录也是分支包。这包括主页。请参阅 详细信息。
构建
生成包含 HTML 文件和资产(例如图像、CSS 和 JavaScript)的静态站点。构建过程包括渲染和资源转换。
包
参见 页面包。
缓存
一种存储数据的软件组件,以便将来对相同数据的请求更快。
链式
在模板中,使用点号连接一个或多个标识符。标识符可以表示方法、对象或字段。例如,.Site.Params.author.name
或 .Date.UTC.Hour
。
CJK
中文、日文和韩文的统称。请参阅详细信息。
CLI
命令行界面。
集合
内容适配器
一个在构建站点时动态创建页面的模板。例如,使用内容适配器从 JSON、TOML、YAML 或 XML 等远程数据源创建页面。请参阅详细信息。
内容格式
用于创建内容的标记语言。通常是 Markdown,但也可能是 HTML、AsciiDoc、Org、Pandoc 或 reStructuredText。请参阅详细信息。
内容类型
从顶级目录名称或在前言中设置的 type
推断的内容分类。content
目录根目录中的页面,包括主页,类型为“页面”。在模板中通过 .Page.Type
访问。请参阅详细信息。
内容视图
使用 .Page.Render
方法调用的模板。请参阅详细信息。
上下文
在模板动作中用点“.”表示,上下文是数据结构中的当前位置。例如,在迭代页面集合时,每次迭代中的上下文都是页面的数据结构。每个模板接收到的上下文取决于模板类型和/或调用方式。请参阅详细信息。
默认排序顺序
页面集合的默认排序顺序。Hugo 按权重排序,然后按日期(降序),然后按链接标题,最后按文件路径排序。
元素
切片或数组的成员。
环境
通常是 development
、staging
或 production
之一,每个环境可能根据配置和模板逻辑表现出不同的行为。例如,在生产环境中,您可能会缩小和指纹化 CSS,但这在开发环境中可能没有意义。
使用 hugo server
命令运行内置开发服务器时,环境设置为 development
。使用 hugo
命令构建站点时,环境设置为 production
。要覆盖环境值,请使用 --environment
命令行标志或 HUGO_ENVIRONMENT
环境变量。
要在模板中确定当前环境,请使用 hugo.Environment
函数。
字段
前言中预定义的键值对,例如 date
或 title
。另请参阅参数。
标志
传递给命令行程序的选项,以一个或两个连字符开头。请参阅详细信息。
浮点数
请参阅浮点数。
浮点数
具有小数部分的数值数据类型。例如,3.14159
。
片段
URL 的最后一段,以哈希(#
)标记开头,引用页面上 HTML 元素的 id
属性。
前言
每个内容页面开头的元数据,通过格式特定的分隔符与内容分隔开。请参阅详细信息。
函数
在模板动作中使用,函数接受一个或多个参数并返回一个值。与方法不同,函数不与对象关联。请参阅详细信息。
全局资源
assets
目录中的文件,或挂载到 assets
目录的任何目录中的文件。使用resources.Get
、resources.GetMatch
、resources.Match
或 resources.ByType
函数捕获一个或多个全局资源。
无头包
一个未发布的叶子或分支包,其内容和资源可以包含在其他页面中。请参阅构建选项。
标识符
一个表示变量、方法、对象或字段的字符串。它必须符合 Go 的语言规范,以字母或下划线开头,后跟零个或多个字母、数字或下划线。
整数
请参阅整数。
整数
一种不带小数部分的数值数据类型。例如,42
。
国际化
使本地化成为可能的软件设计和开发工作。请参阅W3C 定义。缩写为 i18n。
区间
一个区间是两个端点之间的一系列数字:闭区间、开区间或半开区间。
-
闭区间,用方括号表示,包括其端点。例如,[0, 1] 是
0 <= x <= 1
的区间。 -
开区间,用圆括号表示,不包括其端点。例如,(0, 1) 是
0 < x < 1
的区间。 -
半开区间仅包括其一个端点。例如,(0, 1] 是 左开 区间,其中
0 < x <= 1
,而 [0, 1) 是 右开 区间,其中0 <= x < 1
。
类型
请参阅页面类型。
布局
请参阅模板。
叶子包
一个包含 index.md 文件和零个或多个资源的目录。类似于物理叶子,叶子包位于分支的末尾。它没有后代。请参阅详情。
词法分析器
一个软件组件,用于识别输入文本中的关键字、标识符、运算符、数字和编程语言的其他基本构建块。
列表页
任何在上下文中接收页面集合的页面类型。 这包括主页、部分页面、分类页面和术语页面。
列表模板
任何渲染列表页面的模板。 这包括主页、部分、分类和术语模板。
本地化
使站点适应语言和地区要求的调整。 这包括翻译、特定于语言的媒体、日期和货币格式等。请参阅详情和W3C 定义。缩写为 l10n。
逻辑路径
v0.123.0 版本新增从文件路径派生的页面或页面资源标识符,不包括其扩展名和语言标识符。此值既不是文件路径也不是 URL。从相对于 content
目录的文件路径开始,Hugo 通过剥离文件扩展名和语言标识符,转换为小写,然后将空格替换为连字符来确定逻辑路径。请参阅示例。
映射
一组无序的元素,每个元素都由唯一的键索引。请参阅Go 文档了解详情。
Markdown 属性
一个属性列表,包含一个或多个键值对,用空格或逗号分隔,并用大括号括起来。将 Markdown 属性应用于图像和块级元素,包括块引用、围栏代码块、标题、水平规则、列表、段落和表格。请参阅详情。
序列化
将数据结构转换为序列化对象。例如,将映射转换为 JSON 字符串。请参阅反序列化。
方法
在模板动作中使用并与对象关联,方法接受零个或多个参数,并返回一个值或执行一个动作。例如,.IsHome
是 .Page
对象的方法,如果当前页面是主页,则返回 true
。另请参阅函数。
模块
像主题一样,模块是原型、资产、内容、数据、模板、翻译表、静态文件或配置设置的打包组合。模块可以作为新站点的基础,也可以用于增强现有站点。请参阅详情。
节点
一类页面类型,包括 home
、section
、taxonomy
和 term
。
空操作
“无操作”的缩写形式,noop 是一个不执行任何操作的语句。
对象
一个带有或不带有相关方法的数据结构。
有序分类 对象上调用 Alphabetical
或 ByCount
方法创建,其中 Taxonomy
对象是一个映射,有序分类是一个切片,每个元素都是一个对象,其中包含术语及其加权页面的切片。
输出格式
Hugo 在构建站点时为每个页面生成一个或多个文件。例如,在渲染主页、章节、分类和术语页面时,Hugo 会生成一个 HTML 文件和一个 RSS 文件。HTML 和 RSS 都是内置的输出格式。可以创建多种输出格式,并根据页面类型控制生成,或者为一个或多个页面启用一种或多种输出格式。请参阅详情。
页面包
一个同时封装内容和相关资源的目录。页面包有两种类型:叶子包和分支包。请参阅详情。
页面集合
一个 Page
对象的切片。
页面类型
页面的分类,可以是 home
、page
、section
、taxonomy
或 term
中的一种。请参阅详情。
请注意,还有 RSS
、sitemap
、robotsTXT
和 404
页面类型,但这些仅在渲染各自页面类型时可用,因此不在任何 Pages
集合中可用。
页面资源
页面包中的一个文件。使用 Page
对象上的任何Resources
方法捕获一个或多个页面资源。
分页器
在分页期间创建,分页器包含列表页面的一个子集以及指向其他分页器的导航链接。
分页
将列表页面拆分为两个或多个子集。
分页
分页器集合
分页器的集合。
参数
通常,是指站点或页面级别的用户定义的键值对,但也可能指配置设置或参数。另请参阅字段。
局部模板
从任何其他模板(包括短代码、渲染钩子和其他局部模板)调用的模板。局部模板要么渲染某些内容,要么返回某些内容。局部模板也可以调用自身,例如,遍历数据结构。
永久链接
已发布资源或已渲染页面的绝对 URL,包括协议和主机。
管道
请参阅管道。
管道
在模板操作中,管道是值、函数调用或方法调用的可能链式序列。管道中的函数和方法可以接受多个参数。
可以使用管道字符“|”分隔一系列命令来链接管道。在链接的管道中,每个命令的结果都作为最后一个参数传递给后续命令。管道中最后一个命令的输出是管道的值。有关详细信息,请参阅Go 文档。
发布
请参阅构建。
常规页面
页面类型为“page”的内容。另请参阅章节页面。
相对永久链接
已发布资源或已渲染页面的相对于主机的 URL。
渲染钩子
远程资源
位于远程服务器上的文件,可通过 HTTP 或 HTTPS 使用 resources.GetRemote
函数访问。
资源
构建过程使用的任何文件,用于增强或生成内容、结构、行为或演示。例如:图像、视频、内容片段、CSS、Sass、JavaScript 和数据。
资源类型
资源的媒体类型的主要类型。诸如 Markdown、HTML、AsciiDoc、Pandoc、reStructuredText 和 Emacs Org Mode 等内容文件具有 page
资源类型。其他资源类型包括 image
、video
等。使用 Resource
对象上的 ResourceType
方法检索资源类型。
标量
暂存区
从概念上讲,它是一个带有方法来设置、获取、更新和删除值的映射。使用 Scratch
或 Store
方法将数据结构附加到 Page
对象,或者使用 newScratch
函数创建本地范围的暂存区。
章节
顶层内容目录,或任何带有 _index.md
文件的内容目录。带有 _index.md
文件的内容目录也称为分支捆绑包。章节模板在上下文中接收一个或多个页面集合。请参阅详细信息。
章节页面
具有“section”页面类型的内容。通常是当前章节内的常规页面和/或章节页面的列表。另请参阅常规页面。
短代码
从 Markdown 中调用的模板,接受零个或多个参数。请参阅详细信息。
切片
元素的编号序列。与 Go 的 数组数据类型不同,切片是动态大小的。切片中的元素可以是标量、数组、映射、页面或其他切片。有关详细信息,请参阅 Go 文档。
字符串
字节序列。例如,"6 乘以 7 是多少?"
。
字符串字面量(解释型)
解释型字符串字面量是双引号之间的字符序列,如“foo”。在引号内,可以出现任何字符,除了换行符和未转义的双引号。引号之间的文本形成字面量的值,并解释反斜杠转义。请参阅详细信息。
字符串字面量(原始型)
原始字符串字面量是反引号之间的字符序列,如 `bar`。在反引号内,可以出现任何字符,除了反引号。反斜杠没有特殊含义,并且字符串可能包含换行符。原始字符串字面量内的回车符 ('\r') 将从原始字符串值中丢弃。请参阅详细信息。
分类权重
在前面板中定义,并且每个分类法都是唯一的,此权重确定包含在 Taxonomy
对象中的页面集合的排序顺序。请参阅详细信息。
分类法
用于对内容进行分类的相关术语组。例如,“颜色”分类法可能包括“红色”、“绿色”和“蓝色”等术语。请参阅详细信息。
分类法对象
分类法页面
具有“taxonomy”页面类型的内容。通常是给定分类法中的术语的列表。
模板
一个包含模板操作的文件,位于项目、主题或模块的 layouts
目录中。请参阅详细信息。
模板操作
在模板中的数据评估或控制结构,以“{{” 和“}}” 分隔。有关详细信息,请参阅 Go 文档。
术语
术语页面
具有“term”页面类型的内容。通常是具有给定术语的常规页面和章节页面的列表。
主题
一个包含原型、资源、内容、数据、模板、翻译表、静态文件或配置设置的打包组合。主题可以作为新站点的基础,或用于增强现有站点。另请参阅模块。
令牌
格式字符串中的标识符,以冒号开头,并在渲染时替换为值。例如,在格式字符串中使用令牌来表示永久链接和日期。
类型
请参阅内容类型。
反序列化
将序列化对象转换为数据结构。例如,将 JSON 文件转换为您可以在模板中访问的映射。请参阅序列化。
变量
用户定义的标识符,以 $
符号开头,表示任何数据类型的值,在模板动作中初始化或赋值。例如,$foo
和 $bar
是变量。
遍历
递归遍历嵌套数据结构。例如,渲染多级菜单。
权重
用于在按权重排序的集合中定位元素。使用非零整数分配权重。较轻的项浮到顶部,而较重的项沉到底部。未加权或零加权的元素放置在集合的末尾。权重通常分配给页面、菜单项、语言和输出格式。
加权页面
包含在Taxonomy
对象中,加权页面是一个映射,包含两个元素:一个Page
对象,以及其在 front matter 中定义的分类权重。使用 Page
和 Weight
键访问这些元素。
零时间
零时间是公元 0001 年 1 月 1 日 00:00:00 UTC。按照 RFC3339 格式化,零时间是 0001-01-01T00:00:00-00:00。