https://cdocs.cnkrru.top A minimal static documentation site generator written in C++, reusing mature components (md4c + nlohmann/json + FlexSearch). en Sun, 02 Aug 2026 20:10:10 GMT https://cdocs.cnkrru.top/en/getting-started/intro.html https://cdocs.cnkrru.top/en/getting-started/intro.html Introduction Welcome to Cdocs — a minimal, data-driven static documentation site generator (SSG) written in C++. It compiles the Markdown sources in docs/ together with the config, navigation, i18n strings and front-end assets in .Cdocs/ into a purely static, offline-capable… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/getting-started/guide.html https://cdocs.cnkrru.top/en/getting-started/guide.html Guide Use as a command-line tool Cdocs is a single-file command-line tool written in C++. Once compiled it is Cdocs.exe (Windows) / Cdocs (Linux·macOS). It reads the config and front-end assets under .Cdocs/ and renders the Markdown under docs/ into a static site in dist/. On… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/generator/commands.html https://cdocs.cnkrru.top/en/generator/commands.html 命令行参考 Cdocs 采用 纯子命令 CLI（对标 Hugo / MkDocs），语法： Cdocs [全局旗标] <子命令> [参数] 全局旗标（放在子命令之前） 旗标 说明 -c, --config <目录> 引擎目录（默认 .Cdocs） -s, --source <目录> 内… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/generator/architecture.html https://cdocs.cnkrru.top/en/generator/architecture.html 架构一览 Cdocs 的核心设计是数据驱动 + 引擎收口：所有"引擎"相关文件统一收口在隐藏目录 .Cdocs/ 内，用户侧只维护 docs/（内容）与 dist/（产物）。 整体数据流 flowchart LR C["config.json"] --> G["… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/generator/features.html https://cdocs.cnkrru.top/en/generator/features.html 功能特性 Cdocs 的功能分两类：构建期内建（生成器 C++ 直接产出）与客户端增强（浏览器里懒加载 JS 升级）。 构建期内建 功能 产物 说明 HTML 渲染 各页 .html Markdown → HTML（md4c），TOC / 面包屑 / 上下篇 全文搜… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/generator/versioning.html https://cdocs.cnkrru.top/en/generator/versioning.html Versioning Cdocs supports multi-version documentation sites: copy your current docs/ into a snapshot like docs-v1/ or docs-v2/, and the build automatically detects it as a historical version, producing current (latest) plus each historical version with a version switcher in th… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/reference/api.html https://cdocs.cnkrru.top/en/reference/api.html API Reference Cdocs is a CLI-driven static documentation site generator with no public C++ library API. All extensibility is exposed through three layers: Layer Location Purpose Config .Cdocs/config/config.json + route.json Site metadata, feature toggles, navigation Theme .Cdo… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/reference/themes.html https://cdocs.cnkrru.top/en/reference/themes.html Theme Development A Cdocs theme is a folder. The engine only generates data (nav tree, TOC, body, pager…); the page skeleton and all front-end assets come from the theme. Copy a theme folder, tweak a few lines, and the whole look changes — this is Cdocs' theme contrac… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/reference/plugins.html https://cdocs.cnkrru.top/en/reference/plugins.html Plugin Development Plugins let Cdocs extend the build pipeline without touching the engine. The contract is external process + JSON file exchange: the builder fires hooks at key points, invokes your script (any language), and the script participates by reading/writing JSON. Ze… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/generator/pipeline.html https://cdocs.cnkrru.top/en/generator/pipeline.html Render Pipeline Here, "render pipeline" means the build pipeline that turns the docs/ sources into a deployable static site. It is "generator compile + three post-processing steps", all chained by build.cmd / build.sh. Overview flowchart LR SRC["docs/*… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/generator/render.html https://cdocs.cnkrru.top/en/generator/render.html Render Loop The render loop is the process by which a UI library continuously copies the Canvas buffer onto the screen surface. Two phases Logic update: process input, advance state. Draw: call primitives like canvas_set_pixel to refresh the buffer, then blit to the window. A … Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/tests/test-markdown.html https://cdocs.cnkrru.top/en/tests/test-markdown.html Markdown 渲染测试 本页覆盖常用 Markdown 语法，验证生成器的渲染正确性。看到的效果即最终产物效果。 标题层级 H1 H2 H3 H4 H5 文本样式 粗体、斜体、粗斜体、删除线、行内代码、Ctrl+K。 引用 单层引用。 嵌套引… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/tests/test-mermaid.html https://cdocs.cnkrru.top/en/tests/test-mermaid.html Mermaid 图表测试 本页验证 Mermaid 图表渲染（客户端懒加载 mermaid.min.js）。图表写在与代码块相同的围栏里，语言标记为 mermaid。 流程图（flowchart） flowchart TD A[开始] --> B{有 .md 吗?} B -- 是 --> C[解析 front matter]… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/tests/test-katex.html https://cdocs.cnkrru.top/en/tests/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 20:10:08 GMT https://cdocs.cnkrru.top/en/tests/test-lightbox.html https://cdocs.cnkrru.top/en/tests/test-lightbox.html Image Lightbox Test This page verifies the PhotoSwipe 5 lightbox feature: click any content image to view it fullscreen, with gallery navigation, pinch/double-click zoom, ←/→ keyboard switching, and Esc to close. Single Image (click to enlarge) Click the image below → fu… Sun, 02 Aug 2026 20:10:08 GMT https://cdocs.cnkrru.top/en/blog/hello-cdocs.html https://cdocs.cnkrru.top/en/blog/hello-cdocs.html This is the English version of the sample post "Cdocs 0.1 发布：一个 C++ 写的静态文档站生成器". It is used to verify the Cdocs blog stream feature with bilingual support. Sat, 01 Aug 2026 00:00:00 GMT