https://cdocs.cnkrru.top 一个用 C++ 编写、复用成熟组件（md4c + nlohmann/json + FlexSearch）的极简静态文档站点生成器。 zh-CN Sun, 02 Aug 2026 18:29:39 GMT https://cdocs.cnkrru.top/zh-CN/intro.html https://cdocs.cnkrru.top/zh-CN/intro.html 介绍 欢迎使用 Cdocs —— 一个用 C++ 编写、数据驱动的极简静态文档站点生成器（SSG）。 它把 docs/ 下的 Markdown 源文，连同 .Cdocs/ 里的配置、导航、多语言文案与前端资源，编译成一个纯静态、可离线、零运行… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/guide.html https://cdocs.cnkrru.top/zh-CN/guide.html 使用指南 作为命令行工具使用 Cdocs 是一个用 C++ 编写的单文件命令行工具，编译后即为 Cdocs.exe（Windows）/ Cdocs（Linux·macOS）。 它读取 .Cdocs/ 下的配置与前端资源，把 docs/ 下的 Markdown 渲染成静态站点 dist/。 一… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/commands.html https://cdocs.cnkrru.top/zh-CN/commands.html 命令行参考 Cdocs 采用 纯子命令 CLI（对标 Hugo / MkDocs），语法： Cdocs [全局旗标] <子命令> [参数] 全局旗标（放在子命令之前） 旗标 说明 -c, --config <目录> 引擎目录（默认 .Cdocs） -s, --source <目录> 内… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/architecture.html https://cdocs.cnkrru.top/zh-CN/architecture.html 架构一览 Cdocs 的核心设计是数据驱动 + 引擎收口：所有"引擎"相关文件统一收口在隐藏目录 .Cdocs/ 内，用户侧只维护 docs/（内容）与 dist/（产物）。 整体数据流 flowchart LR C["config.json"] --> G["… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/features.html https://cdocs.cnkrru.top/zh-CN/features.html 功能特性 Cdocs 的功能分两类：构建期内建（生成器 C++ 直接产出）与客户端增强（浏览器里懒加载 JS 升级）。 构建期内建 功能 产物 说明 HTML 渲染 各页 .html Markdown → HTML（md4c），TOC / 面包屑 / 上下篇 全文搜… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/versioning.html https://cdocs.cnkrru.top/zh-CN/versioning.html 版本化 Cdocs 支持多版本文档站：把当前 docs/ 复制一份快照为 docs-v1/、docs-v2/，构建时自动识别为历史版本，生成 current（最新）与各历史版本，页眉出现版本下拉一键切换。该功能默认启用、约定优于配置——… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/api.html https://cdocs.cnkrru.top/zh-CN/api.html API 参考 Cdocs 是一个命令行驱动的静态文档站生成器，不对外暴露 C++ 库接口；所有扩展能力通过三个层面暴露： 层面 位置 说明 配置 .Cdocs/config/config.json + route.json 站点元数据、功能开关、导航 主题 .Cdocs/theme/ … Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/themes.html https://cdocs.cnkrru.top/zh-CN/themes.html 主题开发 Cdocs 的主题 = 一个文件夹。引擎只负责生成数据（导航树、目录、正文、分页…），页面骨架与全部前端资源都由主题提供。复制一个主题文件夹、改几行配置，即可整体换肤——这就是 Cdocs 的主题… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/plugins.html https://cdocs.cnkrru.top/zh-CN/plugins.html 插件开发 插件让 Cdocs 在不修改引擎的前提下扩展构建流程。协议采用外部进程 + JSON 文件交换：构建器在关键节点广播钩子，调用你的脚本（任意语言），脚本读写 JSON 即可参与构建。零 DLL、零依赖、失败自… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/pipeline.html https://cdocs.cnkrru.top/zh-CN/pipeline.html 渲染管线 这里的「渲染管线」指 Cdocs 把 docs/ 源文变成可部署静态站点的构建链路。它由「生成器编译 + 三步后处理」组成，全部由 build.cmd / build.sh 一键串联。 总览 flowchart LR SRC["docs/*.md + .Cdocs/{config,route,i1… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/render.html https://cdocs.cnkrru.top/zh-CN/render.html 渲染循环 渲染循环（render loop）是 UI 库持续把 Canvas 缓冲搬到屏幕表面的过程。 两个阶段 逻辑更新：处理输入、推进状态。 绘制：调用 canvas_set_pixel 等图元刷新缓冲，再 blit 到窗口。 真实 App 的窗口由操作系… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/test-markdown.html https://cdocs.cnkrru.top/zh-CN/test-markdown.html Markdown 渲染测试 本页覆盖常用 Markdown 语法，验证生成器的渲染正确性。看到的效果即最终产物效果。 标题层级 H1 H2 H3 H4 H5 文本样式 粗体、斜体、粗斜体、删除线、行内代码、Ctrl+K。 引用 单层引用。 嵌套引… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/test-mermaid.html https://cdocs.cnkrru.top/zh-CN/test-mermaid.html Mermaid 图表测试 本页验证 Mermaid 图表渲染（客户端懒加载 mermaid.min.js）。图表写在与代码块相同的围栏里，语言标记为 mermaid。 流程图（flowchart） flowchart TD A[开始] --> B{有 .md 吗?} B -- 是 --> C[解析 front matter]… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/test-katex.html https://cdocs.cnkrru.top/zh-CN/test-katex.html KaTeX 公式测试 本页验证数学公式渲染（客户端懒加载 KaTeX + auto-render）。行内公式用 $...$，块级公式用 $$...$$。 行内公式 质能方程：$E = mc^2$ 欧拉恒等式：$e^{i\pi} + 1 = 0$ 黄金比例：$\varphi = \frac{1 + \sqrt{5}}{2}$ 组… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/test-lightbox.html https://cdocs.cnkrru.top/zh-CN/test-lightbox.html 图片灯箱测试 本页验证 PhotoSwipe 5 灯箱（lightbox）功能：点击正文图片可全屏查看，支持图集导航、捏合/双击缩放、键盘 ←/→ 切换、Esc 关闭。 单张图片（点击查看大图） 点击下方图片 → 全屏放大；再点击… Sun, 02 Aug 2026 18:29:37 GMT https://cdocs.cnkrru.top/zh-CN/blog/hello-cdocs.html https://cdocs.cnkrru.top/zh-CN/blog/hello-cdocs.html 单文件 exe、零运行时依赖、开箱即用的中英双语文档站——这是 Cdocs 的第一个版本。 这是一篇用于验证 Cdocs 博客流功能的示例文章。正文支持完整的 Markdown 语法： 小节示例 列表项一 列表项二 引用块：Cdocs … Sat, 01 Aug 2026 00:00:00 GMT