Page

ContentWithoutSummary

返回给定页面渲染后的内容,但不含内容摘要。

签名
PAGE.ContentWithoutSummary
返回类型
template.HTML

这一页解决什么问题

列表页已经用 .Summary 展示了开头,详情页里往往不想再重复一遍这段开头。ContentWithoutSummary 返回去掉摘要之后的正文 HTML,正适合「摘要单独排版 + 其余正文」的版式。

什么时候用,什么时候别用

该用:

  • 页面顶部已经有独立的摘要区块,正文区要从摘要之后开始;
  • 摘要与正文之间有分隔线、广告位、作者信息等插入内容。

别用:

  • 想输出完整正文 → 用 Content;
  • 想输出摘要本身 → 用 .Summary;
  • 摘要定义在前置元数据(summary = "…")里 → 返回值与 .Content 相同(上游已说明),此时用本方法没有意义。

用法

在使用手动或自动内容摘要时,Page 对象上的 ContentWithoutSummary 方法会把 Markdown 与短代码渲染为 HTML,并在结果中剔除内容摘要。

如果你在前置元数据中定义内容摘要,ContentWithoutSummary 方法的返回值与 Content 相同。

go-html-template
{{ .ContentWithoutSummary }}

完整示例:摘要与正文各输出一次

最小站点:content/docs/guide/alpha.md 的正文第一段之后有一行 `

(手动摘要标记)。模板放在 layouts/_default/single.html`:

layouts/_default/single.htmlgo-html-template
<div class="body">{{ .ContentWithoutSummary }}</div>

hugo --source <站点目录> --ignoreCache 构建后,正文部分渲染为:

html
<div class="body"><h2 id="section-1">Section 1</h2>
<p>正文一。</p>
<h3 id="section-11">Section 1.1</h3>
<p>正文二。</p>
<h2 id="section-2">Section 2</h2>
<span class="hello">你好,短代码</span>

<p>正文三。</p>
</div>

同一个页面上,.Content 的开头则是摘要那段:

html
<p>这是摘要部分,位于 more 注释之前。</p>
<h2 id="section-1">Section 1</h2>

你应当看到什么:.Summary 里的那句「这是摘要部分,位于 more 注释之前。」不在正文里了,其余内容与 .Content 完全一致;标题的 id、短代码的输出都保留。

返回值边界(实测)

测量条件:Hugo 0.167.0 extended,Windows;alpha.md 用 <!--more--> 手动定义摘要,beta.md 正文很短、没有摘要标记。

情况 结果 是否报错
正文含 <!--more--> 返回该标记之后的渲染 HTML 否
正文没有摘要标记 与 .Content 相同 否
摘要在前置元数据中定义 与 .Content 相同(上游已说明) 否
页面没有正文 空字符串 否
返回类型 template.HTML(按 HTML 输出) 否

常见坑

类别 症状 真因 怎么修
没报错但结果不对 返回值与 .Content 一模一样 摘要定义在前置元数据里,或正文没有摘要标记 使用 <!--more-->,或接受「摘要即正文开头」的行为
没报错但结果不对 摘要段落仍出现在正文里 把 .Summary 和 .Content 混用,而不是 .ContentWithoutSummary 正文区改用 .ContentWithoutSummary
版式出现多余空行 正文开头有一行空白 渲染结果本身以换行开头 用 CSS 的 :first-child 处理,或在 <div> 内不加额外空行

更多排查入口见故障排查。