用途:为 bx-sites 站点选择、定制、覆盖、安装或编写主题。主题是原生 BoxLang .bxm 模板,无需独立模板引擎或构建步骤。
内置主题:bootstrap(默认,Bootstrap 5 内置)、material、tailwind、docsy、slate、docusaurus、justthedocs、vuepress、gitbook、notion。七个 material 派生主题复用 material 的 .bxm 模板,仅改 CSS 类前缀,功能集与离线能力一致。bootstrap/material/tailwind 共用 BoxLang 品牌配色,其余七个各有配色。
主要能力:所有主题提供页面内 TOC、面包屑、前后页链接、highlight.js 代码块与复制按钮、自托管字体、明暗切换、响应式头部与可折叠侧栏、/ 与 Cmd/Ctrl+K 搜索、下载 Markdown、版本切换、404 页面、自定义 logo/favicon、Google Analytics、社交分享卡、标签/图标/摘要、导航覆盖、额外 CSS/JS 注入、admonition、脚注、内容标签页、Mermaid、数学公式等。
安装与用法:theme: { name: material };bxSites install:theme --name=bx-sites-theme-blog1 [--version=1.0.0]。
离线:bootstrap/material/七个 gallery 主题默认零联网可用,默认本地搜索。tailwind 用 CDN JIT,非离线;Mermaid elk 布局、数学 KaTeX、Algolia、Google Analytics 需联网。真正隔离部署应选 bootstrap/material/gallery 主题、本地搜索,避免 elk 布局 Mermaid,关闭 math/Algolia/analytics。
ThemeProvider 契约:layout.bxm(必需)+ page.bxm(必需),可选 search.bxm 与 assets/。解析顺序:项目 theme/ 覆盖 → 已安装 themes/<name>/ → 内置同名主题。
定制与覆盖:可用 extraCss 改 CSS 变量(--bxsites-gradient-start 等);覆盖用 bxSites theme:new --theme=bootstrap,项目 theme/ 为全有或全无。从零编写可用最小 layout.bxm + page.bxm,contentHtml 已转换完毕。
导入:bxSites theme:import --source=mkdocs --path=/path/to/theme --name=my-imported-theme,支持 mkdocs、jekyll、hugo,尽力转换,非无损。
限制:具体收费、价格与平台细节暂未提供。