静态资源与文档中心

静态资源（static/）

• 在模板目录下创建 static/ 目录，其内可放 CSS、JS、图片等。
• 访问路径统一为 /home/static/...，例如：
  • 文件：my-theme/static/css/style.css
  • 引用：<link rel="stylesheet" href="/home/static/css/style.css">

在 布局与页面模板 中可通过 extra_css 块引入页面专属样式。

文档中心（docs/，可选）

• 在模板目录下创建 docs/ 目录，其下一级子目录为「分类」，子目录内的 .md 文件为该分类下的文档。
• 需同时提供 docs_list.html（文档列表页）与 docs_detail.html（文档详情页）模板，用于渲染 /docs 与 /docs/分类/文档名。
• 每个分类目录下可放 _meta.yaml，指定分类显示名、排序及文档顺序。示例：

name: "快速开始"
order: 1
docs: [install, faq]

• 文档内容使用标准 Markdown，由系统渲染为 HTML；详情页中正文通过模板中提供的文档内容字段输出（通常需使用安全 HTML 输出）。