Exhale(Doxygen+Breathe+Sphinx)为C++创建优雅文档

1. 首先要安装好Doxygen和Sphinx和exhale
   1. Brew install doxygen
   2. Pip install sphinx
   3. Pip install exhale (breathe会被默认安装）
2. 在项目文件下面建立doc文件夹
3. 配置Doxygen
   1. Doxygen -g Doxyfile 生成doxyfile配置文件
   2. 在其中添加一些自己想要的更改
4. 配置Sphinx
   1. Sphinx-quickstart 生成项目模版
   2. 按照https://exhale.readthedocs.io/en/latest/quickstart.html所述王模版中添加exhale和breathe插件
   3. 同上链接修改sphinx主题
5. 编译：make html即可产生网页文档

Sphinx拓展

1. Myst-parser 拓展
   1. 启动： Syntax Extensions
   2. 说明： Markdown-It-Py Plugin Extensions — mdit-py-plugins

Reference:

1. Quickstart Guide — Exhale: Automatic C++ Library API Generation
2. Quickstart Guide — Exhale: Automatic C++ Library API Generation