用途:为 bx-sites(ortus-boxlang/bx-sites)项目提供站点配置参考。项目根目录只放一个站点配置文件,支持 bxsites.yaml(默认首选)、bxsites.yml、bxsites.toml、bxsites.json,三者键名与默认值完全一致,仅语法不同。同时存在多个时优先级为 yaml、yml、toml、json。仅 name 必填,其余均有默认值;部分 theme 对象按一层深度合并。
主要能力:baseURL 控制内部链接与资源前缀,并作为 sitemap.xml、robots.txt、llms.txt 与 canonical 的规范地址;空或 "/" 为根相对链接且不生成 sitemap/canonical,裸路径为子路径,完整 URL 才生成 sitemap 与 canonical。source 指定内容目录,未设置时自动探测 docs/ 再 src/,都不存在则抛 BxSites.SourceNotConfigured。exclude 追加排除项,robots 控制 robots.txt 生成,theme 配置主题名、logo、favicon 及 colorMode、navCollapsible、tocPosition、accentColor 等选项。nav 为空时按目录结构推断,非空则完全替换推断。另有 search/searchProvider、redirects、markdown、repo、social、footer、lastUpdated、analytics、ogImage、extraCss/extraJs、assets、mermaid/math/openapi/imageGallery、pageActions、plugins、mcp、docbox/coldbox、cloud、versions、i18n、blog、variables 等键。
使用方式:在项目根目录创建任一受支持格式的配置文件并填写键值;TOML 用 [section]/[[section]] 表达嵌套与数组表。
限制:资料未提供安装命令、价格与平台信息;部分键的完整 schema 需参考对应技能文档。