用途:用于构建以文件系统目录结构作为导航图的静态 HTML 展示站,适合记录结构性成果,如审计报告、提交记录、指标、承包商展示、遥测视图、周报。不适用于博客、营销落地页或交互式 Web 应用。
主要能力:目录即站点地图;运行 scripts/build-nav.py --root <site-root> 自动发现目录、生成 site-map.html,并将统一导航栏注入每个页面的 <!-- AUTO-NAV-START --> 与 <!-- AUTO-NAV-END --> 标记之间,重复执行幂等。导航栏主题固定为深色(slate-950 背景、slate-300 文字、indigo-400 强调色)。每页链接共享 CSS 内核(经 jsDelivr 提供),三层结构为内核、页面组合、可选的 overrides.css。该导航栏支持拖动调整宽度、双击重置、分区内上一页/下一页按钮与 [ / ] 快捷键。默认启用 Pagefind 静态搜索,索引位于 <site-root>/pagefind/,通过 scripts/site.sh nav 重建。
使用方式:可用安装脚本 scripts/install.sh 引导脚本与起始站点,例如 bash "$ROOT/skills/page-template/scripts/install.sh" --site contractor-site;随后填充 HTML 中的占位符,运行 scripts/site.sh nav contractor-site 构建导航,scripts/site.sh check contractor-site 校验,再打开页面。也可手工复制 templates/index.html 等模板后运行 python3 scripts/build-nav.py --root "$DEST"。install.sh --hook 可安装 pre-push 钩子自动重建并同步,支持 NO_HTMLSHOWCASE_HOOK、NO_HTMLSHOWCASE_SYNC、NO_HTMLSHOWCASE_SEARCH 等环境变量。
适用场景:内部受众站点(审计报告、承包商展示、遥测视图、周报)默认推送到 tailnet 上的 myhost;仅当外部读者确需访问时再用 jsDelivr/Pages/Workers。
限制:具体收费、价格、平台与效果资料暂未提供;CDN 内核版本锁定与发布流程细节需参阅参考资料。