<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>文档 · 使用指南 on Banyan</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/articles/docs-guide/</link><description>Recent content in 文档 · 使用指南 on Banyan</description><generator>Hugo</generator><language>zh-Hans</language><lastBuildDate>Mon, 16 Nov 2026 00:00:00 +0800</lastBuildDate><atom:link href="https://f6e67316.banyan-git-test.pages.dev/zh/articles/docs-guide/index.xml" rel="self" type="application/rss+xml"/><item><title>外观 · 配色与首页定制</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/appearance-customization/</link><pubDate>Sun, 15 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/appearance-customization/</guid><description>&lt;p&gt;先完成&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/site-configuration/"&gt;站点基本设置&lt;/a&gt;，再按需要修改外观。只改首页文字时，直接阅读“最小首页艺术包”或“首页信号”。&lt;/p&gt;&#10;&lt;h2 id="palette"&gt;配色&lt;/h2&gt;&#10;&lt;p&gt;编辑 &lt;code&gt;hugo.toml&lt;/code&gt; 中已有的配色设置；文件路径相对于 &lt;code&gt;assets/&lt;/code&gt;：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-toml" data-lang="toml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;params&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;appearance&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;palette&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;site/theme.css&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;站点自行维护完整配色，Module 不提供默认配色。&#10;默认使用 &lt;code&gt;site/theme.css&lt;/code&gt;。需要高对比外观时，把上面的值改为 &lt;code&gt;site/theme.high-contrast.css&lt;/code&gt;。&#10;三套参考配色（默认、高对比度、Rose）都包含浅色和深色，不改变彩色图片。标题线的定制示例见各配色文件中的变量注释。&#10;自定义文件如 &lt;code&gt;assets/site/theme-custom.css&lt;/code&gt;，配置为 &lt;code&gt;palette = &amp;quot;site/theme-custom.css&amp;quot;&lt;/code&gt;。&#10;修改后重新构建并部署；外观页继续在所选配色中切换跟随系统、浅色和深色。&lt;/p&gt;&#10;&lt;h3 id="自定义配色"&gt;自定义配色&lt;/h3&gt;&#10;&lt;p&gt;复制完整配色文件后修改颜色，并将 &lt;code&gt;palette&lt;/code&gt; 指向该文件。&#10;同路径文件整体替换，不按 CSS 声明合并。配色文件维护颜色角色及其浅色、深色值，条目圆角使用 &lt;code&gt;--item-radius&lt;/code&gt;，表头线可指定颜色及是否占位；列表结构、动画和交互规则保留在组件中。&#10;&lt;code&gt;--item-current-marker&lt;/code&gt; 控制当前项起始边线的颜色，设为 &lt;code&gt;transparent&lt;/code&gt; 隐藏；保留标记宽度。&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;.item-list&lt;/code&gt; 的 &lt;code&gt;--list-header-border&lt;/code&gt; 和 &lt;code&gt;.prose&lt;/code&gt; 的 &lt;code&gt;--prose-heading-border&lt;/code&gt; 使用完整边框声明：&lt;code&gt;none&lt;/code&gt; 取消线条和占位，&lt;code&gt;1px solid transparent&lt;/code&gt; 隐藏线条并保留占位，&lt;code&gt;1px solid #888&lt;/code&gt; 显示线条。单独定制正文栏标题线时，有目录按钮的页面在 &lt;code&gt;.document-heading&lt;/code&gt; 中设置该变量，其余页面在 &lt;code&gt;.prose &amp;gt; h1.column-heading&lt;/code&gt; 中设置。&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;作用域&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;颜色用途&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;:root&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;页面背景、正文、弱化文字、边框、强调色、链接和焦点&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.icon&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;彩色图标的强调色和阴影；线条图标仍使用 &lt;code&gt;currentColor&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.item-control&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;普通、已访问、悬停、焦点和当前项的文字、背景及边框&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.item-list&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;列表标题和第一列首项的表头线&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.prose&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;标题、分隔线、删除文字、代码、引用、图片、表格和语法高亮&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.home-art-wind&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;风场艺术包中的锚点、地平线、信号和风向袋&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;无模式限定的作用域用于浅色和深色；深色规则只覆盖不同的值。&#10;在对应作用域中修改颜色，并同时检查浅色和深色规则。&#10;例如，修改表头背景时，替换已有的两处声明：&lt;/p&gt;</description></item><item><title>03 首次部署</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/deploying/</link><pubDate>Sat, 14 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/deploying/</guid><description>&lt;p&gt;先完成&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/site-configuration/"&gt;02 设置自己的站点&lt;/a&gt;。本页的 PowerShell 命令从站点根目录运行，并使用&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/getting-started/"&gt;开始使用&lt;/a&gt;中定义的 &lt;code&gt;swban&lt;/code&gt; 简称。引号中的 &lt;code&gt;&amp;lt;正式网址&amp;gt;&lt;/code&gt; 是需要替换的占位符。&lt;/p&gt;&#10;&lt;h2 id="选择部署方式"&gt;选择部署方式&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;方式&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;需要提供&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;适用情况&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;本地构建后上传&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;检查通过的 HTML 和资源目录&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;先在本机完成构建，再发布&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Git 托管构建&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;站点源码仓库与平台构建配置&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;推送代码后由平台自动构建和发布&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;用 &lt;code&gt;swban help/zh deploy&lt;/code&gt; 查看按平台和方式划分的准备专项。Banyan 提供静态站点构建、交付配置生成和检查；账号授权、云项目创建、上传及 Git 接入由 &lt;a href="https://github.com/SwawHQ/swaw-clouds"&gt;Swaw Clouds&lt;/a&gt; 的专项说明指导。&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;平台&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Banyan 提供的配置&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;平台操作说明&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Cloudflare Pages&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;_headers&lt;/code&gt;、&lt;code&gt;_redirects&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;a href="https://github.com/SwawHQ/swaw-clouds/blob/main/skills/swaw-clouds/tasks/cloudflare/deploy/pages-upload/help.json"&gt;上传产物&lt;/a&gt; · &lt;a href="https://github.com/SwawHQ/swaw-clouds/blob/main/skills/swaw-clouds/tasks/cloudflare/deploy/pages-git/help.json"&gt;Git 托管构建&lt;/a&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;EdgeOne Makers&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;edgeone.json&lt;/code&gt; 交付规则&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;a href="https://github.com/SwawHQ/swaw-clouds/blob/main/skills/swaw-clouds/tasks/edgeone/deploy/upload/help.json"&gt;上传产物&lt;/a&gt; · &lt;a href="https://github.com/SwawHQ/swaw-clouds/blob/main/skills/swaw-clouds/tasks/edgeone/deploy/git/help.json"&gt;Git 托管构建&lt;/a&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;其他静态托管、对象存储与 CDN&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;HTML、资源和浏览器端 SW 策略&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;按目标平台配置响应头、重定向和缓存；Banyan 暂不生成这些平台的专用配置&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;两种方式使用同一套源码。上传方式交付产物目录；Git 方式交付源码和构建参数。切换前，按对应专项核对平台是否允许复用原项目。&lt;/p&gt;&#10;&lt;p&gt;在所选平台建立账号并确定目标项目。将 &lt;code&gt;hugo.toml&lt;/code&gt; 的 &lt;code&gt;baseURL&lt;/code&gt; 设为要公开使用的网址；若首次上传后才取得平台域名，取得后回填该值，重新构建并上传。绑定自有域名后也要更新它。&lt;/p&gt;&#10;&lt;h2 id="设置平台"&gt;设置平台&lt;/h2&gt;&#10;&lt;p&gt;编辑已有的 &lt;code&gt;assets/site/delivery.toml&lt;/code&gt;，找到 &lt;code&gt;[platform]&lt;/code&gt; 下的开关。只使用 Cloudflare Pages 时：&lt;/p&gt;</description></item><item><title>参考 · 项目术语表</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/glossary/</link><pubDate>Fri, 13 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/glossary/</guid><description>&lt;p&gt;对话和文档优先使用下表名称。机制名称带上作用范围；上下文明确时可用简称。对应标识用于查找配置或实现。&lt;/p&gt;&#10;&lt;h2 id="页面区域"&gt;页面区域&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;术语&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;含义&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;对应标识&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;根导航列&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;页面第一列，显示首页和已发布的根页面入口。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.page-rail&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;根入口&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;根导航列中的一个条目，指向首页、顶层栏目或独立根页面。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;data-root-href&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;面包屑列&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;显示浏览路径中某一级栏目的条目，供用户选择同级内容。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.breadcrumb-column&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;主内容列&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;显示当前页面的文章、列表或其他主要内容。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.page-content&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;文档辅助列&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;容纳文章元信息和章节目录的页面列。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.document-aside&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;文章元信息&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;说明文章的目录归属、日期及相关链接等信息。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.document-meta&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;章节目录&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;由当前文章的章节标题组成的跳转列表。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.document-toc&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;主列表&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;当前集合页面在主内容列中显示的条目列表。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;feature-browse/collection/render.html&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;结构面包屑&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;按页面真实内容层级生成的路径数据，用于 SEO 等输出。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;BreadcrumbList&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;页面画幅&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;横向排列根导航列、面包屑列和阅读组的整体区域。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.page-shell&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;阅读组&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;将主内容列和文档辅助列组合在一起的布局区域。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.reading-group&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;搜索页&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;在根导航列输入关键词，并在正文宽度的主内容列显示当前语言的搜索结果。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;page-search&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;图片墙&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;用封面卡片呈现分类或文章的集合视图。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;page-collection-wall&lt;/code&gt;、&lt;code&gt;page-collection-wall-all&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;区域配置见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/layout-slots/"&gt;页面区域与布局&lt;/a&gt;，组件和样式见 &lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/ui-naming/"&gt;UI 命名与职责&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="内容与路径"&gt;内容与路径&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;术语&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;含义&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;对应标识&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;分类&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;按主题或用途组织内容的方式，通过栏目层级和文章引用实现。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;内容目录、&lt;code&gt;_map.toml&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;栏目&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;组织子栏目、文章和引用的内容节点。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;_index.md&lt;/code&gt;、&lt;code&gt;section&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;文章&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;保存一篇正文及其元信息的内容页面，也可用于介绍产品。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;index.md&lt;/code&gt;、&lt;code&gt;page-article-*&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;页面包&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;将页面文件与图片等资源放在同一目录中的内容单元。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;含 &lt;code&gt;index.md&lt;/code&gt; 或 &lt;code&gt;_index.md&lt;/code&gt; 的目录&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;栏目文章引用&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;在栏目中收录已有文章，条目链接指向原文。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;_map.toml&lt;/code&gt; 中的 &lt;code&gt;refs&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;文章默认归属&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;由文章实际所在目录确定的栏目路径。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;文章的内容祖先&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;多维分类&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;将同一篇文章放入多个分类路径；正文保存在文章默认归属下，其他栏目通过引用收录。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;_map.toml&lt;/code&gt;、&lt;code&gt;refs&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;汇总列表&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;汇集指定栏目及其子栏目中的文章和引用，同一篇文章计入一次。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;params.aggregate&lt;/code&gt;、&lt;code&gt;page-collection-*-all&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;汇总时间范围&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;按文章更新时间划分汇总内容的区间，包含起点，截止到终点之前。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;params.time_range&lt;/code&gt;、&lt;code&gt;Lastmod&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;内容路径&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;页面在内容树中的逻辑位置，例如 &lt;code&gt;/articles/category1/example&lt;/code&gt;。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;_map.toml&lt;/code&gt; 引用路径、Hugo &lt;code&gt;.Path&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;发布网址&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;用户访问页面的地址，例如 &lt;code&gt;/zh/p/example-product/&lt;/code&gt;。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;url&lt;/code&gt;、&lt;code&gt;.RelPermalink&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;文章浏览来源&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;用户进入文章时所经的栏目路径，用于呈现该次浏览的导航。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;网址中的 &lt;code&gt;from&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;导航排序状态&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;浏览路径中各栏目及主列表各自采用的排序方式，随网址保留，不传给子栏目。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;网址中的 &lt;code&gt;sorts&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;章节锚点&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;指向正文某一标题或元素的位置标识。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;元素 &lt;code&gt;id&lt;/code&gt;、&lt;code&gt;#标题ID&lt;/code&gt;、&lt;code&gt;anchor&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;共享导航片段&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;构建时生成、由浏览器加载并填入面包屑列的 HTML 内容。&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/site/navigation/*.txt&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;描述内容组织和浏览方式时使用“分类”；指定某个内容节点及其配置时使用“栏目”。例如：“按用途分类，将文章引用到工具栏目。”&lt;/p&gt;</description></item><item><title>01 开始使用</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/getting-started/</link><pubDate>Fri, 06 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/getting-started/</guid><description>&lt;p&gt;首次使用按本页取得站点、准备工具并完成本地预览，再按&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/site-configuration/"&gt;第二篇教程&lt;/a&gt;设置自己的站点。网站内容与配置由你维护；Banyan 主题提供页面布局，配套 Skill 提供本地工具和检查命令。&lt;/p&gt;&#10;&lt;h2 id="安装前"&gt;安装前&lt;/h2&gt;&#10;&lt;p&gt;目前正在准备首次发布。发布标签可用前，可以使用当前仓库作本地预览；远程 Module 安装须等标签发布。&lt;/p&gt;&#10;&lt;p&gt;支持 Windows x64、Linux x64 和 macOS x64/ARM64。首次运行会复用兼容的已有工具，并下载缺少的工具。不需要另在站点根目录执行 &lt;code&gt;npm install&lt;/code&gt;。主题要求 Hugo 0.168.0 或更新版本，Skill 会准备匹配工具。Linux 需有 sh、基础系统工具、curl、tar、sha256sum；macOS 使用系统自带工具。Git 等工具缺少时会下载到本地目录，无需 Python、Homebrew 或 Xcode。&lt;/p&gt;&#10;&lt;h2 id="取得站点"&gt;取得站点&lt;/h2&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;在&lt;a href="https://github.com/SwawHQ/banyan/releases"&gt;项目 Releases&lt;/a&gt;选择版本，下载 &lt;strong&gt;Source code (zip)&lt;/strong&gt;。尚无发布版本时，在&lt;a href="https://github.com/SwawHQ/banyan"&gt;仓库首页&lt;/a&gt;选择 &lt;strong&gt;Code → Download ZIP&lt;/strong&gt;，取得当前开发版。&lt;/li&gt;&#10;&lt;li&gt;完整解压到自己的站点目录。确认其中有 &lt;code&gt;hugo.toml&lt;/code&gt;、&lt;code&gt;go.mod&lt;/code&gt;、&lt;code&gt;module/&lt;/code&gt;、&lt;code&gt;content/&lt;/code&gt;、&lt;code&gt;assets/&lt;/code&gt; 和 &lt;code&gt;.agents/&lt;/code&gt;，不要只取 &lt;code&gt;module/&lt;/code&gt;。&lt;/li&gt;&#10;&lt;li&gt;在包含 &lt;code&gt;hugo.toml&lt;/code&gt; 的目录打开 PowerShell。后面的命令都从这里运行。&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;p&gt;完整源码包通过 &lt;code&gt;go.mod&lt;/code&gt; 中的本地替换使用随包附带的 &lt;code&gt;module/&lt;/code&gt;，因此预览时要保留该目录。以后改用已发布的 Module 时，再按下方“调整版本”处理。&lt;/p&gt;&#10;&lt;p&gt;先运行一次：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-powershell" data-lang="powershell"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;function&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nb"&gt;swban&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="p"&gt;&amp;amp;&lt;/span&gt; &lt;span class="p"&gt;.\&lt;/span&gt;&lt;span class="n"&gt;swban&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="py"&gt;cmd&lt;/span&gt; &lt;span class="nv"&gt;@args&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="c"&gt;#在本终端定义命令简称&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="n"&gt;swban&lt;/span&gt; &lt;span class="n"&gt;base&lt;/span&gt;&lt;span class="p"&gt;/&lt;/span&gt;&lt;span class="n"&gt;hugo&lt;/span&gt; &lt;span class="n"&gt;version&lt;/span&gt; &lt;span class="c"&gt;#准备工具并显示 Hugo 版本&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="n"&gt;swban&lt;/span&gt; &lt;span class="n"&gt;base&lt;/span&gt;&lt;span class="p"&gt;/&lt;/span&gt;&lt;span class="n"&gt;packages&lt;/span&gt;&lt;span class="p"&gt;/&lt;/span&gt;&lt;span class="n"&gt;ensure&lt;/span&gt; &lt;span class="c"&gt;#准备 Skill 核心依赖&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="n"&gt;swban&lt;/span&gt; &lt;span class="n"&gt;doctor&lt;/span&gt; &lt;span class="c"&gt;#检查工具、主题和 Skill&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;swban&lt;/code&gt; 是上面定义的 PowerShell 函数，不是自动加入 PATH 的命令。新开终端时重新定义，或使用完整的 &lt;code&gt;.\.agents\skills\swaw-banyan\swban.cmd&lt;/code&gt; 路径。若命令报错，先按提示处理，再继续。&lt;/p&gt;</description></item><item><title>02 设置自己的站点</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/site-configuration/</link><pubDate>Fri, 06 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/site-configuration/</guid><description>&lt;h2 id="根配置"&gt;根配置&lt;/h2&gt;&#10;&lt;p&gt;本页在完整参考站点上修改配置。安装和预览命令见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/getting-started/"&gt;开始使用&lt;/a&gt;。示例只展示相关字段：在已有表中修改对应项，不要把整段追加到文件末尾。&lt;/p&gt;&#10;&lt;p&gt;在 &lt;code&gt;hugo.toml&lt;/code&gt; 开头修改正式网址：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-toml" data-lang="toml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;baseURL&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;https://example.com/&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;把示例域名换成自己的完整网址；如果部署在子目录中，连同子目录一起填写，例如 &lt;code&gt;https://example.com/blog/&lt;/code&gt;。它影响站点地图、订阅和规范地址。本地预览仍使用终端显示的本机网址。&lt;/p&gt;&#10;&lt;p&gt;初次配置时保留其余构建设置，尤其是：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;设置&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;保留它的原因&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;minify.disableJS = true&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;避免压缩改变脚本后，浏览器因 CSP 拒绝执行&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;module.mounts&lt;/code&gt; 中的界面字典挂载&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;让界面使用站点的 &lt;code&gt;assets/i18n/&lt;/code&gt; 字典&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;cascade&lt;/code&gt; 中的 &lt;code&gt;build.publishResources = false&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;避免自动发布未使用的页面包文件，包括 &lt;code&gt;_map.toml&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;printPathWarnings&lt;/code&gt;、&lt;code&gt;panicOnWarning&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;在页面发布网址冲突时停止构建&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;文章网址与栏目目录见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/directories/"&gt;目录与引用&lt;/a&gt;，索引开关见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/discovery/"&gt;站点发现&lt;/a&gt;，部署步骤见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/deploying/"&gt;首次部署&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="站点说明与语言"&gt;站点说明与语言&lt;/h2&gt;&#10;&lt;p&gt;先编辑首页。参考站的 &lt;code&gt;content/_index.md&lt;/code&gt; 是英文首页，&lt;code&gt;content/_index.zh.md&lt;/code&gt; 是中文首页，&lt;code&gt;content/_index.ar.md&lt;/code&gt; 是阿拉伯文首页。例如，在中文首页修改已有字段：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;title&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;我的站点&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;description&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;介绍本站提供的内容。&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;title&lt;/code&gt; 用作站名；&lt;code&gt;linkTitle&lt;/code&gt; 可单独设置导航文字。参考首页还设有 &lt;code&gt;params.browser_title&lt;/code&gt;，它会覆盖浏览器标签标题，应一并修改或删除。各篇文章的 &lt;code&gt;description&lt;/code&gt; 可覆盖首页提供的默认说明。&lt;/p&gt;&#10;&lt;p&gt;首页可见的风场文字来自它引用的艺术包，不是首页的 &lt;code&gt;title&lt;/code&gt;。修改步骤见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/appearance-customization/#%e9%a6%96%e9%a1%b5%e4%bf%a1%e5%8f%b7"&gt;首页定制&lt;/a&gt;；想先用简单文字首页，可切换到&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/appearance-customization/#%e6%9c%80%e5%b0%8f%e9%a6%96%e9%a1%b5%e8%89%ba%e6%9c%af%e5%8c%85"&gt;最小首页艺术包&lt;/a&gt;。&lt;/p&gt;&#10;&lt;p&gt;语言在 &lt;code&gt;hugo.toml&lt;/code&gt; 的 &lt;code&gt;[languages]&lt;/code&gt; 中设置：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-toml" data-lang="toml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;languages&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;en&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;label&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;English&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;en&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;locale&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;en-US&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;en&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;weight&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;zh&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;label&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;中文&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;zh&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;locale&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;zh-Hans&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;zh&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;weight&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;label&lt;/code&gt; 是语言名称，&lt;code&gt;weight&lt;/code&gt; 控制排列顺序；根配置的 &lt;code&gt;defaultContentLanguage&lt;/code&gt; 决定默认语言。它不会随排列顺序改变。&lt;code&gt;defaultContentLanguageInSubdir&lt;/code&gt; 决定默认语言是否也放在语言子目录中，调整后检查原有网址。&lt;/p&gt;&#10;&lt;p&gt;暂时不提供某种语言时，可在文件顶部、任何 TOML 表之前设置：&lt;/p&gt;</description></item><item><title>发布 · 站点发现与来源链接</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/discovery/</link><pubDate>Fri, 06 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/discovery/</guid><description>&lt;h2 id="结构化数据"&gt;结构化数据&lt;/h2&gt;&#10;&lt;p&gt;页面使用 JSON-LD 向机器提供结构化数据。Schema.org 定义类型和字段：&#10;站点使用 &lt;code&gt;WebSite&lt;/code&gt;，文章使用 &lt;code&gt;BlogPosting&lt;/code&gt;，面包屑使用 &lt;code&gt;BreadcrumbList&lt;/code&gt;，集合列表使用 &lt;code&gt;ItemList&lt;/code&gt;。&#10;这些数据由模板随 HTML 生成。概念见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/glossary/#%e7%bb%93%e6%9e%84%e5%8c%96%e6%95%b0%e6%8d%ae"&gt;项目术语表&lt;/a&gt;，&#10;文章和面包屑数据的装配见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/layout-slots/"&gt;页面区域与布局&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="rss-订阅"&gt;RSS 订阅&lt;/h2&gt;&#10;&lt;p&gt;在 &lt;code&gt;content/rss/index*.md&lt;/code&gt; 中维护订阅说明，正文调用 &lt;code&gt;{{&amp;lt; rss-link &amp;gt;}}&lt;/code&gt; 显示当前语言的订阅地址。&lt;/p&gt;&#10;&lt;p&gt;使用前在 &lt;code&gt;[outputs].home&lt;/code&gt; 启用 RSS；删除 RSS 说明页不会关闭订阅输出。&lt;/p&gt;&#10;&lt;p&gt;RSS 页面按“全部文章 + 分类订阅”组织：全站地址使用 &lt;code&gt;rss-link&lt;/code&gt; 读取实际输出；分类部分说明各栏目订阅地址。示例通过 &lt;code&gt;site-root&lt;/code&gt; 输出当前语言首页的绝对网址，自动保留部署子路径和语言前缀，其余分类路径以代码展示。分类是否提供 RSS 由其输出配置决定；普通文章默认不单独发布 RSS。&lt;/p&gt;&#10;&lt;p&gt;栏目 RSS 与目录计数、汇总列表共用递归成员，包含子栏目的真实文章和 &lt;code&gt;_map.toml&lt;/code&gt; 引用。&#10;同一正文在一个 feed 中只出现一次，链接始终指向原文。RSS 只收录布局为 &lt;code&gt;page-article-rss&lt;/code&gt; 的文章。首页 RSS 使用当前语言可列出的文章；&#10;产品栏目使用相同规则；不同栏目的 RSS 可以收录同一篇文章。输出由 &lt;code&gt;[outputs]&lt;/code&gt; 控制，条数使用 &lt;code&gt;[services.rss].limit&lt;/code&gt;。&lt;/p&gt;&#10;&lt;h2 id="sitemap"&gt;Sitemap&lt;/h2&gt;&#10;&lt;p&gt;Sitemap 收录已渲染且可索引的 HTML 页面，包括 &lt;code&gt;build.list: local&lt;/code&gt; 和&#10;&lt;code&gt;build.list: never&lt;/code&gt; 页面。页面 front matter 可用以下设置排除收录：&lt;/p&gt;</description></item><item><title>内容 · 栏目与引用</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/directories/</link><pubDate>Fri, 06 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/directories/</guid><description>&lt;h2 id="用目录组织正文"&gt;用目录组织正文&lt;/h2&gt;&#10;&lt;p&gt;分类通过栏目层级和文章引用实现，栏目名称由站点定义。Banyan 最小演示用 &lt;code&gt;articles&lt;/code&gt;、&lt;code&gt;articles-all&lt;/code&gt; 展示文章分类与全部列表，&#10;用 &lt;code&gt;products&lt;/code&gt;、&lt;code&gt;products-all&lt;/code&gt; 展示产品分类与全部列表。这些目录名可以按本站需要修改。&lt;/p&gt;&#10;&lt;p&gt;正文放在所属目录中，栏目列表直接使用这些文件。需要把同一篇文章列入其他栏目时，&#10;在目标栏目放入 &lt;code&gt;_map.toml&lt;/code&gt;，添加栏目文章引用。&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;content/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├─ articles/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ ├─ _index.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ └─ category1/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ ├─ _index.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ └─ example/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ └─ index.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├─ articles-all/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ └─ _index.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├─ products/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ ├─ _index.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ └─ examples/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ ├─ _index.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ └─ _map.toml&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;└─ products-all/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; └─ _index.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;示例省略同路径的中文译文。有子文章的栏目使用 &lt;code&gt;_index.&amp;lt;lang&amp;gt;.md&lt;/code&gt;，其中的标题、&#10;介绍和正文属于该栏目。单篇文章统一使用 &lt;code&gt;name/index.&amp;lt;lang&amp;gt;.md&lt;/code&gt; 叶子包，&#10;文章资源放在同一目录。&lt;code&gt;index.&amp;lt;lang&amp;gt;.md&lt;/code&gt; 不用于容纳下级文章的栏目。&#10;默认语言文件可以省略语言后缀。&lt;/p&gt;&#10;&lt;p&gt;文章模板由站点根 &lt;code&gt;archetypes/banyan.md&lt;/code&gt; 维护，Module 和传统主题目录不提供。&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;swban base/hugo new content --kind banyan articles/my-post/index.zh.md #新建中文文章&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;生成后编辑标题、说明和正文，发布前将 &lt;code&gt;draft&lt;/code&gt; 改为 &lt;code&gt;false&lt;/code&gt;。完整操作见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/getting-started/#%e6%b7%bb%e5%8a%a0%e7%ac%ac%e4%b8%80%e7%af%87%e6%96%87%e7%ab%a0"&gt;添加第一篇文章&lt;/a&gt;。栏目布局和文章布局由上级 &lt;code&gt;cascade&lt;/code&gt; 继承，无须为每篇文章再写分类字段。&#10;列表配置见 &lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/collection-lists/"&gt;列表与产品声明&lt;/a&gt;。&lt;/p&gt;</description></item><item><title>内容 · 列表、图片墙与产品</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/collection-lists/</link><pubDate>Fri, 06 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/collection-lists/</guid><description>&lt;p&gt;页面的 &lt;code&gt;layout&lt;/code&gt; 选择列表字段和行为。普通目录的成员来自实际文章和本目录 &lt;code&gt;_map.toml&lt;/code&gt; 的引用。选择页的选项由对应布局提供。自定义字段放在 &lt;code&gt;params&lt;/code&gt;，继承默认值放在 &lt;code&gt;cascade.params&lt;/code&gt;。&lt;/p&gt;&#10;&lt;h2 id="在哪里改列表"&gt;在哪里改列表&lt;/h2&gt;&#10;&lt;p&gt;在栏目的 &lt;code&gt;_index.&amp;lt;lang&amp;gt;.md&lt;/code&gt; 中选择 &lt;code&gt;layout&lt;/code&gt;。以下路径使用 Banyan 参考站的命名；站点可以自行命名栏目。&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;用途&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;layout&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;收录范围&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;普通栏目&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;page-collection-directory&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;直属子栏目、文章和引用&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;名称列表&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;page-collection-directory-name-only&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;同上，只显示名称&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;产品列表&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;page-collection-products&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;直属子项和引用，显示产品字段&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;文章汇总&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;page-collection-directory-all&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;params.aggregate&lt;/code&gt; 指定栏目及下级文章和引用&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;产品汇总&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;page-collection-products-all&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;同上，显示产品字段&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;例如，在 &lt;code&gt;content/products/examples/_index.zh.md&lt;/code&gt; 中选择产品列表：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;layout&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;page-collection-products&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;列表仍包含原有子项，产品布局显示名称、更新时间、价格，默认按更新时间倒序；没有 &lt;code&gt;params.offer&lt;/code&gt; 的文章显示价格 &lt;code&gt;—&lt;/code&gt;。&lt;code&gt;page-collection-directory-all&lt;/code&gt; 显示名称、更新时间和大小，且需指定 &lt;code&gt;params.aggregate&lt;/code&gt;；&lt;code&gt;page-collection-directory&lt;/code&gt; 显示名称、更新时间、数量／大小；&lt;code&gt;page-collection-directory-name-only&lt;/code&gt; 只显示带图标的名称。布局可沿内容祖先的 &lt;code&gt;cascade&lt;/code&gt; 继承。普通文章使用 &lt;code&gt;page-article-rss&lt;/code&gt; 或 &lt;code&gt;page-article-norss&lt;/code&gt;，不会因栏目布局变成列表。&lt;/p&gt;&#10;&lt;p&gt;新增普通列表目录时使用 &lt;code&gt;_index.&amp;lt;lang&amp;gt;.md&lt;/code&gt;，声明 &lt;code&gt;layout: page-collection-directory&lt;/code&gt; 和需要的 &lt;code&gt;params.slots: [breadcrumb]&lt;/code&gt;；位于已有目录下时可继承布局和区域声明。正文只写介绍，列表显示在介绍之前。单篇文章使用 &lt;code&gt;name/index.&amp;lt;lang&amp;gt;.md&lt;/code&gt; 叶子包。&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;params.aggregate&lt;/code&gt; 只用于名称以 &lt;code&gt;-all&lt;/code&gt; 结尾的汇总布局，指向一个普通 section 根。普通目录页无需写 &lt;code&gt;aggregate&lt;/code&gt;。所有页面直接在站点根 &lt;code&gt;content/&lt;/code&gt; 维护；各语言维护各自的页面字段。&lt;/p&gt;&#10;&lt;h2 id="普通栏目图片墙"&gt;普通栏目图片墙&lt;/h2&gt;&#10;&lt;p&gt;普通栏目的 &lt;code&gt;_index*.md&lt;/code&gt; 使用 &lt;code&gt;page-collection-wall&lt;/code&gt;，显示直属子栏目、文章及引用。目录在前，文章在后；文章按发布日期倒序。它与下方汇总图片墙共用 &lt;code&gt;params.wall&lt;/code&gt; 配置。&lt;/p&gt;</description></item><item><title>外观 · 页面区域与导航</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/layout-slots/</link><pubDate>Fri, 06 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/layout-slots/</guid><description>&lt;h2 id="第一列入口"&gt;第一列入口&lt;/h2&gt;&#10;&lt;p&gt;根导航列显示当前语言的首页和已发布的直属页面。新增入口时，在 &lt;code&gt;content/&lt;/code&gt; 下创建根栏目或独立页面，并设置名称、顺序和图标：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;title&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;关于&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;weight&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="m"&gt;90&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;params&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;icon&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;{&lt;span class="nt"&gt;text&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;©&amp;#34;&lt;/span&gt;}&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;入口名称优先使用 &lt;code&gt;linkTitle&lt;/code&gt;，未设置时使用 &lt;code&gt;title&lt;/code&gt;；顺序使用入口自身的 &lt;code&gt;weight&lt;/code&gt;，不要向全部文章继承这个值。图标配置见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/collection-lists/#%e6%80%8e%e6%a0%b7%e5%a3%b0%e6%98%8e%e6%9d%a1%e7%9b%ae%e5%9b%be%e6%a0%87"&gt;列表与产品声明&lt;/a&gt;。&lt;/p&gt;&#10;&lt;p&gt;内部页面可用 &lt;code&gt;build.list: never&lt;/code&gt; 隐藏入口。删除根页面也会移除对应入口。首页在 &lt;code&gt;content/_index*.md&lt;/code&gt; 中配置；&lt;code&gt;params.show_navigation&lt;/code&gt; 控制首页是否显示根导航列。&lt;/p&gt;&#10;&lt;p&gt;从引用栏目进入文章时，导航显示该次来源；直接打开文章时，显示文章默认归属。正文仍使用同一发布网址，见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/directories/"&gt;目录与引用&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="站点说明页与外部链接"&gt;站点说明页与外部链接&lt;/h2&gt;&#10;&lt;p&gt;关于、GitHub 等说明页使用 &lt;code&gt;page-article-norss&lt;/code&gt;，避免进入文章 RSS。参考文件在 &lt;code&gt;content/about/&lt;/code&gt; 和 &lt;code&gt;content/github/&lt;/code&gt;；修改各语言正文和链接即可。&lt;/p&gt;&#10;&lt;p&gt;外部目标放在说明页正文中。需要在新标签打开时使用短代码：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;{{&amp;lt; new-tab href=&amp;#34;https://example.com/&amp;#34; &amp;gt;}}访问网站{{&amp;lt; /new-tab &amp;gt;}}&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;正文内的小图标可用 &lt;code&gt;asset&lt;/code&gt; 短代码，并设置 &lt;code&gt;class=&amp;quot;md-inline-image&amp;quot;&lt;/code&gt;。例如，页面包中有 &lt;code&gt;badge.webp&lt;/code&gt; 时：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;{{&amp;lt; asset src=&amp;#34;badge.webp&amp;#34; alt=&amp;#34;图标说明&amp;#34; class=&amp;#34;md-inline-image&amp;#34; width=&amp;#34;16&amp;#34; height=&amp;#34;16&amp;#34; &amp;gt;}}&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;RSS 说明页与订阅开关见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/discovery/#rss-%e8%ae%a2%e9%98%85"&gt;RSS 订阅&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="支持的-slots"&gt;支持的 slots&lt;/h2&gt;&#10;&lt;p&gt;页面的 &lt;code&gt;params.slots&lt;/code&gt; 选择需要的区域。省略名称会关闭对应区域，&lt;code&gt;[]&lt;/code&gt; 关闭全部可选区域。根导航列和正文不由此项控制。&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;名称&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;开启的内容&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;breadcrumb&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;面包屑列和面包屑结构化数据（BreadcrumbList）&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;meta&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;文章元信息、章节目录和文章结构化数据（BlogPosting）&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;省略 &lt;code&gt;meta&lt;/code&gt; 会同时关闭这三部分。页内“目录与信息”按钮只展开或收起辅助内容，不改变结构化数据输出。&lt;/p&gt;</description></item><item><title>外观 · 应用名称与图标</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/web-app/</link><pubDate>Fri, 06 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/web-app/</guid><description>&lt;p&gt;Manifest 是浏览器读取的应用清单，用于安装后的应用名称、启动地址和图标。它与 SW 缓存分别配置；关闭 SW 时仍需保留应用清单和图标文件。&lt;/p&gt;&#10;&lt;h2 id="站点图标"&gt;站点图标&lt;/h2&gt;&#10;&lt;p&gt;在 &lt;code&gt;assets/site/&lt;/code&gt; 中替换下列文件，保留原文件名：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;源文件&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;用途&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;favicon.ico&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;固定地址的浏览器图标&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;favicon.link.svg&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;页面优先使用的 SVG 图标&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;favicon.link.ico&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;没有上述 SVG 时使用的 ICO 图标&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;icon-180.png&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;180 × 180 的 Apple touch 图标&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;icon-192.png&lt;/code&gt;、&lt;code&gt;icon-256.png&lt;/code&gt;、&lt;code&gt;icon-512.png&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;对应尺寸的安装图标&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;参考站使用 SVG 页面图标，并提供表中的浏览器图标和安装图标。替换其中实际使用的文件，再检查浅色、深色和浏览器标签上的显示。SVG 可使用原有尺寸或只声明 &lt;code&gt;viewBox&lt;/code&gt;。&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;favicon.link.svg&lt;/code&gt; 与 &lt;code&gt;favicon.link.ico&lt;/code&gt; 同时存在时使用 SVG；如果想改用 ICO，需要移除对应 SVG。&lt;code&gt;favicon.ico&lt;/code&gt; 单独发布，不能只替换它就认为页面标签图标也已改变。&lt;/p&gt;&#10;&lt;p&gt;安装图标与文章分享图分别设置，分享图见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/discovery/#%e5%88%86%e4%ba%ab%e5%9b%be%e7%89%87"&gt;站点发现&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="manifest"&gt;Manifest&lt;/h2&gt;&#10;&lt;p&gt;打开 &lt;code&gt;assets/site/manifest.webmanifest.tmpl&lt;/code&gt;，修改已有值：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;内容&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;修改位置&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;应用名称&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;默认语言首页的 &lt;code&gt;title&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;启动网址&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;模板中的 &lt;code&gt;start_url&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;应用范围&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;模板中的 &lt;code&gt;scope&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;应用标识&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;模板中的 &lt;code&gt;id&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;启动背景和主题颜色&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;模板中的 &lt;code&gt;background_color&lt;/code&gt;、&lt;code&gt;theme_color&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;参考模板自动根据 &lt;code&gt;baseURL&lt;/code&gt; 设置应用标识、启动网址和范围，部署在子目录时无需另改这三项。需要自定义启动页或范围时，再修改对应模板值。&lt;/p&gt;</description></item><item><title>运行 · 安全策略与 CSP</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/security-csp/</link><pubDate>Fri, 06 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/security-csp/</guid><description>&lt;h2 id="生成与配置"&gt;生成与配置&lt;/h2&gt;&#10;&lt;p&gt;Banyan 为已启用的平台生成 CSP 响应头，并为外链脚本提供完整性信息。站点根 &lt;code&gt;hugo.toml&lt;/code&gt; 须保留：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-toml" data-lang="toml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;minify&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;disableJS&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;此设置防止 HTML 压缩再次改写脚本，使 CSP 哈希失效。&lt;/p&gt;&#10;&lt;p&gt;其他缓存、安全和权限头在 &lt;code&gt;assets/site/delivery.toml&lt;/code&gt; 中维护。修改源配置后重新构建，不直接编辑生成的 &lt;code&gt;_headers&lt;/code&gt; 或 &lt;code&gt;edgeone.json&lt;/code&gt;。平台开关和路由见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/delivery/"&gt;交付与缓存&lt;/a&gt;。&lt;/p&gt;&#10;&lt;p&gt;参考配置的 Permissions-Policy 关闭主题不需要的高权限能力。HSTS 使用 &lt;code&gt;max-age=300&lt;/code&gt;，不包含 &lt;code&gt;includeSubDomains&lt;/code&gt; 或 &lt;code&gt;preload&lt;/code&gt;；是否扩大范围由站点决定。&lt;/p&gt;&#10;&lt;h2 id="自定义脚本"&gt;自定义脚本&lt;/h2&gt;&#10;&lt;p&gt;自定义模板中的裸内联 JS 不会自动获得 CSP 授权，优先使用外链脚本。新增第三方脚本或改变资源来源后，检查实际页面和部署响应头。&lt;/p&gt;&#10;&lt;p&gt;主题的内联脚本与原生预取规则由构建统一生成哈希，无需添加 &lt;code&gt;unsafe-inline&lt;/code&gt;。预取配置见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/prefetch-stacks/"&gt;预取配置&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="验证"&gt;验证&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;swban check/delivery &amp;lt;build&amp;gt; #检查交付配置与指纹发布路径&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;swban check/csp &amp;lt;build&amp;gt; #检查哈希、integrity 和响应头&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;swban check/browser/csp &amp;lt;build&amp;gt; --page &amp;lt;path&amp;gt; #检查浏览器实际 CSP 违规&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;swban check/http/security &amp;lt;url&amp;gt; #检查已部署的响应头&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;本地检查不能代替部署后检查。尤其在 EdgeOne 上，应检查真实 HTTP 响应中的重叠规则结果。检查范围和准备步骤见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/browser-regression/"&gt;浏览器检查&lt;/a&gt;及 Skill 的&lt;a href="https://github.com/SwawHQ/banyan/blob/main/.agents/skills/swaw-banyan/references/delivery.md"&gt;交付检查&lt;/a&gt;。&lt;/p&gt;</description></item><item><title>运行 · 交付与缓存</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/delivery/</link><pubDate>Fri, 06 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/delivery/</guid><description>&lt;h2 id="配置来源"&gt;配置来源&lt;/h2&gt;&#10;&lt;p&gt;站点根 &lt;code&gt;assets/site/delivery.toml&lt;/code&gt; 是站点交付配置的唯一来源，须保留完整文件。&#10;新站点从 Banyan 根参考站点取得该文件；已有站点按参考文件补齐配置，&#10;保留自己的 SW、路由和平台值。Module 和传统主题目录不提供默认配置，&#10;&lt;code&gt;routes&lt;/code&gt; 按声明顺序使用，&#10;&lt;code&gt;routes = []&lt;/code&gt; 表示不声明缓存路由。运行时配置应用到所有语言。&lt;/p&gt;&#10;&lt;h2 id="部署平台"&gt;部署平台&lt;/h2&gt;&#10;&lt;p&gt;初次发布按&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/deploying/"&gt;首次部署&lt;/a&gt;设置平台、构建并上传。本页只说明交付配置的含义。&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;platform.cloudflare.pages.enabled&lt;/code&gt; 控制 Cloudflare Pages 输出；&lt;code&gt;platform.edgeone.makers.enabled&lt;/code&gt; 控制 EdgeOne Makers 输出。启用后分别生成 &lt;code&gt;_headers&lt;/code&gt; 或 &lt;code&gt;edgeone.json&lt;/code&gt;，有重定向规则时还会生成对应配置。&lt;/p&gt;&#10;&lt;p&gt;构建命令、输出目录和工具版本在平台设置；Banyan 生成的 EdgeOne 配置只包含响应头和重定向。两种部署方式的准备步骤见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/deploying/"&gt;首次部署&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="路由和-http-响应头"&gt;路由和 HTTP 响应头&lt;/h2&gt;&#10;&lt;p&gt;通用规则在前，例外在后。以下只展示路由格式；修改已有的对应路由，不要用示例替换整个文件。保留本站需要的安全头和其他路由：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-toml" data-lang="toml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[[&lt;/span&gt;&lt;span class="nx"&gt;routes&lt;/span&gt;&lt;span class="p"&gt;]]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;path&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;/*&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;http&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;Cache-Control&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;public, max-age=900, must-revalidate&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;sw&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;bucket&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;versioned&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[[&lt;/span&gt;&lt;span class="nx"&gt;routes&lt;/span&gt;&lt;span class="p"&gt;]]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;path&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;/js/*&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;http&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;Cache-Control&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;public, max-age=31536000, immutable&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;http&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;cloudflare&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;pages&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;unset&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;Cache-Control&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;sw&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;bucket&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;fingerprinted&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[[&lt;/span&gt;&lt;span class="nx"&gt;routes&lt;/span&gt;&lt;span class="p"&gt;]]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;path&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;/sw.js&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;sw&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;bucket&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;off&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;path&lt;/code&gt; 可为精确路径，或在任意位置包含一个 &lt;code&gt;*&lt;/code&gt;，例如 &lt;code&gt;/*.xml&lt;/code&gt;。&#10;通配符可匹配空字符串，也可跨越 &lt;code&gt;/&lt;/code&gt;。&#10;SW 匹配区分大小写的 URL pathname，保留百分号编码，不含查询参数和片段；&#10;非 ASCII 路径使用编码形式。&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;http.headers&lt;/code&gt; 应用于两个平台。同一路由的&#10;&lt;code&gt;http.cloudflare.pages.headers&lt;/code&gt; 和 &lt;code&gt;http.edgeone.makers.headers&lt;/code&gt; 覆盖通用值。&#10;Cloudflare 的 &lt;code&gt;unset&lt;/code&gt; 在设置当前值前移除此前匹配的响应头。&#10;HTTP 路由保留声明顺序，由各平台按自己的规则处理。&#10;CSP 根据实际内联脚本生成，详见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/security-csp/"&gt;安全策略与 CSP&lt;/a&gt;。&lt;/p&gt;</description></item><item><title>运行 · 预取配置</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/prefetch-stacks/</link><pubDate>Fri, 06 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/prefetch-stacks/</guid><description>&lt;p&gt;预取设置由站点完整的 &lt;code&gt;assets/site/delivery.toml&lt;/code&gt; 提供，应用到所有语言。&#10;首次部署可以保持关闭。需要启用时，在已有 &lt;code&gt;[prefetch]&lt;/code&gt; 表中把 &lt;code&gt;enabled&lt;/code&gt; 改为 &lt;code&gt;true&lt;/code&gt;，再按下方说明调整规则；不要追加重复的表。&#10;Module 不提供默认配置；未单独配置的图标和范围按本站表中的规则取值。预取按条目主图标名称和列范围匹配。&lt;/p&gt;&#10;&lt;h2 id="图标与列范围"&gt;图标与列范围&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;folder&lt;/code&gt; 表示集合入口策略，&lt;code&gt;file&lt;/code&gt; 表示内容页面策略。&#10;这些名称是预取提示；更换条目图标也会改变策略。&#10;只匹配条目的主 SVG 图标，正文装饰图标不参与图标分类。&#10;未配置图标、文字、图片和其他页面链接使用 &lt;code&gt;default&lt;/code&gt;。&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;范围&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;含义&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;root&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;根导航，第 0 列&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;tail&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;最后的条目列；集合页为主集合列表，文章页为最右面包屑列表&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;&amp;quot;root+N&amp;quot;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;从根导航向右 N 个条目列&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;&amp;quot;tail-N&amp;quot;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;从尾列向左 N 个条目列&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;all&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;此图标未被其他范围覆盖的条目链接&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;只计算导航和集合条目列。文章正文、章节和元信息不参与编号。&#10;横向滚动不改变编号。没有面包屑列的文章页，根导航同时是尾列。&#10;偏移到根导航时可匹配它，超出实际列数时不匹配。&#10;偏移键统一加引号；&lt;code&gt;+&lt;/code&gt; 不能用于 TOML 裸键。&lt;/p&gt;&#10;&lt;p&gt;重叠优先级固定为：&lt;code&gt;root &amp;gt; tail &amp;gt; tail-N &amp;gt; root+N &amp;gt; all &amp;gt; default&lt;/code&gt;。&#10;例如三列页面的 &lt;code&gt;root+1&lt;/code&gt; 和 &lt;code&gt;tail-1&lt;/code&gt; 指向同一列，使用 &lt;code&gt;tail-1&lt;/code&gt;。&#10;两端的明确配置优先；显式 &lt;code&gt;off&lt;/code&gt; 阻止回落，配置声明顺序不影响结果。&#10;基础预取为 &lt;code&gt;off&lt;/code&gt; 的链接不参与预渲染。&lt;/p&gt;&#10;&lt;h2 id="配置"&gt;配置&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-toml" data-lang="toml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;prefetch&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;enabled&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;default&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;conservative&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;prefetch&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;icons&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;folder&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;all&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;conservative&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;root&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;moderate&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;tail&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;eager&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s2"&gt;&amp;#34;tail-1&amp;#34;&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;moderate&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c"&gt;# 需要按左侧深度配置时，可追加：&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c"&gt;# &amp;#34;root+1&amp;#34; = &amp;#34;moderate&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c"&gt;# 原生增强；Banyan 根参考配置对尾列文件夹使用 moderate，可改为 off。&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;prefetch&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;prerender&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;default&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;off&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;prefetch&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;prerender&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;icons&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;folder&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;tail&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;moderate&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Banyan 根参考配置关闭预取。开启后，前端自动选择一个机制：&#10;原生 Speculation Rules → 已活动且匹配本站脚本和范围的 Banyan SW → link prefetch。&#10;没有可用机制时停止。浏览器支持原生规则但因设置或资源限制拒绝预取时，&#10;不额外用另一套机制强制请求。&lt;/p&gt;</description></item></channel></rss>