[{"content":" 前言 # 本文将一步一步指导你学会使用 Hugo 和 Blowfish。\n安装 Hugo # 首先需要在本地安装 Hugo，可以通过运行 hugo version 来检查是否安装成功。\n确保你使用 Hugo 0.158.0 或更高的版本。 创建新站点 # 运行 hugo new site mywebsite 命令，在 mywebsite 目录下创建一个新 Hugo 站点。\n下载 Blowfish 主题 # 使用 Git 子模块安装 (推荐) # cd mywebsite git init git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish 使用 Hugo 模块安装 # hugo mod init github.com/\u0026lt;username\u0026gt;/\u0026lt;repo-name\u0026gt; 创建 config/_default/module.toml：\n[[imports]] disable = false path = \u0026#34;github.com/nunocoracao/blowfish/v2\u0026#34; 设置配置文件 # 删除 Hugo 自动生成的 hugo.toml，从主题中复制 *.toml 文件粘贴到 config/_default/ 目录。\nconfig 目录结构应如下：\nconfig/_default/ ├─ hugo.toml ├─ languages.en.toml ├─ markup.toml ├─ menus.en.toml └─ params.toml 如果没有使用 Hugo 模块安装，必须在 hugo.toml 中添加 theme = \u0026quot;blowfish\u0026quot;。 更新主题 # 使用 git 子模块时，执行以下命令即可更新：\ngit submodule update --remote --merge ","externalUrl":null,"permalink":"/docs/installation/","section":"文档","summary":"前言 # 本文将一步一步指导你学会使用 Hugo 和 Blowfish。\n","title":"安装和配置","type":"docs"},{"content":" 本节内容需要已经阅读了 安装 Blowfish 主题。 基础设置 # 在刚刚安装完成、创建内容之前，有几个设置需要关注。从 hugo.toml 开始，设置 baseURL 和 locale 参数。\n# config/_default/hugo.toml baseURL = \u0026#34;https://your_domain.com/\u0026#34; locale = \u0026#34;en\u0026#34; 下一步是设置语言。尽管 Blowfish 支持多语言，但是 hugo.toml 只能配置一个主语言。\n在 config/_default 文件夹中找到 languages.en.toml。如果你的主语言是英语，你可以直接使用此文件。否则需要重命名为主语言对应的文件名。\n# config/_default/languages.en.toml title = \u0026#34;My awesome website\u0026#34; [params.author] name = \u0026#34;My name\u0026#34; image = \u0026#34;img/author.jpg\u0026#34; headline = \u0026#34;A generally awesome human\u0026#34; bio = \u0026#34;A little bit about me\u0026#34; links = [ { twitter = \u0026#34;https://twitter.com/username\u0026#34; } ] 颜色方案 # Blowfish 提供多种预设配色方案。你可以通过 params.toml 中的 colorScheme 参数来设置。\n内置配色方案包括：blowfish、avocado、blue、congo、caribbean、cherry、fire、marvel、neon、ocean、slate、plum 等。\n整理内容 # 默认情况下，Blowfish 不强制你使用特定类型的内容。这样你可以随意自定义你想要的内容。\n. ├── assets │ └── img │ └── author.jpg ├── config │ └── _default ├── content │ ├── _index.md │ ├── about.md │ └── posts │ ├── _index.md │ ├── first-post.md │ └── another-post │ ├── aardvark.jpg │ └── index.md └── themes └── blowfish 菜单 # Blowfish 有两个可以定制的菜单：main 菜单和 footer 菜单。\n# config/_default/menus.toml [[main]] name = \u0026#34;Blog\u0026#34; pageRef = \u0026#34;posts\u0026#34; weight = 10 [[main]] name = \u0026#34;GitHub\u0026#34; pre = \u0026#34;github\u0026#34; url = \u0026#34;https://github.com/nunocoracao/blowfish\u0026#34; weight = 30 [[footer]] name = \u0026#34;Privacy\u0026#34; url = \u0026#34;https://external-link\u0026#34; 两个菜单都可以在 menus.zh-cn.toml 中配置。\n更多配置 # 详细的配置请参考 Blowfish 文档.\n","externalUrl":null,"permalink":"/docs/getting-started/","section":"文档","summary":" 本节内容需要已经阅读了 安装 Blowfish 主题。 基础设置 # 在刚刚安装完成、创建内容之前，有几个设置需要关注。从 hugo.toml 开始，设置 baseURL 和 locale 参数。\n","title":"入门指南","type":"docs"},{"content":" 关于本站 # 欢迎来到我的个人网站。\n这里会记录一些技术笔记和日常思考。\nBuilt with Hugo \u0026amp; Blowfish 🎉\n","date":"2026-07-03","externalUrl":null,"permalink":"/about/","section":"欢迎来到我的网站! 🎉","summary":"关于本站 # 欢迎来到我的个人网站。\n","title":"关于","type":"page"},{"content":"欢迎来到我的网站！这里会分享一些技术文章和日常记录。\n使用 Hugo 和 Blowfish 主题构建的轻量级网站。 快速导航 # 浏览 文档 了解更多，或查看 关于 页面了解本站。\n","date":"2026-07-03","externalUrl":null,"permalink":"/","section":"欢迎来到我的网站! 🎉","summary":"欢迎来到我的网站！这里会分享一些技术文章和日常记录。\n使用 Hugo 和 Blowfish 主题构建的轻量级网站。 快速导航 # 浏览 文档 了解更多，或查看 关于 页面了解本站。\n","title":"欢迎来到我的网站! 🎉","type":"page"},{"content":" 欢迎来到 教程 板块。 ","date":"2026-07-03","externalUrl":null,"permalink":"/%E6%95%99%E7%A8%8B/","section":"教程","summary":" 欢迎来到 教程 板块。 ","title":"教程","type":"教程"},{"content":" my-page # 开始写作\u0026hellip;\n","date":"2026-07-03","externalUrl":null,"permalink":"/my-page/","section":"欢迎来到我的网站! 🎉","summary":"my-page # 开始写作…\n","title":"你好","type":"page"},{"content":" 新手指南 # 开始写作\u0026hellip;\n","date":"2026-07-03","externalUrl":null,"permalink":"/%E6%95%99%E7%A8%8B/%E6%96%B0%E6%89%8B%E6%8C%87%E5%8D%97/","section":"教程","summary":"新手指南 # 开始写作…\n","title":"新手指南","type":"教程"},{"content":"","externalUrl":null,"permalink":"/authors/","section":"Authors","summary":"","title":"Authors","type":"authors"},{"content":"","externalUrl":null,"permalink":"/categories/","section":"Categories","summary":"","title":"Categories","type":"categories"},{"content":"","externalUrl":null,"permalink":"/series/","section":"Series","summary":"","title":"Series","type":"series"},{"content":"","externalUrl":null,"permalink":"/tags/","section":"Tags","summary":"","title":"Tags","type":"tags"},{"content":"","externalUrl":null,"permalink":"/tags/%E5%AE%89%E8%A3%85/","section":"Tags","summary":"","title":"安装","type":"tags"},{"content":"","externalUrl":null,"permalink":"/series/%E9%83%A8%E7%BD%B2%E6%95%99%E7%A8%8B/","section":"Series","summary":"","title":"部署教程","type":"series"},{"content":" 了解如何使用简单而强大的 Blowfish 主题。 欢迎查阅以下文档来快速上手。\n","externalUrl":null,"permalink":"/docs/","section":"文档","summary":" 了解如何使用简单而强大的 Blowfish 主题。 欢迎查阅以下文档来快速上手。\n","title":"文档","type":"docs"},{"content":"","externalUrl":null,"permalink":"/tags/%E6%96%87%E6%A1%A3/","section":"Tags","summary":"","title":"文档","type":"tags"}]