文档目录

目录结构

每个子站带一份完整资源,文件夹可以单独部署。

项目目录#

Web/
|-- index.html              主页 reversedeer.com
|-- about.html              关于页
|-- CNAME
|-- assets/                 主站资源
|-- scripts/                博客与文档构建脚本
|-- blog/                   blog.reversedeer.com
|   |-- index.html          博客列表(列表区域由脚本维护)
|   |-- posts/              Markdown 文章源文件
|   |-- post.html           由 Markdown 生成的文章页
|   |-- CNAME
|   `-- assets/             博客站独立资源
`-- docs/                   docs.reversedeer.com
    |-- index.html          由 Markdown 生成的文档首页
    |-- *.html              由 Markdown 生成的其他文档页
    |-- pages/              Markdown 文档源文件
    |-- CNAME
    `-- assets/             文档站独立资源

每个子站都有自己的 assets/css、assets/js、assets/fonts,复制粘贴即可单独部署,不依赖根目录。代价是共享文件有三份副本,改动要三处同步。

资源文件按用途拆分:顶栏改 header.css,页尾改 footer.css,配色和尺寸改 theme.css;主题切换在 theme.js,移动菜单在 navigation.js,本地链接在 local-links.js。博客列表使用 blog-list.css,文章正文使用 article.css;文档布局、目录和正文分别在 docs-layout.css、docs-navigation.css、docs-content.css。完整清单见仓库根目录 README.md。