我想使用Sphinx来记录一个目前没有详细记录的大型项目.特别是我想用它sphinx-apidoc来记录代码中的文档.
但是我也希望有一些关于如何使用项目等的教程页面,但是当我调用sphinx-apidoc它时,它会立即生成整个文档.
所以我的问题是:这里的工作流程是什么,所以我可以编写手动编写的教程页面,同时更新代码中的文档?请注意,如果我更新手动编写的教程页面(例如包含在内index.txt)并运行,sphinx-apidoc我会丢失它们,因为整个文档会立即生成.
一般来说,有关如何继续构建文档的指导原则吗?
注意:不便之处在于基本过程假定您已经拥有所有代码文档,并且在您继续生成文档时不会进行任何更新.至少这是我需要解决的问题.
我需要在Cython方法中的scipy稀疏矩阵上执行一组操作.
为了有效地应用这些,我需要访问lil_matrix表示.python中的lil(链表稀疏矩阵)数据表示使用list of lists不同的长度.
如何有效地将不同长度的列表列表传递给cython(不复制)?有没有其他方法可以访问cython中的lil-matrices?