https://my-blog-t3l.pages.dev/tags/hugo/Recent content in Hugo on 我的博客Hugozh-CNThu, 01 Jan 2026 00:00:00 +0800https://my-blog-t3l.pages.dev/posts/hello/Thu, 01 Jan 2026 00:00:00 +0800https://my-blog-t3l.pages.dev/posts/hello/<p>这是你的第一篇博客文章。Hugo 会自动把它渲染成 HTML，推送到 <code>main</code> 分支后 GitHub Actions 会构建并部署到 Cloudflare Pages。</p> <h2 id="写作方式">写作方式</h2> <p>文章就是普通的 Markdown 文件，放在 <code>content/posts/</code> 目录下。新建一篇：</p> <div class="code-block"> <button class="code-copy" type="button" hidden aria-label="Copy code to clipboard"> <span class="code-copy-label" aria-hidden="true">Copy</span> </button> <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="n">我的新文章</span><span class="p">.</span><span class="n">md</span></span></span></code></pre></div> </div><p>然后把 front matter 里的 <code>draft: true</code> 改成 <code>draft: false</code>，否则 Hugo 不会构建它。</p> <h2 id="插入图片">插入图片</h2> <p>推荐把图片放在 <code>static/images/</code> 下，然后用绝对路径引用：</p> <div class="code-block"> <button class="code-copy" type="button" hidden aria-label="Copy code to clipboard"> <span class="code-copy-label" aria-hidden="true">Copy</span> </button> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown"><span class="line"><span class="cl">![<span class="nt">示意图</span>](<span class="na">/images/demo.png</span>)</span></span></code></pre></div> </div><p><code>static/</code> 里的内容会原样复制到站点根目录，所以 <code>/images/demo.png</code> 在部署后可以直接访问。</p> <h2 id="本地预览">本地预览</h2> <div class="code-block"> <button class="code-copy" type="button" hidden aria-label="Copy code to clipboard"> <span class="code-copy-label" aria-hidden="true">Copy</span> </button> <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">server</span> <span class="p">-</span><span class="n">-bind</span> <span class="mf">0.0</span><span class="p">.</span><span class="py">0</span><span class="p">.</span><span class="py">0</span> <span class="p">-</span><span class="n">-port</span> <span class="mf">1313</span></span></span></code></pre></div> </div><p>打开 <a href="http://localhost:1313">http://localhost:1313</a> 就能看到实时预览，改文件会自动刷新。</p> <h2 id="检查清单">检查清单</h2> <p>部署完成后，确认这几件事：</p> <ol> <li>首页能正常打开，样式没有丢失；</li> <li>这篇文章能点进来，代码块有高亮；</li> <li>文章底部的评论区正常显示；</li> <li>提交一条测试评论，没有 CORS 报错。</li> </ol>