小编SKV*_*SKV的帖子

使用Sphinx for Python项目文档的正确工作流程是什么?

我想使用Sphinx来记录一个目前没有详细记录的大型项目.特别是我想用它sphinx-apidoc来记录代码中的文档.

但是我也希望有一些关于如何使用项目等的教程页面,但是当我调用sphinx-apidoc它时,它会立即生成整个文档.

所以我的问题是:这里的工作流程是什么,所以我可以编写手动编写的教程页面,同时更新代码中的文档?请注意,如果我更新手动编写的教程页面(例如包含在内index.txt)并运行,sphinx-apidoc我会丢失它们,因为整个文档会立即生成.

一般来说,有关如何继续构建文档的指导原则吗?

注意:不便之处在于基本过程假定您已经拥有所有代码文档,并且在您继续生成文档时不会进行任何更新.至少这是我需要解决的问题.

python documentation documentation-generation python-sphinx

6
推荐指数
1
解决办法
1531
查看次数

scipy稀疏矩阵和cython

我需要在Cython方法中的scipy稀疏矩阵上执行一组操作.

为了有效地应用这些,我需要访问lil_matrix表示.python中的lil(链表稀疏矩阵)数据表示使用list of lists不同的长度.

如何有效地将不同长度的列表列表传递给cython(不复制)?有没有其他方法可以访问cython中的lil-matrices?

python numpy cython scipy sparse-matrix

5
推荐指数
1
解决办法
3301
查看次数