https://wiki.nucle.cc/tags/%E5%8D%9A%E5%AE%A2/ Recent content in 博客 on Nucle Wiki Hugo zh-CN Wed, 04 Jun 2025 00:00:00 +0000 https://wiki.nucle.cc/posts/hugo-quickstart/ Wed, 04 Jun 2025 00:00:00 +0000 https://wiki.nucle.cc/posts/hugo-quickstart/ <p>本文记录了使用 Hugo + PaperMod 主题搭建本站的过程。</p> <h2 id="为什么选择-hugo">为什么选择 Hugo</h2> <p>Hugo 是用 Go 编写的静态站点生成器，核心优势：</p> <ul> <li><strong>速度极快</strong>：数百页的站点毫秒级构建</li> <li><strong>单二进制</strong>：无运行时依赖，安装即用</li> <li><strong>灵活性高</strong>：支持自定义模板、短代码、分类系统</li> <li><strong>部署简单</strong>：输出纯静态文件，可部署到任何平台</li> </ul> <h2 id="安装-hugo">安装 Hugo</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><span style="color:#75715e"># macOS (Homebrew)</span> </span></span><span style="display:flex;"><span>brew install hugo </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># 验证安装</span> </span></span><span style="display:flex;"><span>hugo version </span></span><span style="display:flex;"><span><span style="color:#75715e"># hugo v0.162.1+extended ...</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 site wiki --force </span></span><span style="display:flex;"><span>cd wiki </span></span></code></pre></div><h2 id="安装-papermod-主题">安装 PaperMod 主题</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>git init </span></span><span style="display:flex;"><span>git submodule add --depth<span style="color:#f92672">=</span><span style="color:#ae81ff">1</span> <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span> https://github.com/adityatelange/hugo-PaperMod themes/PaperMod </span></span></code></pre></div><h2 id="站点配置">站点配置</h2> <p><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">&#39;https://nucle.cc/&#39;</span> </span></span><span style="display:flex;"><span><span style="color:#a6e22e">locale</span> = <span style="color:#e6db74">&#39;zh-CN&#39;</span> </span></span><span style="display:flex;"><span><span style="color:#a6e22e">title</span> = <span style="color:#e6db74">&#39;Nucle Wiki&#39;</span> </span></span><span style="display:flex;"><span><span style="color:#a6e22e">theme</span> = <span style="color:#e6db74">&#39;PaperMod&#39;</span> </span></span></code></pre></div><h2 id="编写内容">编写内容</h2> <p>文章放在 <code>content/posts/</code> 目录下，使用 Markdown 编写：</p>