<?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>JIUMU07 on 今天也要好好吃饭</title><link>https://huangth.xyz/</link><description>Recent content in JIUMU07 on 今天也要好好吃饭</description><generator>Hugo -- 0.169.0</generator><language>zh-cn</language><copyright>就暮</copyright><lastBuildDate>Fri, 13 Nov 2026 00:00:00 +0800</lastBuildDate><atom:link href="https://huangth.xyz/index.xml" rel="self" type="application/rss+xml"/><item><title>从零把博客部署上线：Hugo + 极简主题 + GitHub Pages</title><link>https://huangth.xyz/posts/hugo-deploy-guide/</link><pubDate>Fri, 13 Nov 2026 00:00:00 +0800</pubDate><guid>https://huangth.xyz/posts/hugo-deploy-guide/</guid><description>从 PowerShell 环境检查开始，一步步把 Hugo 博客推到 GitHub Pages。全程网页点击，不装额外命令行工具，主题配置的坑和真实踩过的报错都记在里面。</description><content:encoded><![CDATA[<p>这篇文章记录本站从空目录到上线的完整过程。环境是 Windows + PowerShell 7（命令名 <code>pwsh</code>，不是系统自带的那个）。</p>
<p>在目前状态下，其实自己手搓一个博客其实是一件很简单的事情，只需要向dsh许个愿就行了，但是肯定不如自己做浪费时间：-）。</p>
<h2 id="一先把环境备齐">一、先把环境备齐</h2>
<p>四样东西，缺一样都不行：</p>
<table>
	<thead>
			<tr>
					<th>工具</th>
					<th>版本要求</th>
					<th>用途</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>PowerShell</td>
					<td><strong>7+</strong>，命令名 <code>pwsh</code></td>
					<td>执行所有命令</td>
			</tr>
			<tr>
					<td>Git</td>
					<td>任意较新版本</td>
					<td>版本管理、推送</td>
			</tr>
			<tr>
					<td>Node.js</td>
					<td>≥ 18（建议 22 LTS）</td>
					<td>只用于生成搜索索引</td>
			</tr>
			<tr>
					<td>Hugo</td>
					<td>≥ 0.158，<strong>extended</strong> 版</td>
					<td>生成静态站</td>
			</tr>
	</tbody>
</table>
<p>顺序建议就按上面这个来：PowerShell 是载体，Git 决定代码能不能推上去，Node 和 Hugo 分别负责搜索索引和构建。</p>
<h3 id="装-powershell-7">装 PowerShell 7</h3>
<p>Windows 自带的那个叫 <strong>Windows PowerShell 5.1</strong>，命令是 <code>powershell</code>（或 <code>powershell.exe</code>），<strong>不要用它</strong>。有三个实际影响：</p>
<ul>
<li><strong>不支持 <code>&amp;&amp;</code> 串联命令</strong>，<code>npm run build &amp;&amp; npm run search</code> 这类写法直接报语法错</li>
<li><strong>默认只开 TLS 1.0/1.1</strong>，用 <code>Invoke-WebRequest</code> 从 GitHub 下载东西会失败</li>
<li><strong>输出编码是 GBK</strong>，Hugo 的中文日志、<code>git log</code> 里的中文提交信息容易变成乱码</li>
</ul>
<p>新版的命令是 <strong><code>pwsh</code></strong>，和 5.1 可以共存，装了不冲突。先用这条判断：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">pwsh</span> <span class="n">-v</span>
</span></span></code></pre></div><ul>
<li>输出 <code>PowerShell 7.x.x</code> → 已装好，直接用</li>
<li>提示 <code>pwsh : 无法将&quot;pwsh&quot;项识别为 cmdlet...</code> → 没装</li>
</ul>
<p>装：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">winget</span> <span class="n">install</span> <span class="p">-</span><span class="n">-id</span> <span class="n">Microsoft</span><span class="p">.</span><span class="py">PowerShell</span> <span class="p">-</span><span class="n">-source</span> <span class="n">winget</span>
</span></span></code></pre></div><p>winget 不通就去 <code>github.com/PowerShell/PowerShell/releases</code> 下 <code>PowerShell-&lt;版本&gt;-win-x64.msi</code>，双击安装。</p>
<p>装完<strong>重开终端</strong>，再执行一次 <code>pwsh -v</code> 确认。之后所有命令都在 <code>pwsh</code> 里跑。</p>
<p>VS Code 里顺手把默认终端换过来，否则你每次按 <code>Ctrl + `</code> 打开的仍然是 5.1：</p>
<ol>
<li><code>Ctrl + Shift + P</code></li>
<li>输入 <code>Terminal: Select Default Profile</code></li>
<li>选 <strong>PowerShell 7</strong>，不是 <strong>Windows PowerShell</strong></li>
</ol>
<h3 id="装-git">装 Git</h3>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">winget</span> <span class="n">install</span> <span class="p">-</span><span class="n">-id</span> <span class="n">Git</span><span class="p">.</span><span class="py">Git</span> <span class="n">-e</span> <span class="p">-</span><span class="n">-source</span> <span class="n">winget</span>
</span></span></code></pre></div><p>或者去 <code>git-scm.com/download/win</code> 下安装包。安装过程中有个 PATH 选项，要选 <strong>Git from the command line and also from 3rd-party software</strong>，否则终端里敲 <code>git</code> 会提示找不到命令。</p>
<p>装完重开终端验证：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">git</span> <span class="p">-</span><span class="n">-version</span>
</span></span></code></pre></div><p>然后<strong>必须</strong>配一下提交身份，否则第一次 <code>git commit</code> 会直接报 <code>Author identity unknown</code>：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">git</span> <span class="n">config</span> <span class="p">-</span><span class="n">-global</span> <span class="n">user</span><span class="p">.</span><span class="py">name</span> <span class="s2">&#34;你的名字&#34;</span>
</span></span><span class="line"><span class="cl"><span class="n">git</span> <span class="n">config</span> <span class="p">-</span><span class="n">-global</span> <span class="n">user</span><span class="p">.</span><span class="py">email</span> <span class="s2">&#34;你的邮箱&#34;</span>
</span></span></code></pre></div><p>不想暴露真实邮箱的话，用 GitHub 提供的匿名地址 <code>&lt;ID&gt;+&lt;用户名&gt;@users.noreply.github.com</code>。其中 ID 在 GitHub 的 <strong>Settings → Emails</strong> 页面能看到。用它提交，记录照样算在你账号名下。</p>
<h3 id="装-nodejs">装 Node.js</h3>
<p>只有生成搜索索引用得上，不需要写任何前端代码。</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">winget</span> <span class="n">install</span> <span class="p">-</span><span class="n">-id</span> <span class="n">OpenJS</span><span class="p">.</span><span class="py">NodeJS</span><span class="p">.</span><span class="py">LTS</span> <span class="n">-e</span> <span class="p">-</span><span class="n">-source</span> <span class="n">winget</span>
</span></span></code></pre></div><p>装的是 LTS 版，验证：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">node</span> <span class="n">-v</span>
</span></span><span class="line"><span class="cl"><span class="n">npm</span> <span class="n">-v</span>
</span></span></code></pre></div><p>两个都输出版本号就行。需要同时维护多个 Node 版本可以上 <code>nvm-windows</code>，这个项目用不到。</p>
<p>国内网络如果 <code>npm install</code> 慢，可以换镜像（可选，Hugo 构建本身不依赖 npm 源）：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">npm</span> <span class="n">config</span> <span class="nb">set </span><span class="n">registry</span> <span class="n">https</span><span class="err">:</span><span class="p">//</span><span class="n">registry</span><span class="p">.</span><span class="py">npmmirror</span><span class="p">.</span><span class="py">com</span>
</span></span></code></pre></div><h3 id="装-hugo">装 Hugo</h3>
<p>winget 最省事：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">winget</span> <span class="n">install</span> <span class="n">Hugo</span><span class="p">.</span><span class="py">Hugo</span><span class="p">.</span><span class="py">Extended</span>
</span></span></code></pre></div><p>如果 winget 卡住或者公司网络限制了商店，就直接下便携版：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="c"># 到 github.com/gohugoio/hugo/releases 找 hugo_extended_&lt;版本&gt;_windows-amd64.zip</span>
</span></span><span class="line"><span class="cl"><span class="c"># 解压后把 hugo.exe 放到一个固定目录，比如 D:\hugo\hugo.exe</span>
</span></span><span class="line"><span class="cl"><span class="n">D:</span><span class="p">\</span><span class="n">hugo</span><span class="p">\</span><span class="n">hugo</span><span class="p">.</span><span class="py">exe</span> <span class="n">version</span>
</span></span></code></pre></div><p>然后把目录加进用户 PATH（改完要<strong>重开终端</strong>才生效）：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="nv">$bin</span> <span class="p">=</span> <span class="s2">&#34;D:\hugo&#34;</span>
</span></span><span class="line"><span class="cl"><span class="nv">$p</span> <span class="p">=</span> <span class="p">[</span><span class="no">Environment</span><span class="p">]::</span><span class="n">GetEnvironmentVariable</span><span class="p">(</span><span class="s2">&#34;Path&#34;</span><span class="p">,</span> <span class="s2">&#34;User&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="k">if</span> <span class="p">(</span><span class="nv">$p</span> <span class="o">-notlike</span> <span class="s2">&#34;*</span><span class="nv">$bin</span><span class="s2">*&#34;</span><span class="p">)</span> <span class="p">{</span>
</span></span><span class="line"><span class="cl">    <span class="p">[</span><span class="no">Environment</span><span class="p">]::</span><span class="n">SetEnvironmentVariable</span><span class="p">(</span><span class="s2">&#34;Path&#34;</span><span class="p">,</span> <span class="s2">&#34;</span><span class="p">$(</span><span class="nv">$p</span><span class="p">.</span><span class="py">TrimEnd</span><span class="p">(</span><span class="s1">&#39;;&#39;</span><span class="p">))</span><span class="s2">;</span><span class="nv">$bin</span><span class="s2">&#34;</span><span class="p">,</span> <span class="s2">&#34;User&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl"><span class="p">}</span>
</span></span></code></pre></div><h3 id="最后验一遍">最后验一遍</h3>
<p>在 <code>pwsh</code> 里依次执行，四条都有输出就说明环境齐了：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">pwsh</span> <span class="n">-v</span>
</span></span><span class="line"><span class="cl"><span class="n">git</span> <span class="p">-</span><span class="n">-version</span>
</span></span><span class="line"><span class="cl"><span class="n">node</span> <span class="n">-v</span>
</span></span><span class="line"><span class="cl"><span class="n">hugo</span> <span class="n">version</span>
</span></span></code></pre></div><p><code>hugo version</code> 的输出里必须带 <code>+extended</code>：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">hugo v0.169.0-1da10fc44701c566b1669cdb2d12638f155138bd+extended windows/amd64
</span></span></code></pre></div><p>没有 <code>+extended</code> 的部分图片处理（webp 封面等）会失败，主题也可能报错。装了普通版就重装 extended 版。</p>
<h2 id="二建站">二、建站</h2>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">hugo</span> <span class="n">new</span> <span class="n">site</span> <span class="nb">my-blog</span>
</span></span><span class="line"><span class="cl"><span class="nb">cd my-blog</span>
</span></span><span class="line"><span class="cl"><span class="n">git</span> <span class="n">init</span>
</span></span></code></pre></div><p>Hugo 会生成 <code>archetypes/ content/ layouts/ static/ themes/ hugo.yaml</code> 这一套骨架。<code>hugo.yaml</code> 一开始长这样：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">baseURL</span><span class="p">:</span><span class="w"> </span><span class="l">https://example.org/</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">locale</span><span class="p">:</span><span class="w"> </span><span class="l">en-us</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">My New Hugo Project</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="l">theme:jijian</span><span class="w">
</span></span></span></code></pre></div><p>注意最后一行——<strong>这是错的</strong>。YAML 里键值之间必须有空格，<code>theme:jijian</code> 会被解析成一个叫 <code>theme:jijian</code> 的键，等于没设主题。我第一次就是这么翻车的，症状是整站渲染成没有任何样式的裸 HTML，而且不报错。</p>
<p>正确写法是 <code>theme: jijian</code>。</p>
<h3 id="装主题">装主题</h3>
<p>本站用的是<a href="https://github.com/hcllmsx/hugo-jijian" target="_blank" rel="noopener noreferrer">极简 jijian</a>
，基于 PaperMod 二次开发，中文排版和搜索做得比较细。用 git submodule 装：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">git</span> <span class="n">submodule</span> <span class="n">add</span> <span class="n">https</span><span class="err">:</span><span class="p">//</span><span class="n">github</span><span class="p">.</span><span class="n">com</span><span class="p">/</span><span class="n">hcllmsx</span><span class="p">/</span><span class="nb">hugo-jijian</span><span class="p">.</span><span class="py">git</span> <span class="n">themes</span><span class="p">/</span><span class="n">jijian</span>
</span></span></code></pre></div><p>用 submodule 的好处是主题更新可以直接 <code>git submodule update --remote</code>；代价是<strong>克隆仓库时必须带 <code>--recursive</code></strong>，否则 <code>themes/jijian</code> 是个空目录，构建直接失败。CI 里也要显式开启（后面会写）。</p>
<h2 id="三配置几个必须改对的地方">三、配置：几个必须改对的地方</h2>
<p>完整的 <code>hugo.yaml</code> 比较长，这里只列容易出错的几处。</p>
<h3 id="locale-和分页">locale 和分页</h3>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">locale</span><span class="p">:</span><span class="w"> </span><span class="l">zh-cn</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">defaultContentLanguage</span><span class="p">:</span><span class="w"> </span><span class="l">zh-cn</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">hasCJKLanguage</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="c"># 新版分页配置，旧的 paginate 键已废弃</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">pagination</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">pagerSize</span><span class="p">:</span><span class="w"> </span><span class="m">10</span><span class="w">
</span></span></span></code></pre></div><p><code>languageCode</code> 已经被 Hugo 弃用，改用 <code>locale</code>。分页也从顶层的 <code>paginate: 10</code> 改成了 <code>pagination.pagerSize</code>，写旧的虽然还能跑但会有警告。</p>
<h3 id="菜单">菜单</h3>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">menus</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">main</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="nt">identifier</span><span class="p">:</span><span class="w"> </span><span class="l">posts</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">name</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="w">      </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l">/posts/</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">weight</span><span class="p">:</span><span class="w"> </span><span class="m">10</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="nt">identifier</span><span class="p">:</span><span class="w"> </span><span class="l">archives</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">name</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="w">      </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l">/archives/</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">weight</span><span class="p">:</span><span class="w"> </span><span class="m">20</span><span class="w">
</span></span></span></code></pre></div><p>这里有个隐性约束：主题会在菜单里做 <code>site.GetPage .KeyName</code>，靠 <code>identifier</code> 反查真实页面。<strong><code>identifier</code> 必须能对应到已存在的页面</strong>，否则模板取值拿到 nil，构建会报错。所以 <code>/archives/</code> 这种菜单项，必须真的建一个 <code>content/archives.md</code>。</p>
<h3 id="pwa-manifest-的后缀坑">PWA manifest 的后缀坑</h3>
<p>主题带了 <code>layouts/index.manifest.json</code>，但默认情况下这个文件永远生成不出来，构建日志里会提示：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">WARN found no layout file for &#34;manifest&#34; for kind &#34;home&#34;
</span></span></code></pre></div><p>原因是 Hugo 内置的 <code>application/manifest+json</code> 媒体类型后缀是 <code>webmanifest</code>，而主题模板的文件名是 <code>.json</code>，对不上。解决办法是覆盖媒体类型后缀：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">mediaTypes</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">application/manifest+json</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">suffixes</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">&#34;json&#34;</span><span class="p">]</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">outputFormats</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">manifest</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">mediaType</span><span class="p">:</span><span class="w"> </span><span class="l">application/manifest+json</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">baseName</span><span class="p">:</span><span class="w"> </span><span class="l">manifest</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">isPlainText</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">rel</span><span class="p">:</span><span class="w"> </span><span class="l">manifest</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">outputs</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">home</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="l">HTML</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="l">RSS</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="l">manifest</span><span class="w">
</span></span></span></code></pre></div><h3 id="图标别漏">图标别漏</h3>
<p>主题的 <code>head.html</code> 里写死了一串默认路径，不补文件就是一排 404：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">href=&#34;https://huangth.xyz/favicon.ico&#34;
</span></span><span class="line"><span class="cl">href=&#34;https://huangth.xyz/favicon-16x16.png&#34;
</span></span><span class="line"><span class="cl">href=&#34;https://huangth.xyz/favicon-32x32.png&#34;
</span></span><span class="line"><span class="cl">href=&#34;https://huangth.xyz/apple-touch-icon.png&#34;
</span></span><span class="line"><span class="cl">href=&#34;https://huangth.xyz/safari-pinned-tab.svg&#34;
</span></span></code></pre></div><p>准备这几个文件扔进 <code>static/</code> 就行。没有现成的图标可以用 Python 的 Pillow 画一个，比找图标站快：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"><span class="line"><span class="cl"><span class="kn">from</span> <span class="nn">PIL</span> <span class="kn">import</span> <span class="n">Image</span><span class="p">,</span> <span class="n">ImageDraw</span><span class="p">,</span> <span class="n">ImageFont</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">for</span> <span class="n">size</span> <span class="ow">in</span> <span class="p">(</span><span class="mi">192</span><span class="p">,</span> <span class="mi">512</span><span class="p">):</span>
</span></span><span class="line"><span class="cl">    <span class="n">img</span> <span class="o">=</span> <span class="n">Image</span><span class="o">.</span><span class="n">new</span><span class="p">(</span><span class="s2">&#34;RGBA&#34;</span><span class="p">,</span> <span class="p">(</span><span class="n">size</span><span class="p">,</span> <span class="n">size</span><span class="p">),</span> <span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">))</span>
</span></span><span class="line"><span class="cl">    <span class="n">d</span> <span class="o">=</span> <span class="n">ImageDraw</span><span class="o">.</span><span class="n">Draw</span><span class="p">(</span><span class="n">img</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">d</span><span class="o">.</span><span class="n">rounded_rectangle</span><span class="p">([</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">size</span> <span class="o">-</span> <span class="mi">1</span><span class="p">,</span> <span class="n">size</span> <span class="o">-</span> <span class="mi">1</span><span class="p">],</span> <span class="n">radius</span><span class="o">=</span><span class="nb">int</span><span class="p">(</span><span class="n">size</span> <span class="o">*</span> <span class="mf">0.22</span><span class="p">),</span> <span class="n">fill</span><span class="o">=</span><span class="p">(</span><span class="mi">31</span><span class="p">,</span> <span class="mi">35</span><span class="p">,</span> <span class="mi">40</span><span class="p">,</span> <span class="mi">255</span><span class="p">))</span>
</span></span><span class="line"><span class="cl">    <span class="n">font</span> <span class="o">=</span> <span class="n">ImageFont</span><span class="o">.</span><span class="n">truetype</span><span class="p">(</span><span class="s2">&#34;C:/Windows/Fonts/segoeuib.ttf&#34;</span><span class="p">,</span> <span class="nb">int</span><span class="p">(</span><span class="n">size</span> <span class="o">*</span> <span class="mf">0.6</span><span class="p">))</span>
</span></span><span class="line"><span class="cl">    <span class="n">box</span> <span class="o">=</span> <span class="n">d</span><span class="o">.</span><span class="n">textbbox</span><span class="p">((</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">),</span> <span class="s2">&#34;J&#34;</span><span class="p">,</span> <span class="n">font</span><span class="o">=</span><span class="n">font</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">w</span><span class="p">,</span> <span class="n">h</span> <span class="o">=</span> <span class="n">box</span><span class="p">[</span><span class="mi">2</span><span class="p">]</span> <span class="o">-</span> <span class="n">box</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">box</span><span class="p">[</span><span class="mi">3</span><span class="p">]</span> <span class="o">-</span> <span class="n">box</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
</span></span><span class="line"><span class="cl">    <span class="n">d</span><span class="o">.</span><span class="n">text</span><span class="p">(((</span><span class="n">size</span> <span class="o">-</span> <span class="n">w</span><span class="p">)</span> <span class="o">/</span> <span class="mi">2</span> <span class="o">-</span> <span class="n">box</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="p">(</span><span class="n">size</span> <span class="o">-</span> <span class="n">h</span><span class="p">)</span> <span class="o">/</span> <span class="mi">2</span> <span class="o">-</span> <span class="n">box</span><span class="p">[</span><span class="mi">1</span><span class="p">]),</span> <span class="s2">&#34;J&#34;</span><span class="p">,</span> <span class="n">font</span><span class="o">=</span><span class="n">font</span><span class="p">,</span> <span class="n">fill</span><span class="o">=</span><span class="p">(</span><span class="mi">245</span><span class="p">,</span> <span class="mi">245</span><span class="p">,</span> <span class="mi">245</span><span class="p">,</span> <span class="mi">255</span><span class="p">))</span>
</span></span><span class="line"><span class="cl">    <span class="n">img</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="sa">f</span><span class="s2">&#34;static/icon-</span><span class="si">{</span><span class="n">size</span><span class="si">}</span><span class="s2">.png&#34;</span><span class="p">)</span>
</span></span></code></pre></div><h2 id="四写文章">四、写文章</h2>
<p>先把固定页面建好，主题靠 <code>layout</code> 字段区分渲染方式：</p>
<p><code>content/archives.md</code>：</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">layout</span><span class="p">:</span><span class="w"> </span><span class="l">archives</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><p><code>content/search.md</code>：</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">layout</span><span class="p">:</span><span class="w"> </span><span class="l">search</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">placeholder</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><p>这里<strong>千不要把 YAML 的冒号打成中文全角冒号</strong>。我一开始写的是 <code>title：时光轴</code>，构建不报错，但页面标题是空的——因为全角冒号让整行变成了一个普通字符串，不是键值对。</p>
<p>正文用骨架命令生成：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">hugo</span> <span class="n">new</span> <span class="n">content</span> <span class="n">posts</span><span class="p">/</span><span class="nb">my-first</span><span class="n">-post</span><span class="p">.</span><span class="nb">md
</span></span></span></code></pre></div><p>默认 <code>draft: true</code>，本地加 <code>-D</code> 能看到，正式构建自动忽略。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-13</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;教程&#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.webp</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><p>图片直接放在文章同目录（Page Bundle），正文用相对路径引用，主题会自动做灯箱和尺寸处理。</p>
<h2 id="五搜索索引不在-hugo-server-里">五、搜索：索引不在 hugo server 里</h2>
<p>这是最容易误解的一点。主题的搜索用 Pagefind，它是<strong>构建后的产物</strong>——需要先有静态 HTML，才能扫描建索引。而 <code>hugo server</code> 是在内存里渲染的，<code>public/</code> 目录里什么都没有，所以本地预览时点搜索框必然是搜不到东西的，这不是配置错了。</p>
<p>正确流程是构建完再跑索引：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">hugo</span> <span class="p">-</span><span class="n">-gc</span> <span class="p">-</span><span class="n">-minify</span>
</span></span><span class="line"><span class="cl"><span class="n">node</span> <span class="n">themes</span><span class="p">/</span><span class="n">jijian</span><span class="p">/</span><span class="n">scripts</span><span class="p">/</span><span class="nb">pf-prep</span><span class="p">.</span><span class="py">cjs</span>
</span></span><span class="line"><span class="cl"><span class="n">npx</span> <span class="n">pagefind</span> <span class="p">-</span><span class="n">-site</span> <span class="n">_temp</span><span class="p">/</span><span class="nb">pf-site</span> <span class="p">-</span><span class="n">-output-path</span> <span class="n">public</span><span class="p">/</span><span class="n">pagefind</span>
</span></span></code></pre></div><p>中间那个 <code>pf-prep.cjs</code> 是主题内置的中文修复脚本。原因是 Pagefind 建索引时按「相邻两字」切分，查询时按整词切分，两本词典不一致，导致「二维码」这类词索引里有、查询时拆成单字就搜不到（Pagefind 的 issue #987）。脚本会在 HTML 文本里插入零宽空格，让两端对齐。</p>
<p>嫌三条命令麻烦就写进 <code>package.json</code>：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span>
</span></span><span class="line"><span class="cl">  <span class="nt">&#34;scripts&#34;</span><span class="p">:</span> <span class="p">{</span>
</span></span><span class="line"><span class="cl">    <span class="nt">&#34;dev&#34;</span><span class="p">:</span> <span class="s2">&#34;hugo server -D --disableFastRender&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">    <span class="nt">&#34;build&#34;</span><span class="p">:</span> <span class="s2">&#34;hugo --gc --minify&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">    <span class="nt">&#34;search&#34;</span><span class="p">:</span> <span class="s2">&#34;node themes/jijian/scripts/pf-prep.cjs &amp;&amp; npx pagefind --site _temp/pf-site --output-path public/pagefind&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl">    <span class="nt">&#34;preview&#34;</span><span class="p">:</span> <span class="s2">&#34;npm run build &amp;&amp; npm run search &amp;&amp; npx -y serve public&#34;</span>
</span></span><span class="line"><span class="cl">  <span class="p">}</span>
</span></span><span class="line"><span class="cl"><span class="p">}</span>
</span></span></code></pre></div><p>想验证搜索效果，用 <code>npm run preview</code> 起一个静态服务，别用 <code>hugo server</code>。</p>
<h2 id="六部署到-github-pages">六、部署到 GitHub Pages</h2>
<p>这一节全部在浏览器里点，除了 <code>git push</code> 之外不需要任何命令行工具。</p>
<h3 id="先选站点形态">先选站点形态</h3>
<p>GitHub Pages 有两种地址：</p>
<ul>
<li><strong>用户站点</strong>：仓库名必须叫 <code>&lt;用户名&gt;.github.io</code>，地址是 <code>https://用户名.github.io/</code>，根路径</li>
<li><strong>项目站点</strong>：仓库叫任意名字，地址带子目录 <code>https://用户名.github.io/仓库名/</code></li>
</ul>
<p><strong>对本站要选第一种。</strong> 原因是主题的 <code>baseof.html</code> 里搜索资源的路径是写死根路径的：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-html" data-lang="html"><span class="line"><span class="cl"><span class="p">&lt;</span><span class="nt">link</span> <span class="na">href</span><span class="o">=</span><span class="s">&#34;/pagefind/pagefind-component-ui.css&#34;</span> <span class="na">rel</span><span class="o">=</span><span class="s">&#34;stylesheet&#34;</span><span class="p">&gt;</span>
</span></span></code></pre></div><p>部署到子目录时，浏览器会去 <code>https://用户名.github.io/pagefind/...</code> 找，而实际文件在 <code>/仓库名/pagefind/...</code>，搜索样式和脚本全 404。除非改主题模板或者绑自定义域名，否则子路径方案搜索一定是坏的。</p>
<h3 id="在网页上建仓库">在网页上建仓库</h3>
<ol>
<li>打开 <code>https://github.com/new</code></li>
<li><strong>Repository name</strong> 填 <code>&lt;用户名&gt;.github.io</code>，大小写不影响，但必须和用户名一字不差</li>
<li>选 <strong>Public</strong>（Pages 免费额度只对公开仓库开放）</li>
<li><strong>不要勾</strong> Add a README / .gitignore / license，否则本地首次推送会因为历史不一致被拒</li>
<li>点 <strong>Create repository</strong></li>
</ol>
<p>建完页面会给你一段 Git 命令提示，先不用管，后面用得上。</p>
<h3 id="准备推送凭据">准备推送凭据</h3>
<p>GitHub 早就不允许用账号密码推送了。三种方式任选其一，都在网页上完成。</p>
<p><strong>方式一：交给 VS Code（最省事）</strong></p>
<p>在 VS Code 里打开这个项目，点左侧「源代码管理」图标，点 <strong>Publish Branch</strong>。第一次会弹窗让你登录 GitHub，浏览器里授权一次，之后 VS Code 会把凭据存进 Windows 凭据管理器，以后推送不再问。</p>
<p><strong>方式二：个人访问令牌（PAT）</strong></p>
<ol>
<li>右上角头像 → <strong>Settings</strong> → 左侧最下方 <strong>Developer settings</strong></li>
<li><strong>Personal access tokens</strong> → <strong>Tokens (classic)</strong> → <strong>Generate new token (classic)</strong></li>
<li>Note 随便写，Expiration 选个期限（90 天够用）</li>
<li>勾选 <strong>repo</strong> 和 <strong>workflow</strong> 两个权限——少勾 <code>workflow</code> 的话，CI 文件会因为权限不足推不上去</li>
<li>生成后<strong>立刻复制</strong>，页面刷新就再也看不到这串字符了</li>
</ol>
<p>推送时用户名填 GitHub 用户名，密码位置粘贴这串 token。</p>
<p><strong>方式三：SSH 密钥</strong></p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="nb">ssh-keygen</span> <span class="n">-t</span> <span class="n">ed25519</span> <span class="n">-C</span> <span class="s2">&#34;你的邮箱&#34;</span>
</span></span><span class="line"><span class="cl"><span class="c"># 一路回车（密码可留空），然后复制公钥</span>
</span></span><span class="line"><span class="cl"><span class="nb">Get-Content</span> <span class="nv">$env:USERPROFILE</span><span class="p">\.</span><span class="n">ssh</span><span class="p">\</span><span class="n">id_ed25519</span><span class="p">.</span><span class="py">pub</span> <span class="p">|</span> <span class="nb">Set-Clipboard</span>
</span></span></code></pre></div><p>网页右上角头像 → <strong>Settings</strong> → <strong>SSH and GPG keys</strong> → <strong>New SSH key</strong> → 粘贴 → <strong>Add SSH key</strong>。</p>
<p>之后远端地址换成 SSH 形式：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">git</span> <span class="n">remote</span> <span class="n">add</span> <span class="n">origin</span> <span class="n">git</span><span class="nv">@github</span><span class="p">.</span><span class="n">com</span><span class="err">:</span><span class="p">&lt;</span><span class="n">用户名</span><span class="p">&gt;/&lt;</span><span class="n">用户名</span><span class="p">&gt;.</span><span class="py">github</span><span class="p">.</span><span class="py">io</span><span class="p">.</span><span class="py">git</span>
</span></span></code></pre></div><h3 id="推送代码">推送代码</h3>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">git</span> <span class="n">add</span> <span class="n">-A</span>
</span></span><span class="line"><span class="cl"><span class="n">git</span> <span class="n">commit</span> <span class="n">-m</span> <span class="s2">&#34;初始化 Hugo 站点&#34;</span>
</span></span><span class="line"><span class="cl"><span class="n">git</span> <span class="n">branch</span> <span class="n">-M</span> <span class="n">main</span>
</span></span><span class="line"><span class="cl"><span class="n">git</span> <span class="n">remote</span> <span class="n">add</span> <span class="n">origin</span> <span class="n">https</span><span class="err">:</span><span class="p">//</span><span class="n">github</span><span class="p">.</span><span class="n">com</span><span class="p">/&lt;</span><span class="n">用户名</span><span class="p">&gt;/&lt;</span><span class="n">用户名</span><span class="p">&gt;.</span><span class="py">github</span><span class="p">.</span><span class="py">io</span><span class="p">.</span><span class="py">git</span>
</span></span><span class="line"><span class="cl"><span class="n">git</span> <span class="n">push</span> <span class="n">-u</span> <span class="n">origin</span> <span class="n">main</span>
</span></span></code></pre></div><p>需要认证时按上一节选的方式填。成功的话终端会显示 <code>main -&gt; main</code>，浏览器刷新仓库就能看到文件。</p>
<h3 id="把-pages-发布源切成-github-actions">把 Pages 发布源切成 GitHub Actions</h3>
<p>默认 Pages 是「从分支发布」，也就是把仓库里的 HTML 原样发出去。我们的仓库里只有 Markdown 和模板，所以必须改成 Actions 构建。</p>
<ol>
<li>仓库顶部 <strong>Settings</strong></li>
<li>左侧 <strong>Pages</strong></li>
<li><strong>Build and deployment</strong> 下的 <strong>Source</strong> 下拉，选 <strong>GitHub Actions</strong></li>
</ol>
<p>如果下拉里只有 <em>Deploy from a branch</em>、找不到 GitHub Actions，说明仓库里还没有任何工作流文件。先把下一节的 <code>deploy.yml</code> 提交推送，再刷新这个页面就会出现。</p>
<h3 id="工作流文件">工作流文件</h3>
<p>在项目里新建 <code>.github/workflows/deploy.yml</code>：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Deploy to GitHub Pages</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">on</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">push</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">branches</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="l">main]</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">workflow_dispatch</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">permissions</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">contents</span><span class="p">:</span><span class="w"> </span><span class="l">read</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">pages</span><span class="p">:</span><span class="w"> </span><span class="l">write</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">id-token</span><span class="p">:</span><span class="w"> </span><span class="l">write</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">concurrency</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">group</span><span class="p">:</span><span class="w"> </span><span class="l">pages</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">cancel-in-progress</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="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">jobs</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">build</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">runs-on</span><span class="p">:</span><span class="w"> </span><span class="l">ubuntu-latest</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">steps</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Checkout</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">actions/checkout@v7</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">with</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">submodules</span><span class="p">:</span><span class="w"> </span><span class="l">recursive  </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">fetch-depth</span><span class="p">:</span><span class="w"> </span><span class="m">0</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Setup Hugo</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">peaceiris/actions-hugo@v3</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">with</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">hugo-version</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;0.169.0&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">extended</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Setup Node</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">actions/setup-node@v7</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">with</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">node-version</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;22&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">cache</span><span class="p">:</span><span class="w"> </span><span class="l">npm</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Install dependencies</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l">npm ci</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Configure Pages</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">id</span><span class="p">:</span><span class="w"> </span><span class="l">pages</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">actions/configure-pages@v6</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Build site</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l">hugo --gc --minify --baseURL &#34;${{ steps.pages.outputs.base_url }}/&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Build search index</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l">npm run search</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Upload artifact</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">actions/upload-pages-artifact@v5</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">with</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l">./public</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">deploy</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">needs</span><span class="p">:</span><span class="w"> </span><span class="l">build</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">runs-on</span><span class="p">:</span><span class="w"> </span><span class="l">ubuntu-latest</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">environment</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">github-pages</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l">${{ steps.deployment.outputs.page_url }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">steps</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">Deploy to GitHub Pages</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">id</span><span class="p">:</span><span class="w"> </span><span class="l">deployment</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l">actions/deploy-pages@v5</span><span class="w">
</span></span></span></code></pre></div><p>几个细节值得说：</p>
<ul>
<li><code>submodules: recursive</code> 别忘了，漏了主题目录为空，构建会报 <code>found no layout file</code></li>
<li><code>baseURL</code> 用 <code>configure-pages</code> 输出的值，不要写死，换域名时不用改代码</li>
<li><code>npm ci</code> 需要仓库里有 <code>package-lock.json</code>，否则会用 <code>npm install</code> 得到不确定的依赖版本</li>
<li>Pagefind 版本固定在 <code>devDependencies</code> 里，别用 <code>npx -y pagefind@latest</code>，哪天发新版可能行为就变了</li>
</ul>
<h3 id="覆盖已有站点前先备份">覆盖已有站点前先备份</h3>
<p>如果这个仓库上已经有别的站点（比如早期的 Hexo），强推会把工作区内容整个换掉。<strong>先在网页上打个分支留底</strong>：</p>
<ol>
<li>仓库首页 → 分支下拉框 → <strong>View all branches</strong></li>
<li>右上角 <strong>New branch</strong></li>
<li>名字填 <code>legacy-hexo</code>，<strong>Branch from</strong> 选 <code>main</code></li>
<li><strong>Create branch</strong></li>
</ol>
<p>这个分支就停在旧站的状态。之后强推 main 只会影响 main：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">git</span> <span class="n">push</span> <span class="o">-f</span> <span class="n">origin</span> <span class="n">main</span>
</span></span></code></pre></div><p>哪天想看旧站：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">git</span> <span class="n">fetch</span> <span class="n">origin</span> <span class="nb">legacy-hexo</span>
</span></span><span class="line"><span class="cl"><span class="n">git</span> <span class="n">checkout</span> <span class="nb">legacy-hexo</span>
</span></span></code></pre></div><h3 id="看构建结果">看构建结果</h3>
<ol>
<li>仓库顶部 <strong>Actions</strong></li>
<li>左侧选 <strong>Deploy to GitHub Pages</strong></li>
<li>点最新那条运行记录，能看到 <code>build</code> 和 <code>deploy</code> 两个 job 的每一步</li>
</ol>
<p>全绿就说明上线了，点开 <code>deploy</code> 页面顶部会显示站点地址。<strong>首次部署后地址生效可能需要 1–2 分钟</strong>，这期间打开是 404 属于正常。</p>
<h2 id="七日常流程">七、日常流程</h2>
<p>上线之后，每天要做的其实只有三件事：</p>
<ol>
<li><code>hugo new content posts/xxx.md</code> 新建草稿</li>
<li>本地 <code>hugo server -D</code> 预览，写完把 <code>draft</code> 改成 <code>false</code></li>
<li><code>git push</code>，等 Actions 跑完自动上线</li>
</ol>
<p>搜索索引、构建、发布都由 CI 接管，本地不需要手动跑 <code>hugo</code>。</p>
<h2 id="八报错对照表">八、报错对照表</h2>
<table>
	<thead>
			<tr>
					<th>现象</th>
					<th>原因</th>
					<th>处理</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>整站无样式，像裸 HTML</td>
					<td><code>hugo.yaml</code> 里 <code>theme:jijian</code> 少了空格</td>
					<td>改成 <code>theme: jijian</code></td>
			</tr>
			<tr>
					<td>页面标题空白</td>
					<td>Front Matter 用了中文全角冒号 <code>title：</code></td>
					<td>换成半角 <code>title:</code></td>
			</tr>
			<tr>
					<td>命令报 <code>标记&quot;&amp;&amp;&quot;不是此版本中的有效语句分隔符</code></td>
					<td>用的是 Windows PowerShell 5.1</td>
					<td>装 PowerShell 7，改用 <code>pwsh</code></td>
			</tr>
			<tr>
					<td><code>git commit</code> 报 <code>Author identity unknown</code></td>
					<td>没配提交身份</td>
					<td><code>git config --global user.name</code> 和 <code>user.email</code></td>
			</tr>
			<tr>
					<td>终端里 <code>node</code> / <code>npm</code> 找不到</td>
					<td>装的是某个软件自带的 Node，没进系统 PATH</td>
					<td>用 winget 装 <code>OpenJS.NodeJS.LTS</code></td>
			</tr>
			<tr>
					<td>构建报 <code>found no layout file for &quot;manifest&quot;</code></td>
					<td>manifest 媒体类型后缀是 webmanifest</td>
					<td>在 <code>mediaTypes</code> 里改成 <code>json</code></td>
			</tr>
			<tr>
					<td>CI 报主题目录为空</td>
					<td>submodule 没拉取</td>
					<td>checkout 加 <code>submodules: recursive</code></td>
			</tr>
			<tr>
					<td>搜索框样式全丢</td>
					<td>部署在子路径，<code>/pagefind/</code> 被解析到根域名</td>
					<td>改用用户站点或绑自定义域名</td>
			</tr>
			<tr>
					<td>本地预览搜不到内容</td>
					<td>Pagefind 索引是构建产物，<code>hugo server</code> 不生成</td>
					<td>用 <code>npm run preview</code> 验证</td>
			</tr>
			<tr>
					<td>菜单报 nil pointer</td>
					<td>菜单 <code>identifier</code> 找不到对应页面</td>
					<td>建好 <code>content/archives.md</code> 这类页面</td>
			</tr>
			<tr>
					<td>push 报 <code>Authentication failed</code></td>
					<td>还在用账号密码</td>
					<td>改用 PAT 或 SSH，见「准备推送凭据」</td>
			</tr>
			<tr>
					<td>Pages 的 Source 里没有 GitHub Actions</td>
					<td>仓库里还没有工作流文件</td>
					<td>先推 <code>deploy.yml</code>，再刷新 Pages 设置</td>
			</tr>
			<tr>
					<td>push 报 <code>dial tcp ...:443</code> 超时</td>
					<td>网络无法直连 github.com</td>
					<td>配代理，见下</td>
			</tr>
	</tbody>
</table>
<p>当然遇到的所有报错或者问题都可以向dsh询问解决，不过要注意的一点是，GitHub那里如果不想自己做最好还是用SSH密钥，不然校园网可能会使得你的端口无法正常使用。</p>
<h2 id="附代理环境下的配置">附：代理环境下的配置</h2>
<p>如果所在网络访问 GitHub 需要代理（我这边就是这样：<code>api.github.com</code> 能直连，但 <code>github.com</code> 超时），只需要配一处：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="c"># 让 git 走本机代理，只影响这个仓库</span>
</span></span><span class="line"><span class="cl"><span class="n">git</span> <span class="n">config</span> <span class="n">http</span><span class="p">.</span><span class="py">proxy</span> <span class="n">http</span><span class="err">:</span><span class="p">//</span><span class="mf">127.0</span><span class="p">.</span><span class="py">0</span><span class="p">.</span><span class="mf">1</span><span class="err">:</span><span class="mf">7890</span>
</span></span></code></pre></div><p>浏览器里的网页操作不用单独设，跟着 Clash 之类的系统代理走就行。</p>
<p>哪天关掉代理后推送报 <code>Failed to connect to 127.0.0.1 port 7890</code>，重新开代理即可；想彻底去掉这条配置就执行：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="n">git</span> <span class="n">config</span> <span class="p">-</span><span class="n">-unset</span> <span class="n">http</span><span class="p">.</span><span class="py">proxy</span>
</span></span></code></pre></div><p>到这里整条链路就通了。剩下的时间应该花在写东西上，而不是修构建。</p>
]]></content:encoded></item><item><title>Hugo 与 Hexo：两种静态博客生成器的取舍</title><link>https://huangth.xyz/posts/hugo-vs-hexo/</link><pubDate>Thu, 12 Nov 2026 00:00:00 +0800</pubDate><guid>https://huangth.xyz/posts/hugo-vs-hexo/</guid><description>把博客从 Hexo 7 迁移到 Hugo 之后的一些对比：构建方式、性能量级、主题生态、内容组织与部署成本，以及各自的适用场景。</description><content:encoded><![CDATA[<p>本站的前一版是 Hexo 7.3.0，现在跑在 Hugo 0.169 上。两者都是静态站点生成器，最终产物也相同——一堆 HTML、CSS 和 JavaScript，丢给 Nginx 或任意静态托管就能访问。差别不在结果，而在实现路径和日常使用的手感。</p>
<p>这篇把迁移前后的观察整理一下，给同样在做选型的人一个参考。</p>
<h2 id="一架构运行时依赖与单二进制">一、架构：运行时依赖与单二进制</h2>
<p>这是两者最根本的分歧。</p>
<p>Hexo 是一个 Node.js 应用。渲染 Markdown 靠 <code>hexo-renderer-marked</code>，生成页面靠 <code>hexo-generator-index</code> 之类的插件，部署靠 <code>hexo-deployer-*</code>。这套设计让能力可以无限扩展，代价是项目必须带着一棵 <code>node_modules</code>，并且要维护依赖版本。</p>
<p>Hugo 是一个用 Go 编译出的单文件程序。模板引擎、Markdown 渲染、图片处理、多语言、分类系统都是内建的，运行时不需要任何外部依赖。</p>
<table>
	<thead>
			<tr>
					<th></th>
					<th>Hexo</th>
					<th>Hugo</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>运行环境</td>
					<td>Node.js</td>
					<td>无（单个可执行文件）</td>
			</tr>
			<tr>
					<td>扩展方式</td>
					<td>npm 插件</td>
					<td>内建功能 + 模板</td>
			</tr>
			<tr>
					<td>依赖管理</td>
					<td><code>package.json</code> / <code>node_modules</code></td>
					<td>无</td>
			</tr>
			<tr>
					<td>安装耗时</td>
					<td>装依赖通常数十秒到数分钟</td>
					<td>下载解压，秒级</td>
			</tr>
	</tbody>
</table>
<p>这个差异在本地开发时不算明显，但在 CI 里会被放大：Hexo 每次构建都要 <code>npm install</code>，Hugo 只需要一个二进制文件。</p>
<h2 id="二构建速度">二、构建速度</h2>
<p>Hugo 的速度来自并发渲染和编译型语言。本站目前二十来个页面，全量构建耗时约 <strong>0.06 秒</strong>——快到不太像在“构建”，更像是保存文件。</p>
<p>Hexo 在相同页面量级下通常是数秒，具体取决于插件数量：每多一个生成器、一个渲染器，就多一层遍历。这个数字在小站上无感，但文章数到几百上千之后，差距会从“几秒”拉大到“几十秒对不到一秒”，热更新时的体感差异尤其明显。</p>
<p>需要说明的是，这不是“Hexo 慢”的评价，而是两种技术路线的必然结果。如果你的站点只有几十篇，两者都足够快。</p>
<h2 id="三主题与生态">三、主题与生态</h2>
<p>Hexo 的优势在中文本土化。NexT、Butterfly、Fluid 这些主题在国内用户里积累了大量文档和二次开发案例，遇到问题容易搜到答案；插件市场也覆盖了访问统计、文章加密、字数统计这类具体需求。</p>
<p>Hugo 的主题数量更多，但质量分布不均。本站用的「极简 jijian」基于 PaperMod 二次开发，属于中文优化做得比较细的一类；而更常见的通用主题，往往需要自己补一些中文排版细节。</p>
<p>两者的取舍是：<strong>Hexo 更接近“装好就能用”，Hugo 更接近“给你零件自己装”</strong>。前者省时间，后者上限高，前提是你愿意读模板文档。</p>
<h2 id="四内容组织">四、内容组织</h2>
<p>写作层面的差异比想象中大。</p>
<p>Hexo 的约定是 <code>source/_posts/</code> 放 Markdown，开启 <code>post_asset_folder</code> 后，同名的资源目录会自动关联，图片路径写相对文件名即可。</p>
<p>Hugo 用 <strong>Page Bundle</strong>：把一篇文章做成一个目录，正文是 <code>index.md</code>，图片、附件放在同级目录里。这样资源和正文绑定在一起，迁移和引用都更干净。</p>
<p>Front Matter 都是 YAML，但字段名不同，迁移时要逐一对照：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="c"># Hexo</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">categories</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span>- <span class="l">技术</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></span><span class="line"><span class="cl"><span class="w">  </span>- <span class="l">Hugo</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="c"># Hugo</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">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></span></code></pre></div><p>此外 Hugo 的 shortcode 机制比 Hexo 的 tag 插件更灵活，可以带参数、嵌套调用，适合做提示框、图注、媒体嵌入这类结构化内容。代价是要学一点 Go template 语法。</p>
<h2 id="五部署与运维">五、部署与运维</h2>
<p>两者的产物都是 <code>public/</code>，部署方式没有本质区别：推仓库、走 CI、同步到服务器或对象存储。</p>
<p>区别在构建环节的复杂度。Hexo 的 CI 需要 Node 环境、<code>npm install</code>、缓存依赖；Hugo 只需要下载二进制——这也是为什么大多数 CI 模板里 Hugo 的配置往往只有三四行。</p>
<p>本站目前的流程是：<code>git push</code> 触发 Actions，构建 Hugo 站点、生成 Pagefind 搜索索引、用 <code>rsync</code> 同步到自己的服务器，全程约三十秒。</p>
<h2 id="六迁移成本">六、迁移成本</h2>
<p>从 Hexo 换到 Hugo 不是改个配置就能完成的事，实际要处理的有：</p>
<ul>
<li><strong>Front Matter 字段</strong>：分类、标签的写法，以及自定义字段的映射</li>
<li><strong>图片路径</strong>：<code>post_asset_folder</code> 的引用方式要改成 Page Bundle</li>
<li><strong>固定链接</strong>：<code>permalink</code> 规则不同，老文章的外部链接可能失效，需要配置 <code>aliases</code> 或重定向</li>
<li><strong>主题功能</strong>：评论、统计、目录这些原由插件承担的部分，要换成 Hugo 的内建配置或模板实现</li>
</ul>
<p>所以迁移前建议把旧站以分支或独立目录的形式保留一段时间，确认新站没有问题再下线路由。本站就把旧站留在了 <code>legacy-hexo</code> 分支。</p>
<h2 id="七怎么选">七、怎么选</h2>
<table>
	<thead>
			<tr>
					<th>你的情况</th>
					<th>建议</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>只写文章，希望装好就能用</td>
					<td>Hexo</td>
			</tr>
			<tr>
					<td>文章量大，或对构建速度敏感</td>
					<td>Hugo</td>
			</tr>
			<tr>
					<td>依赖某个 Hexo 专属插件或主题</td>
					<td>Hexo</td>
			</tr>
			<tr>
					<td>不想维护 Node 依赖，部署环境越简单越好</td>
					<td>Hugo</td>
			</tr>
			<tr>
					<td>愿意读模板、想深度定制样式和结构</td>
					<td>Hugo</td>
			</tr>
			<tr>
					<td>团队更熟 JavaScript</td>
					<td>Hexo</td>
			</tr>
	</tbody>
</table>
<p>一句话概括：突然来兴趣了，所以就用hugo了。</p>
]]></content:encoded></item><item><title>关于</title><link>https://huangth.xyz/about/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://huangth.xyz/about/</guid><description>关于这个博客和我</description><content:encoded><![CDATA[<p>你好，我是 <strong>就暮</strong>，这里是我的个人博客。</p>
<h2 id="这里会写什么">这里会写什么</h2>
<ul>
<li>技术笔记与踩坑记录</li>
<li>读书、思考与生活碎片</li>
<li>一些还没想清楚就先写下来的东西</li>
</ul>
<h2 id="关于本站">关于本站</h2>
<p>站点用 <a href="https://gohugo.io/" target="_blank" rel="noopener noreferrer">Hugo</a>
 构建，主题是 <a href="https://github.com/hcllmsx/hugo-jijian" target="_blank" rel="noopener noreferrer">极简 jijian</a>
，搜索由 <a href="https://pagefind.app/" target="_blank" rel="noopener noreferrer">Pagefind</a>
 提供。</p>
]]></content:encoded></item></channel></rss>