- html - 出于某种原因,IE8 对我的 Sass 文件中继承的 html5 CSS 不友好?
- JMeter 在响应断言中使用 span 标签的问题
- html - 在 :hover and :active? 上具有不同效果的 CSS 动画
- html - 相对于居中的 html 内容固定的 CSS 重复背景?
我使用诗歌构建我的 cython 包。我在所有函数和类中都有 NumPy 风格的文档字符串。我现在要做的是添加 Sphinx 自动文档并发布在 Read the Docs。
我已阅读此主题 How do I use Sphinx with Cython?并了解首先我必须编译我的 .pyx 文件。但是,当我最后调用 poetry build
时,我只得到 .tar.gz 和 .whl 文件,没有 .pyd 或 .so 文件。
所以问题如下:是否有任何方法可以在诗歌构建过程中插入回调,以便在调用某些参数时自动生成文档?
我也会欣赏到包的链接,它们一起使用诗歌、sphinx 和 cython,以便我可以从中学习。
最佳答案
我写了一个带例子的小教程。您可以在这里找到它:https://github.com/iamishalkin/cyrtd
要点:
添加readthedocs.yml
version: 2
python:
install:
- method: pip
path: .
extra_requirements:
- docs
- method: pip
sphinx:
configuration: docs/source/conf.py
在pyproject.toml中添加依赖:
[tool.poetry.dependencies]
python = "^3.7"
cython = "^0.29.13"
sphinx = { version = "^2.2", optional = true }
sphinx_rtd_theme = { version = "^0.4.3", optional = true }
[tool.poetry.extras]
docs = ["sphinx", "sphinx_rtd_theme"]
在 ReadTheDocs 的仪表板上激活“安装项目”复选框
setup.py
有一种不优雅的解决方法。如果您知道如何解决这个问题,请告诉我。
关于cython - 诗歌+狮身人面像+Cython,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/57988721/
我在使用 Java 的 Sphinx 语音识别库时遇到问题。我正在使用它来获取输入并处理它。我第一次获得输入时,它起作用了。第二次,它在我有机会说话之前立即回答了自己。在那之后,它只是继续回答自己。我
我使用诗歌构建我的 cython 包。我在所有函数和类中都有 NumPy 风格的文档字符串。我现在要做的是添加 Sphinx 自动文档并发布在 Read the Docs。 我已阅读此主题 How d
是否可以使用重组文本将图像放置在标题内? 就像是: Introduction .. image:: path/to/img.png ----------------------------------
我正在尝试自动生成我的 Django 项目的文档。文档树在 html 页面上生成,但我的任何模块中的任何成员都没有文档。我一直遇到这个问题: Running Sphinx v1.1.3 loading
Sphinx 文档工具是否提供不同的 PDF 主题,就像提供不同的 HTML 主题一样? 我用 Google 搜索了这个问题,但找不到答案,这让我相信答案是否定的。不过,我想我应该在这里问。 谢谢。
我正在尝试使用 Sphinx 为我的 Python/Flask 应用程序构建文档,但我无法导入该文件。 我导入views.py文件在 views.rst ,但出现错误消息:No module name
我已经开始将 Sphinx 用于 django 项目,但遇到了障碍: 模块的文档是这样的: :mod:`models` Module -------------------- .. automodul
我们的 Travis CI 测试刚刚开始随机中断: https://travis-ci.org/Gallopsled/pwntools/builds/343962397 错误信息: Could not
我能否拥有 conf 变量的页面本地值(通常在 conf.py 中找到)? 比如我有 hyphenator_language = "en-us" 在 conf.py 中。我可以要吗 hyphenato
我有一些 python 模块,主要包含函数和一些类。每一个都在单独的第一个文件中使用 sphinx-autodoc 进行记录。我想做的是在每个页面的顶部创建一个表或模块内容列表,例如,mymodule
我正在处理我的 RTFM 文档,我想更改 html 标题。目前,我的标题是这样的: [PAGE TITLE] — My Documentation documentation [PAGE TITLE
我有一个用 Python 编写的 Raspberry Pi 项目,它使用 RPi.GPIO 模块。代码上的所有工作都是在 Windows 机器上完成的,其中 RPi.GPIO 不会安装,每次我尝试运行
在 Sphinx 中,是否可以自动定义标题标签?我发现我的文档最终看起来很像这样: .._doing stuff:Doing Stuff-----------You might also want :
我在使用 js:function 指令时收到以下错误。为什么 :param 不能识别::之间的多个值? "选项数据无效:扩展选项字段名称不能包含多个单词。 .. js:function:: f(tes
当我们输入命令sphinx-quickstart时,我们要输入很多次值。 例如: > Root path for the documentation [.]: > Separate source an
浏览 C and C++ domains Sphinx,它似乎没有对记录枚举(更不用说匿名枚举)的原生支持。截至目前,我使用 cpp:type:: 作为枚举类型,然后是所有可能值及其描述的列表,但这似
我收到多个警告,例如: 警告:pyfar.signal.TimeData.times 的重复对象描述,pyfar.classes_audio 中的其他实例,对其中之一使用:noindex: 但想不通为
我希望能够在引用脚注的地方创作脚注,但只在文档末尾显示,其中 .. rubric: Footnotes出现。 像这样: Lorem Ipsum[#lorem]_ dolor sit blah blah
如何交叉引用 reStructuredText 文档中的索引项? 例如,我如何交叉引用 SectionB: .. index:: pair: SectionA; SectionB Sectio
我想要的是在 Sphinx 文档中包含一个 xlsx 表(或者更确切地说是所述文件的数据)。 有什么方法可以将 xlsx 工作表转换为 restructuredText? 最佳答案 您不需要将其转换为
我是一名优秀的程序员,十分优秀!