分类: 高级

  • 高级功能

    分类:

    这一章介绍主题的高级能力。无需外部服务的键盘导航默认开启；会改变站点策略或向第三方传输数据的能力仍需显式启用——主题提供实现，但不替站点做策略决定。 本章内容 键盘导航：完整单键映射、焦点规则与按页关闭方法 搜索与命令面板：本地索引、搜索排序、Cmd/Ctrl-K、/ 完整搜索与 \ 命令模式 打印输出：整个分区的打印视图 AI 与 Agent 支持：Markdown 输出、llms.txt、页面操作 评论：giscus 集成 分析统计：Google Analytics 与其他统计服务 默认值遵 …

    这一章介绍主题的高级能力。无需外部服务的键盘导航默认开启；会改变站点策略或向第三方传输数据的能力仍需显式启用——主题提供实现，但不替站点做策略决定。 本章内容 键盘导航：完整单键映射、焦点规则与按页关闭方法 搜索与命令面板：本地索引、搜索排序、Cmd/Ctrl-K、/ 完整搜索与 \ 命令模式 打印输出：整个分区的打印视图 AI 与 Agent 支持：Markdown 输出、llms.txt、页面操作 评论：giscus 集成 分析统计：Google Analytics 与其他统计服务 默认值遵 …

  • 分析、用户反馈与 SEO

    分类:

    OINK 默认不会连接分析、表单、评论或广告服务。这些集成属于站点决策：必须显式启用、记录数据边界，并根据用户与站点所在司法辖区提供必要的同意机制或政策说明。 添加分析 Hugo 为分析服务提供嵌入模板。站点配置 Google Analytics 后，页面浏览量与自定义事件等浏览器使用信息会发送给 Google。这与完全网络隔离的运行环境不兼容，也可能不符合严格的同源内容安全策略（CSP）。 配置 取得站点的 Google Analytics measurement ID，然后使用 Hugo 当 …

    OINK 默认不会连接分析、表单、评论或广告服务。这些集成属于站点决策：必须显式启用、记录数据边界，并根据用户与站点所在司法辖区提供必要的同意机制或政策说明。 添加分析 Hugo 为分析服务提供嵌入模板。站点配置 Google Analytics 后，页面浏览量与自定义事件等浏览器使用信息会发送给 Google。这与完全网络隔离的运行环境不兼容，也可能不符合严格的同源内容安全策略（CSP）。 配置 取得站点的 Google Analytics measurement ID，然后使用 Hugo 当 …

  • 使用 giscus 添加评论

    分类:

    OINK 在 params.comments 下提供与 Hextra 兼容的评论配置，并通过该配置支持 giscus。giscus 会为每个内容页关联一条由 GitHub Discussions 保存的评论线程，读者通过 GitHub OAuth 登录后即可发表评论。 giscus 如何工作 页面加载时，giscus 会在配置的仓库中查找与当前页面匹配的 Discussion。如果没有找到，读者首次发表评论或表态时，giscus bot 会自动创建一条。维护者直接在 GitHub …

    OINK 在 params.comments 下提供与 Hextra 兼容的评论配置，并通过该配置支持 giscus。giscus 会为每个内容页关联一条由 GitHub Discussions 保存的评论线程，读者通过 GitHub OAuth 登录后即可发表评论。 giscus 如何工作 页面加载时，giscus 会在配置的仓库中查找与当前页面匹配的 Discussion。如果没有找到，读者首次发表评论或表态时，giscus bot 会自动创建一条。维护者直接在 GitHub …

  • AI 智能体支持

    分类:

    早期评估 本页介绍的功能仍处于实验阶段，适合早期采用和评估。后续版本可能会调整输出细节和验证范围。要跟踪智能体支持功能的阶段性演进，请参阅 Improve support for AI-agent doc consumption #2614。 功能 站点显式启用后，OINK 会提供以下面向用户和机器可读的行为： 支持 Markdown 输出格式。项目的 outputs 配置决定哪些页面类型发布 Markdown。 发现机制：页面 HTML 的 header 会包含指向该页 Markdown 版本 …

    早期评估 本页介绍的功能仍处于实验阶段，适合早期采用和评估。后续版本可能会调整输出细节和验证范围。要跟踪智能体支持功能的阶段性演进，请参阅 Improve support for AI-agent doc consumption #2614。 功能 站点显式启用后，OINK 会提供以下面向用户和机器可读的行为： 支持 Markdown 输出格式。项目的 outputs 配置决定哪些页面类型发布 Markdown。 发现机制：页面 HTML 的 header 会包含指向该页 Markdown 版本 …

  • 打印支持

    分类:

    大多数浏览器都能很好地打印单篇文档，因为页面样式会从打印输出中移除导航外壳。因此，打印单个页面交给浏览器自带的 Cmd/Ctrl+P 即可，OINK 不再提供页面级的打印操作。 有些站点适合启用“打印整节”功能（本用户指南就是如此）。选择后，系统会把当前顶层分区（例如本页所在的“高级特性”）连同全部子页面和子分区渲染为适合打印的格式，并附上该分区的完整目录。 要启用此功能，请在站点的 hugo.toml、hugo.yaml 或 hugo.json 中，为 section 类型添加 print 输 …

    大多数浏览器都能很好地打印单篇文档，因为页面样式会从打印输出中移除导航外壳。因此，打印单个页面交给浏览器自带的 Cmd/Ctrl+P 即可，OINK 不再提供页面级的打印操作。 有些站点适合启用“打印整节”功能（本用户指南就是如此）。选择后，系统会把当前顶层分区（例如本页所在的“高级特性”）连同全部子页面和子分区渲染为适合打印的格式，并附上该分区的完整目录。 要启用此功能，请在站点的 hugo.toml、hugo.yaml 或 hugo.json 中，为 section 类型添加 print 输 …

  • 搜索与命令面板

    分类:

    OINK 默认且推荐本地搜索：Hugo 为每种语言生成独立索引，Lunr 与 CJK 回退都从同源资源提供。站点不需要公共爬虫、外部账户、CDN 或网络连接就能完成构建和搜索。 Google Custom Search 与 Algolia DocSearch 作为兼容集成保留，默认关闭。同一时间只能启用一种搜索实现。 启用本地搜索 hugo.yaml YAML params: offlineSearch: true offlineSearchIndex: summary # summary | …

    OINK 默认且推荐本地搜索：Hugo 为每种语言生成独立索引，Lunr 与 CJK 回退都从同源资源提供。站点不需要公共爬虫、外部账户、CDN 或网络连接就能完成构建和搜索。 Google Custom Search 与 Algolia DocSearch 作为兼容集成保留，默认关闭。同一时间只能启用一种搜索实现。 启用本地搜索 hugo.yaml YAML params: offlineSearch: true offlineSearchIndex: summary # summary | …

  • 键盘导航

    分类:

    OINK 在文档、博客与 Swagger 页面内置单键键盘导航。默认开启，所有按键都会为输入让行，站点或单页均可关闭。设计上，当前页就是侧栏的隐含光标，章节跳转复用渲染后的页面目录，所有动作都委托给主题的既有机制，不维护第二套平行状态。 快捷键 侧边栏 w、s、a、d 一步到位地驾驭侧边栏：当前页面所在项就是隐含的起点，首次按键即从那里移动或折叠。焦点行的底色比“当前页”药丸更深一档，“我在哪”与“光标在哪”一眼可辨。窄屏下侧栏收进抽屉时，首次按键会先打开抽屉；桌面侧栏若已折叠，同一次按键会先恢 …

    OINK 在文档、博客与 Swagger 页面内置单键键盘导航。默认开启，所有按键都会为输入让行，站点或单页均可关闭。设计上，当前页就是侧栏的隐含光标，章节跳转复用渲染后的页面目录，所有动作都委托给主题的既有机制，不维护第二套平行状态。 快捷键 侧边栏 w、s、a、d 一步到位地驾驭侧边栏：当前页面所在项就是隐含的起点，首次按键即从那里移动或折叠。焦点行的底色比“当前页”药丸更深一档，“我在哪”与“光标在哪”一眼可辨。窄屏下侧栏收进抽屉时，首次按键会先打开抽屉；桌面侧栏若已折叠，同一次按键会先恢 …