https://twsiezdd.asia/tags/hugo/Recent content in Hugo on Twsiezdd个人资料管理Hugozh-cnFri, 30 Oct 2026 00:00:00 +0000https://twsiezdd.asia/posts/hugo-notes/Fri, 30 Oct 2026 00:00:00 +0000https://twsiezdd.asia/posts/hugo-notes/<p>记录一下这个博客是怎么搭起来的，万一以后要重装，照着做就行。</p> <h2 id="为什么选-hugo">为什么选 Hugo</h2> <p>对比了几个方案：</p> <table> <thead> <tr> <th>方案</th> <th>优点</th> <th>缺点</th> </tr> </thead> <tbody> <tr> <td>WordPress</td> <td>生态全，后台好用</td> <td>要 PHP + MySQL，吃内存</td> </tr> <tr> <td>Hexo</td> <td>中文资料多</td> <td>依赖 Node</td> </tr> <tr> <td>Hugo</td> <td>单文件二进制，构建快</td> <td>要写 Markdown</td> </tr> </tbody> </table> <p>服务器配置不高，WordPress 跑起来有点吃力，最后选了 Hugo。构建完就是一堆静态 HTML，Nginx 直接托管，几乎不占资源。</p> <h2 id="安装">安装</h2> <p>Windows 上下载 release 里的 <code>hugo_extended_xxx_windows-amd64.zip</code>，解压得到 <code>hugo.exe</code> 就能用。</p> <p>一定要选 <strong>extended</strong> 版本，很多主题用了 SCSS，普通版构建会报错。</p> <h2 id="建站">建站</h2> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>hugo new site blog </span></span><span style="display:flex;"><span>cd blog </span></span></code></pre></div><p>然后把主题放到 <code>themes/</code> 目录下，在 <code>hugo.toml</code> 里写：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-toml" data-lang="toml"><span style="display:flex;"><span><span style="color:#a6e22e">baseURL</span> = <span style="color:#e6db74">&#34;https://example.com/&#34;</span> </span></span><span style="display:flex;"><span><span style="color:#a6e22e">languageCode</span> = <span style="color:#e6db74">&#34;zh-cn&#34;</span> </span></span><span style="display:flex;"><span><span style="color:#a6e22e">title</span> = <span style="color:#e6db74">&#34;我的博客&#34;</span> </span></span><span style="display:flex;"><span><span style="color:#a6e22e">theme</span> = <span style="color:#e6db74">&#34;PaperMod&#34;</span> </span></span></code></pre></div><h2 id="写文章">写文章</h2> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>hugo new posts/first.md </span></span></code></pre></div><p>生成的 Markdown 开头有一段 front matter：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-markdown" data-lang="markdown"><span style="display:flex;"><span>--- </span></span><span style="display:flex;"><span><span style="color:#f92672">title</span>: <span style="color:#e6db74">&#34;文章标题&#34;</span> </span></span><span style="display:flex;"><span><span style="color:#f92672">date</span>: <span style="color:#e6db74">2026-10-30</span> </span></span><span style="display:flex;"><span><span style="color:#f92672">draft</span>: <span style="color:#66d9ef">false</span> </span></span><span style="display:flex;"><span><span style="color:#f92672">tags</span>: [<span style="color:#e6db74">&#34;随笔&#34;</span>] </span></span><span style="display:flex;"><span>--- </span></span></code></pre></div><p><code>draft</code> 默认是 <code>true</code>，忘了改的话构建出来是空的，这个坑我踩过。</p>