[{"content":"Blueprint 可以作为 Hugo 主题子模块安装，也可以复制到站点的 themes 目录。下面使用子模块，便于明确更新。\n要求 Hugo extended 0.158.0 或更新版本 Git 一个 Hugo 站点 安装前检查 Hugo：\nhugo version 安装 在 Hugo 站点根目录运行：\ngit submodule add https://github.com/Kircerta/hugo-blueprint.git themes/hugo-blueprint 在 hugo.toml 中启用主题：\ntheme = \u0026#34;hugo-blueprint\u0026#34; 配置 Blueprint 使用与 PaperMod 相同的内容模型。下面的配置启用文章列表、搜索索引、目录和主题标签。\ntitle = \u0026#34;Blueprint\u0026#34; theme = \u0026#34;hugo-blueprint\u0026#34; defaultTheme = \u0026#34;dark\u0026#34; disableThemeToggle = true [outputs] home = [\u0026#34;HTML\u0026#34;, \u0026#34;RSS\u0026#34;, \u0026#34;JSON\u0026#34;] [params] mainSections = [\u0026#34;posts\u0026#34;] ShowReadingTime = true ShowToc = true TocOpen = false [params.blueprint] homeKicker = \u0026#34;BLUEPRINT BLOG\u0026#34; articlePrefix = \u0026#34;ARTICLE\u0026#34; entryCta = \u0026#34;READ ARTICLE\u0026#34; documentLabel = \u0026#34;ARTICLE\u0026#34; 预览 启动本地服务：\nhugo server 打开 Hugo 输出的本地地址。编辑 content/posts 下的文件后刷新浏览器即可预览。\n","permalink":"/hugo-blueprint/zh/posts/installation-guide/","summary":"在 Hugo 站点中安装 Blueprint 并启用示例配置。","title":"Blueprint 安装指南"},{"content":"这篇文章展示 Blueprint 内容中常用的元素。\n标题 三级标题 标题会生成文章目录。第一段正文应靠近摘要，便于读者快速进入内容。\n段落 普通段落使用 Markdown 编写。Blueprint 会保持居中的阅读列，并在文章标题下方显示紧凑元数据。\n行内链接、行内代码、粗体 和 强调 使用 Hugo Goldmark 的 Markdown 语法。\n列表 确认构建目标。 编写内容。 运行本地预览。 发布静态输出。 研究笔记 项目日志 API 参考 表格 Blueprint 文章中的表格默认居中。\n页面 用途 首页 最近文章 归档 按时间浏览 搜索 本地 JSON 搜索 标签 主题聚合 站点控件 页头包含关于、归档、搜索和标签入口。有翻译内容时，语言切换会显示在站点标题旁边。\n模式切换按钮固定在页面角落。显示文字来自 params.blueprint。\n[params.blueprint] homeKicker = \u0026#34;BLUEPRINT BLOG\u0026#34; articlePrefix = \u0026#34;ARTICLE\u0026#34; entryCta = \u0026#34;READ ARTICLE\u0026#34; 引用 Blueprint 是一个带文章卡片、居中内容和本地搜索的技术写作主题。\n搜索 在站点配置中启用 JSON 输出，并创建使用 search layout 的搜索页面。示例站已经包含这两项。\n代码块 Blueprint 保留 Hugo 的语法高亮支持，并让代码块适配主题配色。\nhugo server --buildDrafts baseURL = \u0026#34;https://example.com/\u0026#34; title = \u0026#34;Blueprint\u0026#34; theme = \u0026#34;hugo-blueprint\u0026#34; [outputs] home = [\u0026#34;HTML\u0026#34;, \u0026#34;RSS\u0026#34;, \u0026#34;JSON\u0026#34;] 1 2 3 4 5 6 7 8 package main import \u0026#34;fmt\u0026#34; func main() { name := \u0026#34;Blueprint\u0026#34; fmt.Println(name) } 在 [params] 中设置 ShowCodeCopyButtons = true 即可为支持的代码块显示复制按钮。\n","permalink":"/hugo-blueprint/zh/posts/demo-article/","summary":"Markdown 语法、代码块、文章导航、表格和内置站点页面。","title":"Blueprint 示例文章"},{"content":"Blueprint 是一个基于 PaperMod 的 Hugo 技术写作主题。这个示例站展示安装说明、Markdown 排版、代码块、搜索、标签、归档和语言切换。\n示例范围 页面 用途 首页 最近文章 文章页 带紧凑元数据的阅读视图 归档 按时间回看内容 搜索 本地 JSON 搜索 标签 主题聚合 适合场景 Blueprint 适合研究笔记、工程日志、文档札记、课程笔记和个人知识库。\n","permalink":"/hugo-blueprint/zh/about/","summary":"这个示例站展示的内容。","title":"关于 Blueprint"}]