https://www.leanku.com/tags/%E5%86%99%E4%BD%9C/Recent content in 写作 on Leanku 的博客Hugozh-cnFri, 20 Dec 2024 00:00:00 +0000https://www.leanku.com/post/hugo-period/theme-content/Fri, 20 Dec 2024 00:00:00 +0000https://www.leanku.com/post/hugo-period/theme-content/<h2 id="front-matter-全字段">Front Matter 全字段</h2> <p>每篇文章开头用 <code>---</code> 包裹的 YAML 就是 front matter。完整字段：</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="nn">---</span><span class="w"> </span></span></span><span class="line"><span class="ln"> 2</span><span class="cl"><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;文章标题&#34;</span><span class="w"> </span><span class="c"># 必填</span><span class="w"> </span></span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nt">date</span><span class="p">:</span><span class="w"> </span><span class="ld">2025-01-15</span><span class="w"> </span><span class="c"># 必填：发布时间（决定排序与归档）</span><span class="w"> </span></span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="nt">lastmod</span><span class="p">:</span><span class="w"> </span><span class="ld">2025-01-20</span><span class="w"> </span><span class="c"># 可选：详情页显示&#34;最后更新于&#34;</span><span class="w"> </span></span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;摘要，列表页显示&#34;</span><span class="w"> </span><span class="c"># 强烈建议手写（见&#34;摘要&#34;一节）</span><span class="w"> </span></span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nt">featured</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;images/hero.jpg&#34;</span><span class="w"> </span><span class="c"># 特色图（static/ 下路径；也可用 Page Bundle）</span><span class="w"> </span></span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="nt">slug</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;my-post&#34;</span><span class="w"> </span><span class="c"># 可选：URL 末尾段（默认取文件名）</span><span class="w"> </span></span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="nt">categories</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">&#34;技术&#34;</span><span class="p">]</span><span class="w"> </span><span class="c"># 分类（可多个）</span><span class="w"> </span></span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="nt">tags</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">&#34;hugo&#34;</span><span class="p">,</span><span class="w"> </span><span class="s2">&#34;写作&#34;</span><span class="p">]</span><span class="w"> </span><span class="c"># 标签（可多个）</span><span class="w"> </span></span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="nt">author</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;Leanku&#34;</span><span class="w"> </span><span class="c"># 可选：覆盖站点默认作者</span><span class="w"> </span></span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="nt">sticky</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="c"># 可选：列表页显示&#34;精选&#34;徽标</span><span class="w"> </span></span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nt">draft</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="c"># 草稿（hugo server -D 才显示）</span><span class="w"> </span></span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nt">keywords</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">&#34;hugo&#34;</span><span class="p">,</span><span class="w"> </span><span class="s2">&#34;主题&#34;</span><span class="p">]</span><span class="w"> </span><span class="c"># 可选：meta keywords（缺省用 tags）</span><span class="w"> </span></span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="nt">canonicalURL</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;&#34;</span><span class="w"> </span><span class="c"># 可选：手动指定 canonical（转载声明用）</span><span class="w"> </span></span></span><span class="line"><span class="ln">15</span><span class="cl"><span class="nt">robotsNoIndex</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="c"># 可选：单篇屏蔽索引</span><span class="w"> </span></span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nt">images</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">&#34;images/hero.jpg&#34;</span><span class="p">]</span><span class="w"> </span><span class="c"># 可选：OG/JSON-LD 图片列表（缺省取 featured）</span><span class="w"> </span></span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nn">---</span><span class="w"> </span></span></span></code></pre></div><h2 id="特色图两种用法">特色图：两种用法</h2> <table> <thead> <tr> <th>方式</th> <th>说明</th> <th>示例</th> </tr> </thead> <tbody> <tr> <td><code>featured</code> 参数</td> <td>指向 <code>static/</code> 下路径</td> <td><code>featured: &quot;images/covers/theme-intro.svg&quot;</code></td> </tr> <tr> <td>Page Bundle</td> <td>文章目录 <code>index.md</code> + 图片</td> <td><code>content/post/xxx/index.md</code> + <code>hero.jpg</code>，自动取包内第一张图</td> </tr> </tbody> </table> <p>列表页特色图统一 <strong>2:1 比例裁切</strong>（<code>object-fit: cover</code>），建议源图 ≥ 1200×600； 本站示例用的是同比例的 SVG 封面，文字不会裁切。</p>