随心写写

浏览 v2ex 网站时，某两天看到好几个“发现”这类帖子，很实用。

在使用 Sphinx 生成技术文档时，我们经常需要在文档中嵌入截图和示意图。然而，Sphinx 默认的图片显示方式有一个明显的缺点：图片无法点击放大。这意味着当图片中包含重要的细节信息时，用户无法清晰地查看。

搭建个人博客 | Hexo 框架 | 部署到Github Pages | 踩坑修复bug

方式生成的 .rst 文件后，打开 html，没有展示出各个模块，需要手动去修改 index.rst 文件，很复杂。而是手动配置 .rst 文件， 不断调试，让页面展示成我想要的样子，接着用 python 脚本处理，自动化构造 .rst 文件。现在自动化框架暂无清晰的API文档，给今后的代码编写、查阅及维护造成一定的困扰，为了实现将所有测试用例脚本中的注释导出、查阅，查阅网上多数人使用的工具，决定采用sphinx实现自动产生参考文档、索引等。，在生成 .rst 文件后进行编译，生成实时 HTML 文档。