https://www.imcry.vip/tags/git/Recent content in Git on 初然忆Hugo -- gohugo.iozhTue, 02 Jun 2026 07:12:28 +0800https://www.imcry.vip/post/2026-6-2-728/Tue, 02 Jun 2026 07:12:28 +0800https://www.imcry.vip/post/2026-6-2-728/<h2 id="前言"><a href="#%e5%89%8d%e8%a8%80" class="header-anchor"></a>前言 </h2><p>博主之前把博客分成两部分，一部分是Hugo的文章和其他文件，另一部分是Hugo生成的静态页面。半个月以来，博主只能后者的仓库与EgdeOne-Pages关联，原因还是技术太菜，没能解决Pages构建失败的问题。昨晚心血来潮，决定再试一次，各种搜索方法后终于成功解决。</p> <h2 id="原因"><a href="#%e5%8e%9f%e5%9b%a0" class="header-anchor"></a>原因 </h2><p>问题的引发归结于两个原因。</p> <h3 id="hugo的配置文件"><a href="#hugo%e7%9a%84%e9%85%8d%e7%bd%ae%e6%96%87%e4%bb%b6" class="header-anchor"></a>Hugo的配置文件 </h3><p>博主所使用的主题是<code>stack</code>，在<strong>hugo.toml</strong>文件中的<code>theme</code>的值为：</p> <pre tabindex="0"><code>Hugo-Theme-Stack </code></pre><p>主题文件夹名是全小写的，在Windows环境下可以使用<code>hugo</code>成功构建，但在Pages的环境下是会报错的。</p> <h3 id="pages中的版本"><a href="#pages%e4%b8%ad%e7%9a%84%e7%89%88%e6%9c%ac" class="header-anchor"></a>Pages中的版本 </h3><p>EgdeOne-Pages默认使用的是老版本，而<code>stack</code>主题至少需要<code>0.157.0</code>并且是<strong>扩展</strong>的版本。</p> <h2 id="解决"><a href="#%e8%a7%a3%e5%86%b3" class="header-anchor"></a>解决 </h2><p>分别修改Hugo配置文件和Pages设置，然后重关联仓库，最后重新构建部署。</p> <h3 id="修改hugo配置文件"><a href="#%e4%bf%ae%e6%94%b9hugo%e9%85%8d%e7%bd%ae%e6%96%87%e4%bb%b6" class="header-anchor"></a>修改Hugo配置文件 </h3><p>将<strong>hugo.toml</strong>文件中的<code>theme</code>的值修改为：</p> <pre tabindex="0"><code>hugo-theme-stack </code></pre><h3 id="修改pages设置"><a href="#%e4%bf%ae%e6%94%b9pages%e8%ae%be%e7%bd%ae" class="header-anchor"></a>修改Pages设置 </h3><p>进入Pages的<strong>项目管理</strong>页面。</p> <h4 id="构建部署配置"><a href="#%e6%9e%84%e5%bb%ba%e9%83%a8%e7%bd%b2%e9%85%8d%e7%bd%ae" class="header-anchor"></a>构建部署配置 </h4><p>将<strong>构建部署配置</strong>各项参数设置如下：</p> <table> <thead> <tr> <th style="text-align: left">配置项</th> <th style="text-align: left">值</th> </tr> </thead> <tbody> <tr> <td style="text-align: left">根目录</td> <td style="text-align: left"><code>./</code></td> </tr> <tr> <td style="text-align: left">框架预设</td> <td style="text-align: left"><code>Other</code></td> </tr> <tr> <td style="text-align: left">输出目录</td> <td style="text-align: left"><code>public</code></td> </tr> <tr> <td style="text-align: left">编译命令</td> <td style="text-align: left"><code>hugo --gc --minify</code></td> </tr> </tbody> </table> <h4 id="环境变量"><a href="#%e7%8e%af%e5%a2%83%e5%8f%98%e9%87%8f" class="header-anchor"></a>环境变量 </h4><p>新增两项环境变量，一个是版本号，另一个为是否开启扩展，各项参数设置如下：</p>