https://hugo-solitude.efu.me/tags/solitude/Recent content on SolitudeHugozh-CNsolitude@example.org (Solitude)solitude@example.org (Solitude)Tue, 25 Aug 2026 10:00:00 +0800https://hugo-solitude.efu.me/p/getting-started.htmlTue, 25 Aug 2026 10:00:00 +0800solitude@example.org (Solitude)https://hugo-solitude.efu.me/p/getting-started.html<p>Solitude 是一款注重内容体验的 Hugo 主题。它使用 Go Templates 组织页面，通过 Hugo Pipes 处理样式和 TypeScript；站点构建只需要 Hugo，不需要额外安装 Node.js、PostCSS、Sass 或 Stylus。</p> <h2 id="准备环境">准备环境</h2> <p>请安装 Hugo <code>v0.164.0</code> 或更高版本。官方发行版已经包含主题需要的模板和资源处理能力，可以通过下面的命令确认版本：</p> <figure class="code-block" data-code-block data-language="shell"> <figcaption class="code-block__toolbar"> <span class="code-block__language">shell</span> <button class="code-block__copy" type="button" data-code-copy>复制</button> </figcaption> <div class="code-block__viewport"> <pre class="code-block__fallback" tabindex="0"><code class="language-shell">hugo version</code></pre> </div> <button class="code-block__expand" type="button" data-code-expand hidden>展开全部</button> </figure> <h2 id="安装主题">安装主题</h2> <p>在 Hugo 站点根目录把 Solitude 添加为 Git submodule：</p> <figure class="code-block" data-code-block data-language="shell"> <figcaption class="code-block__toolbar"> <span class="code-block__language">shell</span> <button class="code-block__copy" type="button" data-code-copy>复制</button> </figcaption> <div class="code-block__viewport"> <pre class="code-block__fallback" tabindex="0"><code class="language-shell">git submodule add -b hugo https://github.com/everfu/hugo-solitude.git themes/solitude</code></pre> </div> <button class="code-block__expand" type="button" data-code-expand hidden>展开全部</button> </figure> <p>随后在站点的 <code>hugo.yaml</code> 中启用主题，并声明搜索与友链数据使用的输出格式：</p> <figure class="code-block" data-code-block data-language="yaml"> <figcaption class="code-block__toolbar"> <span class="code-block__language">yaml</span> <button class="code-block__copy" type="button" data-code-copy>复制</button> </figcaption> <div class="code-block__viewport"> <pre class="code-block__fallback" tabindex="0"><code class="language-yaml">theme: solitude outputs: home: [HTML, RSS, Search, Links] section: [HTML, RSS] taxonomy: [HTML, RSS] term: [HTML, RSS] params: solitude: search: enable: true type: local</code></pre> </div> <button class="code-block__expand" type="button" data-code-expand hidden>展开全部</button> </figure> <p>主题仓库中的 <code>exampleSite/hugo.yaml</code> 是完整配置起点。复制时建议保留配置层级，再逐项替换站点名称、导航、首页推荐、侧栏和页脚内容。</p>