mkdocs-ng v1.8.0 发布了,这是 fork 以来的第一个功能版本。内置主题不再复制多余的 highlight.js 资源,clean build 快约 14%,产物少约 440 个文件;搜索终于能搜到 while、if 这类编程关键词。1.9.0 将针对 mkdocs serve 做增量构建优化。
从接手 mkdocs-ng 维护以来发了四个版本,修了十几个 Bug,去掉了 mergedeep 依赖。接下来 v1.8.0 会是一个功能版本,计划去掉旧 Python 版本支持、移除内置主题的 CDN 依赖、提供稳定的 Python API。
MkDocs 快两年没更新了,Material for MkDocs 也进了维护模式。作为重度用户,我 fork 了这两个项目,发布了 mkdocs-ng 和 mkdocs-ng-material,更新一下包名就能继续用。
在企业中,Wiki 和 Confluence 等文档工具如果缺乏统一管理和审核机制,可能会导致信息混乱和知识沉淀失败。本文探讨了如何避免这种情况,并借鉴开源社区的成功经验。
在开源项目或团队协作中,Sphinx + ReadTheDocs 是一个易于维护、可自动部署的文档系统。本文记录了配置过程和注意事项。
Markdown 和 reStructuredText(RST)是两种常用的标记语言。本文对比了它们的优缺点,并分享了在不同场景下的使用建议。