hugo.Store
语法
hugo.Store
返回
maps.Scratch
全局 hugo.Store
函数创建一个持久的 暂存区,用于存储和操作数据。要创建局部作用域,请使用 newScratch
函数。
方法
Set
设置给定键的值。
{{ hugo.Store.Set "greeting" "Hello" }}
Get
获取给定键的值。
{{ hugo.Store.Set "greeting" "Hello" }}
{{ hugo.Store.Get "greeting" }} → Hello
Add
将给定值添加到给定键的现有值。
对于单个值,Add
接受支持 Go 的 +
运算符的值。如果键的第一个 Add
是数组或切片,则后续添加将追加到该列表中。
{{ hugo.Store.Set "greeting" "Hello" }}
{{ hugo.Store.Add "greeting" "Welcome" }}
{{ hugo.Store.Get "greeting" }} → HelloWelcome
{{ hugo.Store.Set "total" 3 }}
{{ hugo.Store.Add "total" 7 }}
{{ hugo.Store.Get "total" }} → 10
{{ hugo.Store.Set "greetings" (slice "Hello") }}
{{ hugo.Store.Add "greetings" (slice "Welcome" "Cheers") }}
{{ hugo.Store.Get "greetings" }} → [Hello Welcome Cheers]
SetInMap
接受 key
、mapKey
和 value
,并将 mapKey
和 value
的映射添加到给定的 key
。
{{ hugo.Store.SetInMap "greetings" "english" "Hello" }}
{{ hugo.Store.SetInMap "greetings" "french" "Bonjour" }}
{{ hugo.Store.Get "greetings" }} → map[english:Hello french:Bonjour]
DeleteInMap
接受 key
和 mapKey
,并从给定的 key
中删除 mapKey
的映射。
{{ hugo.Store.SetInMap "greetings" "english" "Hello" }}
{{ hugo.Store.SetInMap "greetings" "french" "Bonjour" }}
{{ hugo.Store.DeleteInMap "greetings" "english" }}
{{ hugo.Store.Get "greetings" }} → map[french:Bonjour]
GetSortedMapValues
返回按 mapKey
排序的 key
中的值数组。
{{ hugo.Store.SetInMap "greetings" "english" "Hello" }}
{{ hugo.Store.SetInMap "greetings" "french" "Bonjour" }}
{{ hugo.Store.GetSortedMapValues "greetings" }} → [Hello Bonjour]
Delete
删除给定的键。
{{ hugo.Store.Set "greeting" "Hello" }}
{{ hugo.Store.Delete "greeting" }}
确定值
Store
方法通常用于在简码、由简码调用的局部模板或 Markdown 渲染钩子中设置暂存区值。在这三种情况下,暂存区值在 Hugo 渲染页面内容之前是不确定的。
如果您需要从父模板访问暂存区值,并且父模板尚未渲染页面内容,您可以通过将返回值分配给 noop 变量来触发内容渲染
{{ $noop := .Content }}
{{ hugo.Store.Get "mykey" }}
您还可以使用 ContentWithoutSummary
、FuzzyWordCount
、Len
、Plain
、PlainWords
、ReadingTime
、Summary
、Truncated
和 WordCount
方法触发内容渲染。例如
{{ $noop := .WordCount }}
{{ hugo.Store.Get "mykey" }}