read-the-docs

问题 I am trying to link my Sphinx documentation with Readthedocs. I can build the documentation locally in my computer but when I try to have Readthedocs automatically generate the documentation I get the following error: Configuration error: There is a programmable error in your configuration file: Traceback (most recent call last): File "/home/docs/checkouts/readthedocs.org/user_builds/helstrom-quantum-centroid-classifier/envs/latest/lib/python3.7/site-packages/sphinx/config.py", line 368, in

问题 There seems be an odd problem with Readthedocs. Builds are failing without any apparent reason. On the same commit ID, build failed once and was success later: Failure: https://readthedocs.org/projects/opnfvdocsdemo/builds/4909528/ Success: https://readthedocs.org/projects/opnfvdocsdemo/builds/4911183/ My most recent build is failing too, it only has an extra space from the last successful commit: https://readthedocs.org/projects/opnfvdocsdemo/builds/4915952/ This is happening for multiple

问题 I'm using Read The Docs for a project. Everything seems to be working well online. However, when I download the HTML for offline use, I find that the documentation is all crammed into a single HTML file (index.html). Is it possible to download the documentation so that it has the same look and feel as the online docs with separate, linked pages? I tried changing the documentation type from the RTD Admin > Settings page between the three options (Sphinx Html, Sphinx HtmlDir, and Sphinx Single

问题 I'm using Read The Docs for a project. Everything seems to be working well online. However, when I download the HTML for offline use, I find that the documentation is all crammed into a single HTML file (index.html). Is it possible to download the documentation so that it has the same look and feel as the online docs with separate, linked pages? I tried changing the documentation type from the RTD Admin > Settings page between the three options (Sphinx Html, Sphinx HtmlDir, and Sphinx Single

问题 I'm new at working with Sphinx and I know thats Phynx is not predestined for tables but I would like to use it for a documentaion of our survey instruments. Therefore I created a table with different topics that are asked in our questionnaires. Since our survey started in 1984, we have a lot of years to cover. The table looks like this: The years (rows) go on until the recent year and it's going to grow every year When I use the table (in csv format) in Sphynx it doesn't show the whole table,

问题 I continue to have failed builds with ReadTheDocs using a github repository with Jupyter notebooks rendered using sphinx and the readthedocs theme. I am able to render these locally, however when I try with RTD, I get the following fail message: I tried placing the nbsphinx.py file in the repository but things still fail. Link to RTD is here: https://readthedocs.org/projects/calculus-notes/ Github repo is here: https://github.com/jfkoehler/calc_docs 回答1: RTD needs to install nbsphinx . To

问题 I continue to have failed builds with ReadTheDocs using a github repository with Jupyter notebooks rendered using sphinx and the readthedocs theme. I am able to render these locally, however when I try with RTD, I get the following fail message: I tried placing the nbsphinx.py file in the repository but things still fail. Link to RTD is here: https://readthedocs.org/projects/calculus-notes/ Github repo is here: https://github.com/jfkoehler/calc_docs 回答1: RTD needs to install nbsphinx . To

问题 I have a repository on github: https://github.com/springer-math/Mathematics-of-Epidemics-on-Networks Within it there is a file docs/SIR_2dgrid.mp4 which contains an animation I want to appear in the documentation at readthedocs (specifically at this page: http://epidemicsonnetworks.readthedocs.io/en/latest/Simulation_Investigation.html) Additionally, there is a file docs/Simulation_Investigation.rst which codes that page and tries to refer to that mp4. I've tried lots of variants (attempting

问题 I'm having an issue where ReadTheDocs doesn't appear to be updating with new documentation files. Specifically, we added these files (everything d3 related here) but in ReadTheDocs they don't appear (see [this][4]); What I'd expect to see is this: Here's a screenshot of the correctly built docs Note the "Empirical D3 Wrapper" link, which is in the docs when built locally using "make html" but not evident when built on ReadTheDocs. There aren't any errors in the build log that I can find, and

问题 I'm trying to import my project code for readthedocs so that it can generate a documentation for me. However, at the stage of cloning the repo, there is already an error: checkout ----- Failed to import project; skipping build. Error ----- Failed to get code from 'http://mydomain/myproject.git' (git clone): 128 That error code indicates, that the repository is private, and I cannot access it without logging in, unless I have my SSH key that enables a secure connection between my computer and