Questions tagged [read-the-docs]

Free documentation hosting for the Open Source community

Filter by
Sorted by
Tagged with
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 ...
Brad Bell's user avatar
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 ...
Ceren's user avatar
  • 77
-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 ...
CptOrange16's user avatar
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 ...
Ian's user avatar
  • 4,461
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 ...
TorahBibleCodes's user avatar
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 ...
Intrastellar Explorer's user avatar
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 ...
agriyakhetarpal's user avatar
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 ...
Hector Socarras's user avatar
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 ...
Alexander Jüstel's user avatar
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. ...
Chaimaa's user avatar
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, # ...
Krishna's user avatar
  • 964
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 ...
Peter Koldig Hansen's user avatar
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 ...
justinian482's user avatar
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 ...
Rockguitar's user avatar
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 = [ '...
Dan's user avatar
  • 121
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 ...
Felipe Santana's user avatar
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: ...
Maxime D.'s user avatar
  • 336
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 ...
Gushi's user avatar
  • 31
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: ...
Erez's user avatar
  • 1,287
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 ...
buhtz's user avatar
  • 10.9k
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 ...
ffsb's user avatar
  • 5
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 ...
The Newbie's user avatar
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) -> ...
FancyPantsFlower's user avatar
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 ...
MERose's user avatar
  • 4,068
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'; ...
Pierre's user avatar
  • 1
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 ...
Neelasha Sen's user avatar
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 ...
Wasserwaage's user avatar
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 ...
Rahul Srivastava's user avatar
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 ...
Swandog's user avatar
  • 71
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
Arkya's user avatar
  • 1
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 ...
stichbury's user avatar
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: .. ...
Agatha Garcia's user avatar
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 ...
sysoptr's user avatar
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 ...
hbstha123's user avatar
  • 1,250
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/...
sysoptr's user avatar
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 ...
sysoptr's user avatar
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 ...
buhtz's user avatar
  • 10.9k
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 ...
sysoptr's user avatar
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 ...
Interesting's user avatar
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: ![](../_static/figures/image.png) I use MyST to parse the .md files into html, but it removes the ../' ...
Joshua von Damm's user avatar
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 ...
user1255603's user avatar
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. ...
Frank C.'s user avatar
  • 7,785
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 ...
Wasserwaage's user avatar
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 ...
Pierrick Rambaud's user avatar
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 ...
stichbury's user avatar
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-...
sato's user avatar
  • 780
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....
Alberto Garcia's user avatar
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 ...
kronk's user avatar
  • 13
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 ...
Christian's user avatar
  • 1,499
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 ...
Sabry Superman's user avatar

1
2 3 4 5
12