从接手 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)是两种常用的标记语言。本文对比了它们的优缺点,并分享了在不同场景下的使用建议。