<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Hugo on 今天也要好好吃饭</title><link>https://jiumu07.github.io/tags/hugo/</link><description>Recent content in Hugo on 今天也要好好吃饭</description><generator>Hugo -- 0.169.0</generator><language>zh-cn</language><copyright>就暮</copyright><lastBuildDate>Thu, 12 Nov 2026 00:00:00 +0800</lastBuildDate><atom:link href="https://jiumu07.github.io/tags/hugo/index.xml" rel="self" type="application/rss+xml"/><item><title>这个博客的第一篇文章</title><link>https://jiumu07.github.io/posts/hello-world/</link><pubDate>Thu, 12 Nov 2026 00:00:00 +0800</pubDate><guid>https://jiumu07.github.io/posts/hello-world/</guid><description>站点搭好了，先写一篇占位文章，顺便把主题的几个常用写法记在这里。</description><content:encoded><![CDATA[<p>从一个空目录到能跑起来的博客，中间踩的坑都记在这儿。</p>
<h2 id="为什么用-hugo">为什么用 Hugo</h2>
<p>静态站点没有数据库、没有后台，写完 Markdown 提交仓库就完事。构建一次通常不到一秒，改完立刻能看到效果，写东西的时候不会被工具打断。</p>
<blockquote class="markdown-alert markdown-alert-note">
    <p class="markdown-alert-title">
        <svg class="octicon octicon-info" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z"></path></svg>备注
    </p>
    <p>主题支持 GitHub 原生风格的提示块，<code>&gt; [!NOTE]</code>、<code>&gt; [!TIP]</code>、<code>&gt; [!WARNING]</code> 都可以直接用。</p>
</blockquote><h2 id="怎么写一篇新文章">怎么写一篇新文章</h2>
<p>在项目根目录执行：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo new content posts/my-new-post.md
</span></span></code></pre></div><p>生成的草稿默认 <code>draft: true</code>，本地预览加 <code>-D</code> 就能看到，正式构建时会被忽略。</p>
<p>文章开头的 Front Matter 常用字段：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nn">---</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="l">标题</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">date</span><span class="p">:</span><span class="w"> </span><span class="ld">2026-11-12</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">draft</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
</span></span></span><span class="line"><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></span><span class="line"><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;Markdown&#34;</span><span class="p">]</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">summary</span><span class="p">:</span><span class="w"> </span><span class="l">列表页显示的摘要，留空会自动截取正文</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">pin</span><span class="p">:</span><span class="w"> </span><span class="m">1</span><span class="w">          </span><span class="c"># 置顶，正整数，越小越靠前</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">ShowToc</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="cl"><span class="nt">cover</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l">cover.jpg  </span><span class="w"> </span><span class="c"># 同目录下的封面图</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">alt</span><span class="p">:</span><span class="w"> </span><span class="l">封面</span><span class="w">
</span></span></span><span class="line"><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>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td><code>pin</code></td>
					<td>首页置顶，数字越小越前</td>
			</tr>
			<tr>
					<td><code>summary</code></td>
					<td>列表摘要，不写则自动截断</td>
			</tr>
			<tr>
					<td><code>cover.image</code></td>
					<td>封面图，和文章放同一目录即可</td>
			</tr>
	</tbody>
</table>
<p>文章里的图片放在 <code>posts/文章名/</code> 目录下，用相对路径引用就行，主题会自动做灯箱和尺寸优化。</p>
<blockquote class="markdown-alert markdown-alert-tip">
    <p class="markdown-alert-title">
        <svg class="octicon octicon-light-bulb" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="M8 1.5c-2.363 0-4 1.69-4 3.75 0 .984.424 1.625.984 2.304l.214.253c.223.264.47.556.673.848.284.411.537.896.621 1.49a.75.75 0 0 1-1.484.208c-.04-.29-.149-.538-.303-.761-.172-.249-.4-.516-.641-.801l-.226-.267C2.43 7.947 2 6.945 2 5.25 2 2.025 4.545 0 8 0s6 2.025 6 5.25c0 1.695-.43 2.697-1.04 3.421l-.227.267c-.24.285-.469.552-.64.801-.155.223-.263.472-.304.761a.75.75 0 0 1-1.483-.208c.084-.594.337-1.079.621-1.49.204-.292.45-.584.673-.848l.214-.253c.56-.679.984-1.32.984-2.304 0-2.06-1.637-3.75-4-3.75ZM5.75 12h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1 0-1.5ZM7.5 14.5a.75.75 0 0 1 .75-.75h1a.75.75 0 0 1 0 1.5h-1a.75.75 0 0 1-.75-.75Z"></path></svg>建议
    </p>
    <p>搜索用的是 Pagefind，构建后跑一次索引脚本才能搜到内容，具体命令见项目根目录的 README。</p>
</blockquote><p>先写到这，接下来慢慢填内容。</p>
]]></content:encoded></item></channel></rss>