我有一个Sphinx文档,并希望有一个多版本的Sphinx文档。
最重要的是,我有一个zip文件,我想成为文档的一部分,游客可以点击下载。
我在./docs/source/_downloads/examples/
文件夹中有zip文件。在其中一个RST文件中,下载链接被注解为:
:download:`here </_downloads/examples/examples.zip>`
然而,我在通过sphinx-multiversion "docs/source" "docs/build/html" -W --keep-going -n
构建文档时遇到了这个错误:
C:\Users\<username>\AppData\Local\Temp\tmpei93x8y0\6d1e6ca1fe60c272b003f0bf7e611df99dc35d1d\docs\source\examples.rst:4: WARNING: download file not readable: C:\Users\<username>\AppData\Local\Temp\tmpei93x8y0\6d1e6ca1fe60c272b003f0bf7e611df99dc35d1d\docs\source\_downloads\examples\examples.zip
我正在使用Python 3.9.4
,Sphinx 7.0.1
和sphinx-multiversion 0.2.4
。
1条答案
按热度按时间xlpyo6sf1#
显然,sphinx-multiversion通过提交哈希来归档文件,因此如果更改是在本地进行的,而不是通过
git commit
提交的,sphinx-multiversion构建将失败。在sphinx-multiversion的git.py模块中:
用于sphinx-multiversion的main.py:
一旦我
git add
和git commit
下载文件,构建工作完美,没有错误。