Questions tagged [read-the-docs]
Free documentation hosting for the Open Source community
551
questions
0
votes
0
answers
20
views
Stopping Popup 'This is the latest development version' [closed]
Recently readthedocs has started displaying a popup that says:
'This is the latest development version...'
I do not want this popup. If I want to direct the user to another version of the ...
1
vote
1
answer
28
views
how can I make readthedocs find my configuration file which is already in GitHub project repository root directory?
I am trying to publish a Python package's documentation on readthedocs.org.
It was being published in previous releases. However, I am getting
"The configuration file required to build ...
-1
votes
0
answers
23
views
Can I use Read the Docs for a Spring Boot Project?
Is it possible to have a Read the Docs page for a Spring Boot project?
If yes, what changes or specific annotations do I have to add to my code to make sure it is ready for Read the Docs?
I was ...
0
votes
1
answer
32
views
ReadTheDocs has started insisting on alabaster. I want the default theme back
There's lots and lots of advice on how to use a custom theme. I have the opposite problem: Up until recently, all my hosted doc sites used the gorgeous read-the-docs theme by default because that's ...
0
votes
1
answer
49
views
Why is Sphinx READ THE DOCS not updating from our GitHub?
We have Sphinx READ THE DOCS for our TorahBibleCodes GitHub project presented at the following link:
https://torahbiblecodes-sphinx.readthedocs.io/en/latest/usage.html
The source code for display of ...
0
votes
1
answer
48
views
What is modules.rst from sphinx-apidoc?
I am using sphinx==6.2.1 and sphinx_rtd_theme==1.3.0. I ran sphinx-apidoc, and it generated a modules.rst that looks like this:
package
======
.. toctree::
:maxdepth: 4
package
When I go to ...
0
votes
1
answer
109
views
Ignore LaTeX errors with Sphinx LaTeXBuilder while building documentation PDFs
In my project, I am building a PDF version of my documentation with Sphinx's LaTeXBuilder where I have several files and extensions that can potentially cause problems with the output. The project is ...
0
votes
2
answers
73
views
error on sphinxs generated documentation on readthedocs
I have written the documentation for a Node.js library using Sphinx. On my local PC, I can generate the html docs without any problems. However, when I try to publish it on Read the Docs, the ...
1
vote
1
answer
80
views
API Reference building locally but not on RTD
I am trying to build an API reference for the Python Package GemGIS using autosummary (see here).
The API Reference is built locally without any issues but I am getting ImportErrors and ...
0
votes
0
answers
68
views
Python documentation of some modules does not appear in readthedocs [duplicate]
I am generating documentation for a project using Read the Docs. The build runs successfully but the documentation shows only for one module but not the other, even though I used the same syntax.
...
1
vote
0
answers
46
views
sphinx read the docs edit on source with self hosted gitlab
The process to add the "Edit the Source" Button on sphinx docs pages mentioned here is kind of working fine on public GitLab repos.
html_context = {
"display_gitlab": True, # ...
0
votes
0
answers
13
views
Converting traditional knowledge base into in-app context relevant articles
I want to organize KB articles so they are directly accessible from relevant menus in our cloud based web application. I imagine something like "related articles" as typical from Wiki based ...
1
vote
1
answer
87
views
Read the docs build module not found error, but no local issue
I am trying to use the sphinx-click module in my rst file for my documentation on Read the Docs. It normally auto-builds from the git repo without any issues but now that I want to use sphinx-click I ...
0
votes
1
answer
43
views
Items and sub-items in different directories and listed in menu - Sphinx
I'm creating a project using the Sphinx tool.
And to keep the organization, I separated the sub-items into directories with the name of the item "Mother", as follows:
├──conf.py
├──index.rst
...
0
votes
1
answer
146
views
Change colors sphinx_rtd_theme python docs
In my conf.py I use the following to make docs with Sphinx and use a custom theme;
html_theme = "sphinx_rtd_theme"
html_static_path = ["_static"]
html_css_files = [
'...
0
votes
1
answer
134
views
Sphinx autodoc works locally but not on Read The Docs
I have a GitHub repo (here) which is extremely basic and only meant to reproduce a problem I had with another repo (CPU Health Checks also in my public repos)
It consists on a package called rtdtest ...
0
votes
0
answers
45
views
Sphinx can not run my module on RTD but it works locally
I have made a python package which uses CUDA code. Using autodoc_mock_imports I managed a CUDA dependency error due to the import of PyCuda. The issue I have right now is directly inside my package: ...
0
votes
0
answers
34
views
What is the preferred way to do google site verification on ReadTheDocs?
The day job has RTD pulling/building our docs from our Gitlab repo, and building automatically. I'm trying to track down 404 issues and the like with the Google Search Console (we can't help what ...
0
votes
1
answer
64
views
Broken CSS in Sphinx build on readthedocs.org
My project builds its documentation on readthedocs.org using Sphinx.
I notice that something that used to work is now broken: there is list-style: none applied to the lists, when there shouldn't be: ...
0
votes
0
answers
19
views
Build ReadTheDocs based on a tag insted of a branch
I would like to follow the OneFlow branching model. There you have only one branch reflecting the latest state. I can build the docs for it without problems.
But the latest stable is identified via a ...
0
votes
2
answers
136
views
how to I preserve newlines while converting markdown from github to read-the-docs?
I am trying to convert some documentation from github to read-the-docs.
I came across an interesting issue where my newlines (aka line breaks aka /n) are getting lost in conversion. this happens with ...
0
votes
0
answers
57
views
Docs are broken : https://readthedocs.org/projects/radis/builds/19302835/
First time using ReadTheDocs.org so I'm a little bit out of my depths here but I'm learning quickly I have gone through the code like a hundred times but I can't seem to find the error
The ...
1
vote
1
answer
87
views
Is Python 3.7 the latest available version for readthedocs.io?
I am using type hints and when I build my docs in readthedocs.io, it tells me "type is not subscriptable". The error refers to list[str].
def build_pirate_ship(source_path: str=None) -> ...
1
vote
1
answer
183
views
Sphinx, ReadTheDocs and package version
I maintain a package whose documentation I auto-generate with Sphinx on readthedocs.org. For Sphinx/readthedocs I use a conf.py and a properly defined .readthedocs.yaml.
Inside the conf.py I use the ...
0
votes
0
answers
28
views
ReadTheDocs : compilation Error with PySide6 6.2.4?
I have a public code on gitlab with sphinx documentation. When I try to compile the documentation using readthedocs, I get the following error :
WARNING: autodoc: failed to import module 'Analysis'; ...
1
vote
1
answer
53
views
Setting up AWS access keys in ReadTheDocs account
I'm trying to download some files from S3 bucket as part of jobs.pre_build in .readthedocs.yaml file. This is specifically needed for every pull request created. For this to work we need to setup the ...
0
votes
1
answer
83
views
sphinx-autoapi fails to combine class and __init__ docstrings (autoapi_python_class_content = 'both')
sphinx-autoapi allows to combine the class docstrings and the __init__ docstrings using the autoapi_python_class_content = 'both' option.
However, even with this option set (conf.py), it fails to ...
0
votes
0
answers
77
views
Adding open/close menu in sphinx documentation project
Can We add an open/close menu in front of Client Interview Preparation as it is showing in front of Aditya Birla?
I have lots of names under Client Interview Preparation, that's why I am willing to ...
0
votes
0
answers
24
views
Add repo from GitHub Organization
I'm trying to set up a repo that is on GitHub under an organization. I belong to the organization, but am not an owner. When I go to "Import a Repo", it doesn't show up.
I could set it up ...
0
votes
1
answer
368
views
Material for mkdocs collapse and expand table of contents
I want this:readthedocs
Instead of this: material
I haven't seen anything that would help with this in the material for mkdocs nav setup
2
votes
0
answers
51
views
Exact redirects -- what happens if I now add a custom domain?
I wanted to check something before I break everything. It may be obvious to you, but I'm naturally cautious and wanted to see whether I'm OK to do what I'm thinking.
I currently have docs on RTD (and ...
0
votes
1
answer
184
views
Pages not showing on side menu
I am using Sphinx and ReStructuredText to create documentation, but even though all pages were created the same way, only 4 out of 8 are showing on the side menu. This is my table of contents:
.. ...
0
votes
0
answers
250
views
Failed to establish a new connection: [Errno 113] No route to host'))
I am trying to connect Readthedocs and Gitlab to each other via gitLab OAuth 2.0, I say connect with gitlab without any problem via readthedocs, gitlab connects and I select authorize, but the ...
3
votes
1
answer
616
views
How can I wrap text inside a cell to get a table from a csv file in the Sphinx documentation created using Restructured text (RST) files?
I want to add a table from a csv file in the Sphinx documentation.
In the rst file, I used the csv-table directive as follows:
.. csv-table:: xyz
:header-rows: 1
:file: path/file.csv
...
0
votes
0
answers
62
views
What is the cause of the error readthedocs install "Can't find any collection named tasks"
According to the guide in the link, I am trying to install Readthedocs with docker. However, the "inv docker.build" mentioned in the doc gives an error like this
https://dev.readthedocs.io/...
0
votes
0
answers
193
views
I can't update the sqlite3 version in python 3.8 command line?
I am following the pip steps in the manual for the installation of readthedocs. However, in the requests of this installation, sqlite3 has specified a minimum of 3.19 and above. I am upgrading sqlite3 ...
0
votes
1
answer
331
views
Automatic doc build on ReadTheDocs.org on every new commit
I want my docs on Read the Docs automatically build on every commit I do on a specific branch.
My repo is at Codeberg.org (Gitea). It doesn't use Sphinx but user specific build.command executing ...
0
votes
1
answer
60
views
About the error in the installation steps of readthedocs local server
I'm trying to install readthedocs on my local gitlab server and I'm following the guide in the link.
ReadThedocs Guide
Here's the python version and pip version I'm using;
Python3.9
Pip3.9
To run ...
0
votes
1
answer
279
views
Why does sphinx automodule work properly only on local but not on readthedocs?
Local Sphinx
ReadTheDocs
As you can see in the ReadTheDocs image, there is no EstraClient imported, whereas it appears in Local Sphinx.
I used an automodule that was not listed in readthedocs. If ...
1
vote
1
answer
131
views
Prevent MyST from changing .md image paths
I'm generating sphinx documentation with.md files that reference images via relative paths:

I use MyST to parse the .md files into html, but it removes the ../' ...
0
votes
1
answer
458
views
my sphinx rtd themed documentation builds locally, fails building when posting to rtd?
OH GEEZ
the extension is "myst**_**parser" and the library is myst-parser. The only thing better would be if somewhere else I had written mystParser...
Thank you
Steve - I don't use ...
0
votes
1
answer
216
views
Is there a way Automate sphinx-apidoc generation in readthedocs
I'm somewhat new at both these tool sets.
Currently I am running sphinx-apidoc... and then checking in the resulting doc/source/*.rst files so that readthedocs produces more than an empty document.
...
1
vote
1
answer
196
views
Create single Sphinx documentation page on readthedocs.org from multiple Python repositories
I have an open source project split into different repositories, which I would like to document on a single readthedocs page (using, for instance, sphinx.ext.autosummary). For now, the Sphinx conf.py ...
0
votes
0
answers
42
views
Is possible to overwrite a function in the htmlbuilder?
I'm working on the pydata-sphinx-theme. What we currently (v0.12) do is overwritting the html builder to add specific behaviours to the visit_table, and starttag to make the created component ...
0
votes
1
answer
168
views
Sphinx docs: table of contents skips to top when new page is "below the fold"
I've a problem with the HTML I'm building from sphinx (version 3.4.3 -- I know it's old, this is for reasons beyond my control, although I've just tried rebuilding with v4.4.0 and I'm seeing the same ...
2
votes
0
answers
465
views
Sphinx recursive autosummary not importing modules
I'm going crazy with Sphinx's recursive autosummary. My working directory is:
my_wd
|
|-- docs
| |-- source
| |--index.md
| |--conf.py
| |-- _templates
| |-- custom-module-...
0
votes
1
answer
124
views
local sphinx generates autodoc members from docstrings, readthedocs does not
I have a small project at github. The package does not have external dependencies, and all the source is included in a single __init__.py file. In the ./docs folder, I just have 2 rst files: an index....
0
votes
0
answers
59
views
Is it possible to write only specific directives to an XML file
I'm rather new to Sphinx and ReST and I've "inherited" a big project.
The documentation consists of hundreds of pages with how to's, etc. There are several files (one for each class) where ...
1
vote
1
answer
57
views
How can I restrict search results to certain sections of an RTD manual?
We use RTD to produce the documentation for our project. The documentation consists of two broad parts: book-style chapters & sections on the one hand, and auto-generated documentation extracted ...
0
votes
1
answer
54
views
Remove the "Edit" option on ReadTheDocs
I am looking to remove the "Edit on Github" option on Readthedocs on this website: https://sparkles-wiki.readthedocs.io/en/latest/ but I can't. I did find some articles on github but it ...