- c - 在位数组中找到第一个零
- linux - Unix 显示有关匹配两种模式之一的文件的信息
- 正则表达式替换多个文件
- linux - 隐藏来自 xtrace 的命令
所以我的 python 源文件在两个不同的目录中:-
例如
~/work/myproject
~/.virtualenvs/myproject
如何使用 sphinx-apidoc
递归地查看两个目录以生成我的 reST 文件?
显然,
sphinx-apidoc -o docs/source ~/work/myproject
工作得很好,但是当我尝试运行时
sphinx-apidoc -o docs/source ~/.virtualenvs/myproject
再次,sphinx 告诉我“docs/source/modules.rst 已经存在,正在跳过”这当然是真的,因为我已经运行了一次 sphinx-apidoc
来生成它。
那么如何执行一次并在两个目录中搜索?
最佳答案
根据Sphinx apidoc documentation ,命令行语法为:
sphinx-apidoc [options] -o <outputdir> <sourcedir> [pathnames ...]
更新:错误,请参阅下面@jgbarah 的评论。
这意味着如果您想在两个单独的目录中记录源代码,您可以同时传递两个目录/路径名,例如:
sphinx-apidoc -o docs/source ~/work/myproject ~/.virtualenvs/myproject
改进建议:
您可以在每个项目的文档中创建一个子目录。所以像这样:
sphinx-apidoc -o docs/source/app1 ~/work/myproject1
sphinx-apidoc -o docs/source/app2 ~/work/myproject2
然后使用目录树,您可以指向两个子目录:
.. toctree::
:maxdepth: 2
app1/index.rst
app2/index.rst
关于python - sphinx-apidoc 用法 - 多个源 python 目录,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/13116155/
我正在使用 docstrings 来记录 python 代码,并使用 sphinx-autodoc 来生成 apidoc HTML。我的包的结构如下:mainpackage.subpackage.mo
嘿,我正在尝试从我的 apiDoc 中删除/隐藏示例请求表单。我没有在我的 package.json 配置上使用 sampleUrl 标签,在 api_porject.json 上这个属性设置为 fa
我在尝试找出为 Django 项目实现自动文档生成的最佳方法时遇到了一些困难 我的项目结构类似于以下内容: myproj/ # project root |- docs/
我对 sphinx 还很陌生,我正在尝试将其用作我项目的 API 引用。也许在那之后也作为项目文档。 我使用这两个命令生成它 sphinx-apidoc -e -o doc/api tracer sp
我目前正在 L5.5 上工作,为了生成 api 文档我已经安装了 this包,现在我不需要那个包我决定卸载它但是在卸载时我得到了这个错误。 Generating optimized autoload
我使用 apiDoc 来记录 Java,并希望使用 @apiParam 来表明输入参数可以是不同类型。例如:类型可能是Map、Collection、Set、List等,我该怎么办? 最佳答案 尝试以下
使用sphinx-apidoc生成.rst文件时,输出结果不包含任何标签: dessn.examples package ====================== .. automodule::
我正在使用 yiisoft/yii2-apidoc (#0.2.4) 为在 yii2 中编写的项目构建文档。我已经构建了一个 shell 脚本来发布文档,当我只包含项目文件和我自己的 cms 代码库时
我最近尝试使用 sphinx-apidoc来自 Sphinx帮助从 Python 项目的 API 生成 Sphinx 特定的 reStructuredText。 但是,我得到的结果是: 有人知道我是否
我有一个 nodejs 项目,其中包含许多请求并由 apiDoc 详细记录,我想从中创建一个 Postman 集合! > example: /** * @api {GET} config/u
我有以下两个类: class Test1(): """Test1()""" def fn_test1(): """fn_test1 """ print
已结束。此问题正在寻求书籍、工具、软件库等的推荐。它不满足Stack Overflow guidelines 。目前不接受答案。 我们不允许提出寻求书籍、工具、软件库等推荐的问题。您可以编辑问题,以便
我已阅读 apidoc.js 文档,但我遇到了困境。我不太清楚 @apiParam 和 @apiSucces 之间的区别,文档没有正确解释它们的真正作用。例如,我有一个 get 和一个 put,其中包
我一直致力于 PyQt5 的一个项目(可在此处找到:https://github.com/MaVCArt/StyledPyQt5),它使用包结构来使导入更合乎逻辑。到目前为止,我在使用 Sphinx
所以我的 python 源文件在两个不同的目录中:- 例如 ~/work/myproject ~/.virtualenvs/myproject 如何使用 sphinx-apidoc 递归地查看两个目录
我正在尝试清理我的 python 代码文档,并决定使用 sphinx-doc因为它看起来不错。我喜欢使用如下标签引用其他类和方法: :class:`mymodule.MyClass` About my
当我运行 sphinx-apidoc 然后 make html 时,它会生成包含“Subpackages”和“Submodules”部分以及“module”和“package”的文档页面目录 (TOC
过去有几个关于这个主题的帖子声称 Sphinx 根本不支持这个。我有我的疑虑,但要么它已经更新,要么它的文档被很好地隐藏了,因为这是网站上的一个链接,另有说明: http://www.sphinx-d
我想从 SwaggerUI 中排除“默认”部分 - 我在其中保留不想公开的路由。我知道在 Nelmio Apidoc 的 2.x 版本中,config.yml 中有一个名为 exclude_secti
我正在使用 http://apidocjs.com/为我正在构建的 Express.js API 创建公共(public)文档。我的问题是,如何使用 Express.js 来路由和提供文档? 这是我的
我是一名优秀的程序员,十分优秀!