非站点级变量/参数查询的Hugo定义

Question

我正在使用 Hugo 通用主题。我是静态站点生成器的新手。这个问题是为熟悉 hugo 模板的人准备的。在layouts/partials/features.html我们可以看到在哪里$element.name渲染$element.name.description：{{ if isset .Site.Params "features" }}{{ if .Site.Params.features.enable }}{{ if gt (len .Site.Data.features) 0 }}<section class="bar background-white">    <div class="container">        {{ range $index, $element := sort .Site.Data.features "weight" }}        {{ if eq (mod $index 3) 0 }}        <div class="col-md-12">            <div class="row">        {{ end }}                <div class="col-md-4">                    <div class="box-simple">                        <div class="icon">                            <i class="{{ .icon }}"></i>                        </div>                        <h3>{{ $element.name }}</h3>                        <p>{{ $element.description | markdownify }}</p>                    </div>                </div>        {{ if or (eq (mod $index 3) 2) (eq $index (sub (len $.Site.Data.features) 1 )) }}            </div>        </div>        {{ end }}        {{ end }}    </div></section>{{ end }}{{ end }}{{ end }}本例中需要渲染的数据定义如下data/features/consulting.yaml：weight: 4name: "Consulting"icon: "fa fa-lightbulb-o"description: "Fifth abundantly made Give sixth hath..." 我应该怎么做才能将新变量添加到文件中yaml，以便稍后html在 hugo 编译站点时通过文件呈现。我试图简单地添加另一个参数param1，然后在 html 文件中插入相应的行，<p>{{ $element.param1 | markdownify }}</p>如下描述段落但出现错误错误 2018/08/23 10:42:42 在“”中呈现“主页”时出错：模板：index.html:22:11：在<部分“features.ht ...> 处执行“index.html”：错误调用部分：模板：partials/features.html:18:56：在以下位置执行“partials/features.html”：markdownify 的参数数量错误：想要 1 得到 0显然我似乎无法正确定义变量，但我应该在哪里做呢？我可以向 中添加另一个站点变量config.toml，但我想了解如何制作可在yaml/frontmatter类型条目中定义的页面特定变量。我尝试阅读有关 hugo 变量的内容，但在什么是变量和什么是短代码方面陷入困境。非常感谢您对此示例的帮助。去雨果雨果简码

Answer 1

好吧，我找到了一个有效的答案，但我仍然不完全理解它如何适应 Hugo 变量系统，因此非常欢迎更好的答案和/或评论。

看起来很简单。我必须url在文件中定义变量yaml：

name: "History"

position: "Hx"

url: "/blog/2018/08/23/01-history/"

然后html 像这样在文件中使用：

{{ if .url }} 

    <a href="{{ .url }}"> 

    <h5>{{ .name }}</h5>

    </a>

{{ else }}

    <h5>{{ .name }}</h5>

{{ end }}

它所做的是将 .name 放在链接标记中，如果 .url 是在 .yaml 中定义的。如果给出绝对 URL，这也有效。因此，页面变量似乎被称为.myVariable. $element.name如上所述，模板作者在另一个地方使用，这让我感到困惑。

我也可以将 frontmatter 中定义的参数称为.Params.name

我在https://github.com/devcows/hugo-universal-theme/pull/166找到了指针并测试了调整模板；它运作良好。