https://blowfish.page/zh-cn/docs/Recent content in 文档 on BlowfishHugo -- gohugo.iozh-cn© 2026 Blowfishhttps://blowfish.page/zh-cn/docs/welcome/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/welcome/<div class="lead text-neutral-500 dark:text-neutral-400 !mb-9 text-xl"> Blowfish 包含了大量的特性功能。 </div> <p>Blowfish 的目标是开发一个简单且轻量级的主题。 该主题是 <a target="_blank" href="https://github.com/nunocoracao/congo">Congo</a> 的一个分支，并进行了大量扩展。</p>https://blowfish.page/zh-cn/docs/installation/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/installation/<p>如果想快速上手，可以按照标准的 Hugo <a href="https://gohugo.io/getting-started/quick-start/" target="_blank" rel="noreferrer">快速启动</a> 文档。</p> <p>更详细的安装如下，<a href="https://blowfish.page/zh-cn/docs/installation/#%e6%9b%b4%e6%96%b0%e4%b8%bb%e9%a2%98" >更新主题</a>的教程也可以看此文档。</p>https://blowfish.page/zh-cn/docs/getting-started/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/getting-started/<div class="flex px-4 py-3 rounded-md shadow bg-primary-100 dark:bg-primary-900" > <span class="text-primary-400 pe-3 flex items-center" > <span class="relative block icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M506.3 417l-213.3-364c-16.33-28-57.54-28-73.98 0l-213.2 364C-10.59 444.9 9.849 480 42.74 480h426.6C502.1 480 522.6 445 506.3 417zM232 168c0-13.25 10.75-24 24-24S280 154.8 280 168v128c0 13.25-10.75 24-23.1 24S232 309.3 232 296V168zM256 416c-17.36 0-31.44-14.08-31.44-31.44c0-17.36 14.07-31.44 31.44-31.44s31.44 14.08 31.44 31.44C287.4 401.9 273.4 416 256 416z"/></svg> </span> </span> <span class="dark:text-neutral-300" >本节内容需要已经阅读了 <a href="https://blowfish.page/zh-cn/docs/installation/" target="_blank" rel="noreferrer">安装 Blowfish 主题</a>。</span> </div> </br> <div class="flex px-4 py-3 rounded-md shadow bg-primary-100 dark:bg-primary-900" > <span class="text-primary-400 pe-3 flex items-center" > <span class="relative block icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"> <path fill="currentColor" d="M159.3 5.4c7.8-7.3 19.9-7.2 27.7 .1c27.6 25.9 53.5 53.8 77.7 84c11-14.4 23.5-30.1 37-42.9c7.9-7.4 20.1-7.4 28 .1c34.6 33 63.9 76.6 84.5 118c20.3 40.8 33.8 82.5 33.8 111.9C448 404.2 348.2 512 224 512C98.4 512 0 404.1 0 276.5c0-38.4 17.8-85.3 45.4-131.7C73.3 97.7 112.7 48.6 159.3 5.4zM225.7 416c25.3 0 47.7-7 68.8-21c42.1-29.4 53.4-88.2 28.1-134.4c-2.8-5.6-5.6-11.2-9.8-16.8l-50.6 58.8s-81.4-103.6-87.1-110.6C133.1 243.8 112 273.2 112 306.8C112 375.4 162.6 416 225.7 416z"/></svg></span> </span> <span class="dark:text-neutral-300" ><p>我们刚刚推出了一个 CLI 工具，用来帮助你快速开始 Blowfish。 它将帮助你安装和配置 Blowfish 主题。 可以使用以下命令全局安装 CLI 工具：</p>https://blowfish.page/zh-cn/docs/configuration/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/configuration/<p>Blowfish 是一个高度定制化的主题，使用到了一些 Hugo 中最新的特性来简化配置方式。</p>https://blowfish.page/zh-cn/docs/homepage-layout/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/homepage-layout/<p>Blowfish 提供了一个完全灵活的主页布局。你可以选择两种主要模板，并提供了额外的参数来帮助调整设计。当然，你也可以提供自己的模板，完全控制主页的内容。</p>https://blowfish.page/zh-cn/docs/shortcodes/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/shortcodes/<p>除了所有<a href="https://gohugo.io/content-management/shortcodes/" target="_blank" rel="noreferrer">默认 Hugo 简码</a> 之外，Blowfish 还添加了一些额外的功能。</p> <h2 class="relative group">醒目框 <div id="醒目框" class="anchor"></div> <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none"> <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#%e9%86%92%e7%9b%ae%e6%a1%86" aria-label="锚点">#</a> </span> </h2> <p><code>alert</code> 可以将其中内容输出为文章中的风格化消息框。它对于吸引读者注意您不想让读者错过的重要信息很有用。</p>https://blowfish.page/zh-cn/docs/front-matter/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/front-matter/<p>除了 <a href="https://gohugo.io/content-management/front-matter/#front-matter-variables" target="_blank" rel="noreferrer">Hugo 中默认的 front matter</a>，Blowfish 主题中还添加了大量的参数选项来自定义单个页面的展示方式。所有可用的扉页参数如下。</p>https://blowfish.page/zh-cn/docs/multi-author/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/multi-author/<p>一个网站会有多个创作者共同贡献内容，所以需要再整个网站中默认使用多创作者。对于这种情况，Blowfish 允许用户使用多创作者功能拓展创作者列表。</p>https://blowfish.page/zh-cn/docs/partials/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/partials/<h2 class="relative group">站点分析 <div id="站点分析" class="anchor"></div> <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none"> <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#%e7%ab%99%e7%82%b9%e5%88%86%e6%9e%90" aria-label="锚点">#</a> </span> </h2> <p>Blowfish 支持了 Fathom、Google 和 Umami。Fathom 和 Umami 都是开源、简单、且注重隐私的站点分析服务，他们可以很好地替代 Google 分析。Fathom 和 Umami 都有公有云的付费版本，当然你也可以自己手动部署开源版。</p>https://blowfish.page/zh-cn/docs/thumbnails/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/thumbnails/<h2 class="relative group">缩略图 <div id="缩略图" class="anchor"></div> <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none"> <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#%e7%bc%a9%e7%95%a5%e5%9b%be" aria-label="锚点">#</a> </span> </h2> <p>Blowfish 对视觉支持进行了增强，可以让你轻松地为文章添加缩略图。你只需要将一个以 <code>feature*</code> 开头的图像文件（支持几乎所有格式，但更推荐 <code>.png</code> 或 <code>.jpg</code>）放置在文章所在的目录中，如下面所示：</p>https://blowfish.page/zh-cn/docs/content-examples/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/content-examples/<p>如果你已经按顺序阅读了文档，那么你现在应该已经了解了 Blowfish 中所有的功能和配置信息。这个页面旨在把所有内容整合在一起，并提供一些你会在 Hugo 项目中使用的示例。</p>https://blowfish.page/zh-cn/docs/series/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/series/<p>Blowfish 提供了将一组文章分组到“系列”下的功能。将文章放在系列下将在每个页面中显示该系列文章的其余部分，并在它们之间提供快速导航。您可以在上面看到一个例子。</p>https://blowfish.page/zh-cn/docs/advanced-customisation/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/advanced-customisation/<p>您可以通过多种方式对 Blowfish 进行高级自定义。请阅读下文，了解更多可自定义的内容以及实现想要效果的最佳方法。</p>https://blowfish.page/zh-cn/docs/hosting-deployment/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/hosting-deployment/<p>有许多方法可以部署基于 Blowfish 主题的 Hugo 网站。这个主题几乎在任何部署场景中都很灵活。</p>https://blowfish.page/zh-cn/docs/firebase-views/Mon, 01 Jan 0001 00:00:00 +0000https://blowfish.page/zh-cn/docs/firebase-views/<p>为了能够在网站中获取动态数据，我们支持了对 Firebase 的集成。这将允许你在列表和文章中使用阅读量功能。</p>