Questions tagged [read-the-docs]
Free documentation hosting for the Open Source community
490
questions
0
votes
0
answers
18
views
Does Mkdocs need to be installed for maintaining a mkdocs-based Read-the-Docs project?
I installed MkDocs, created a local project, and uploaded it to GitHub. Then, in Read-the-Docs, I created a project linked to the Github repo set to auto build. The output looks as expected and ...
0
votes
1
answer
58
views
readthedocs build fails to produce sphinx documentation with shields.io svg badges
My latest Sphinx documentaion fails when trying to build it with readthedocs. It has apperently something to do with the fact that I am trying to incorporate some badges from https://shields.io/. ...
0
votes
1
answer
44
views
Readthedocs build ignores submodules when dependency requires authentication (ex: when python package requires Google Earth Engine)
My package has Google Earth Engine's Python API (package name: ee) as a dependency. Using sphinx to auto-generate documentation (for ultimate storage on readthedocs) works locally, however all of the ...
0
votes
0
answers
18
views
Readthedocs tries to build mkdocs project with sphinx
I'm creating a python package for the first time and am having a lot of trouble getting my documentation to upload to readthedocs. I am using mkdocs to create my documentation. When I run the mkdocs ...
1
vote
1
answer
47
views
Is a Bullet List With a Long Link Possible in RST Without Warnings?
I have a long link escaped like this:
`Build Azure Devops Agents With Linux cloud-init for Dotnet Development \
[terraform, azure, devops, docker, dotnet, cloud-init]`_
.. _Build Azure Devops Agents ...
1
vote
1
answer
39
views
Sphinx Documentation (autodoc) not working after uploading to Github
I have built sphinx documentation for my package.
It is working fine when testing localhost. But after uploading it to Github and building docs on readthedocs.org the documentation page is not working ...
0
votes
0
answers
24
views
Build documentation for older version before .readthedocs.yaml was added to repo
I am importing a project to read the docs; I have a series of git tags representing older versions of the library; which I would like to have docs generated for those versions as well. The problem is ...
0
votes
0
answers
32
views
How to add copy button in .rst file or Read The Docs (RTD)
This is the duplicate question but i follow the steps as the link, and the code-block still didnt show up the button icon as expected.
which steps did i miss?
Install
pip install sphinx-copybutton
...
0
votes
1
answer
20
views
MKdocs-readTheDocs: How to set the Home page?
Yes, this is a rookie question, but its not clear to me from the documentation how to set up the home page. I get a 404 on the home page. Not sure what its missing. Any help is really appreciated. ...
0
votes
1
answer
42
views
How do I use images in tables in read the docs CSV tables?
I have a csv-table element, how do I put images in a cell? I'm using sphinx and building with Read The Docs. I've tried doing
(table.csv)
...
..image:: [image path]
...
but this only shows up as ...
0
votes
0
answers
75
views
Auto-generate and use index.rst with readthedocs
I'd like to render docs for a project (e.g. https://github.com/ansible-collections/cisco.ios ) which contains a directory docs/ with a lot of *.rst files, but no index.rst with a .. toctree:: ...
3
votes
1
answer
34
views
Readthedocs custom domain stops working with ssl issue
I got problems with my custom domain setup on readthedocs.
Suddenly custom domain (https://docs.joinrpg.ru) stops working with SSL_ERROR_NO_CYPHER_OVERLAP.
Variois SSL checkers report that they "...
0
votes
1
answer
105
views
autodoc: workaround when "cannot import module"
The package I want to document with Sphinx contains pure Python modules (ok) + a C/C++ library bind using pybind11.
There are a lot of dependencies that can not reasonnably be built on ReadTheDocs!
So ...
0
votes
0
answers
37
views
Get 'make html' to process jupyter notebooks with markdown instead of with restructuredtext
The github repo on which I work with many others contains many python files and about ten jupyter notebooks. 'make html' currently assumes that the markdown JN cells are written in reST, which can ...
1
vote
1
answer
45
views
Sphinx RtD: change the output folder name
I would like to change the Sphinx / Read-the-Docs make html output folder name to 'docs' rather than 'html'. Is there a way to do this? I've been going over the conf.py documentation and the only ...
0
votes
0
answers
22
views
Persuade (nb)sphinx to render markdown cells in a jupyter notebook for readthedocs just as jnb does
Screenshot of markdown source follows:
Rendering by Stackflow = Rendering by jupyter notebook follows:
$ts$ = empty set # $ts$=training set
for each labelled WSI $W_i$
create the subset $S_i$ of ...
0
votes
1
answer
167
views
Sphinx / autodoc: how to cross-link to a function documented on another page [duplicate]
I am building a documentation of my Python package using Sphinx.
I have a API.rst file, in which I list my functions as follows: .. autofunction:: mymodule.foo.bar1
For the different functions that ...
0
votes
1
answer
99
views
Built in with MkDocs in Readthedocs
I am preparing documentation using MkDocs and trying to generate the documentation using readthedocs. I followed the user guide but readthedocs does not seem to communicate with my uploaded .md files ...
0
votes
1
answer
74
views
Types of setter arguments not showing in Sphinx documentation
I can't figure out how to get the type hints to appear in the Sphinx generated documentation from setters arguments.
I have a Python class with an attribute called batches and I've got docstrings in ...
2
votes
2
answers
136
views
Error when running pip install -r requirements.txt
to build and run a local instance, im following the tutorial at
https://haha.readthedocs.io/en/latest/install.html
but i use the git repo
https://github.com/readthedocs/readthedocs.org.git
instead of
...
0
votes
1
answer
14
views
Pass flags to the Sphinx runner?
So I've got the following project OpenFHE-development and when I run the build process, there are lots of warnings. However, most of these warnings are fine to ignore (we vet them before pushing to ...
0
votes
0
answers
21
views
How to fetch RSS feed on ReadTheDocs
I have many rst files with rss urls on each page and I have to fetch rss content and paste it on the respective pages. Any Idea on how to do it?
Suppose its RSS like
https://example.com/feeds/project/...
0
votes
0
answers
62
views
Readthedocs.org contribution, Error installing readthedocs locally
I am following the development guide on https://dev.readthedocs.io/en/latest/install.html to install read the docs locally on GitHub CodeSpace
I fail at the step inv docker.build
It returns errors ...
0
votes
0
answers
11
views
Clean up old builds on internal installation of Read The Docs
I have inherited a Read The Docs in-house installation (to see our internal git server), in which it was a known issue that the build volume would eventually run full. Now it has again and we would ...
-1
votes
1
answer
39
views
Embedding scrollable pdf in a rst file
How to display a scrollable pdf in a rst file. I've already tried ..image:: and ..figure:: but they didn't work and showed only the path to the pdf file like shown below
Can anyone tell how to embedd ...
0
votes
1
answer
82
views
Headings and Chapters are messed up in ReadTheDocs Sphinx PDF file
For some reason, the subtitles become the chapters in the PDF generated for my docs by ReadTheDocs.
Check it out here: https://yarsaw.namantech.me/_/downloads/en/latest/pdf/
Here's the code for the ...
0
votes
0
answers
17
views
Local document is different from hosted one for math formulas
I have my documents for read-the-docs in a github repository. Before pushing to the repo, I always run sphinx locally to produce the html. When I am satisfied I push my changes to the github repo and ...
0
votes
1
answer
40
views
Sphinxdoc/Readthedocs: redirect a "flat" structure to a hierarchical one
I have a Sphinxdoc page on readthedocs with a large number (>1000) of hierarchically sorted pages, https://iraf.readthedocs.io/en/latest/tasks/index.html.
My problem is now that I also need to ...
1
vote
0
answers
96
views
Get current_version in rst file of readthedocs theme
On a readthedocs / Sphinx project, I need to display current_version in rst file and to generate link with the current_version.
Screenshot:
I've seen it in templates (versions.html):
v: {{ ...
-1
votes
1
answer
118
views
How can i use myst_parser with sphynx in readthedocs?
I can build the docs completely fine on my computer and open the HTML result and it looks great, but when I push to GitHub and read-the-docs tried to build it- I get the following error:
root file /...
1
vote
1
answer
48
views
Create a new version on ReadTheDocs
I need help in setting up a new version for our documentation on ReadTheDocs. Currently, we have the documentation for versions 6 and 7 of our product published on our ReadTheDocs site, and this ...
0
votes
1
answer
30
views
Changed github repo, but still readthedocs auto-building upon commits to old repo
I have a project on the read-the-docs that builds automatically upon commits to the github repo. I recently separated out the docs to a separate github repo, and changed "Repository" on read-...
0
votes
0
answers
13
views
File does not exist: staticfiles.json
So I am installing developer install of readthedocs and after following their documentation I end up getting this error after going to http://community.dev.readthedocs.io/ on the machine that is ...
0
votes
0
answers
28
views
sphinx-autobuild copy files (.rst, .sh, .py) on build [duplicate]
I have a sphinx project inside ./docs directory. The docs directory has a sub-directory resources ./docs/resources. When I run the command <sphinx-autobuild . docs/_build/html> only the .rst ...
0
votes
1
answer
260
views
sphinx: shields.io badges rendering but displaying errors/incorrect information inside output html, but URLs are correct when opened from browser
I have this issue with sphinx rendering shields.io badges.
I am using sphinx and the read-the-docs template.
I want to add a series of badges in my index.rst file. The URLs correctly work in my README....
0
votes
0
answers
15
views
Can't find header field in my pdfs generated from read-the-docs
I have tried but I can't find the answer anywhere, so here goes.
In the pdfs I generate for my read-the-docs website the header seems to have a missing field. On the top-right of the header I see:
, ...
0
votes
1
answer
89
views
Sphinx rtd docs dropdown only works post click
I have created an rtd themed documentation for my package using sphinx and sphinx_rtd_theme. The index.rst is as follows:
Welcome!
.. toctree::
:maxdepth: 1
:glob:
src
Indices and tables
==...
1
vote
0
answers
78
views
How do I document projects within monorepo using Readthedocs / sphinx?
I would like to use readthedocs.org platform to document a set of related software stored using monorepo principle. The repository structure is following:
/
+- ComponentA
| |- docs
| |- component-a-...
-1
votes
1
answer
84
views
Readthedocs: Is there conf.py file documentation?
RTD docs are pretty good, but I'm not seeing anything regarding conf.py details. For example, I want a local doc as well, and my conf.py contains:
html_theme = 'sphinx_rtd_theme'
# override the ...
0
votes
0
answers
37
views
Potential of embedding aspects of Swagger or Slate into ReadTheDocs API Documentation?
Right now I am using readthedocs for API documentation. I wanted to switch to Slate API documentation but decided against it since the integration would be too much, instead I was wondering if there's ...
1
vote
1
answer
71
views
ReadTheDocs build error. Error message incompehensible
Since I've added tqdm as a dependency to my project build started failing with error like below:
https://readthedocs.org/projects/pychastic/builds/15291280/
Traceback (most recent call last):
File &...
3
votes
0
answers
140
views
How are cookie queries handled on Read the Docs?
How are cookie queries handled on Read the Docs?
Currently, Google Analytics can be used for Read the Docs documentation. However, a cookie is set for this. In order for this to be compliant with the ...
0
votes
1
answer
156
views
Sphinx documentation builds locally successfully with autodoc but when i try to build it on readthedocs all the pages became empty
I'm trying to put the documentation of a code i've done on readthedocs but all the pages just becomes blank. I've tried it all day i've watched/readed dozens of tutorials but nothing seens to work. It ...
0
votes
0
answers
62
views
ReadTheDocs: docs not being built on pull request
I have a single Python project on GitHub which has a User, Developer and Reference Guide ('psyclone', 'psyclone-dev' and 'psyclone-ref', respectively). Each of these has its own RTD project (...
2
votes
1
answer
79
views
Why does RTD run "python env create" instead of "conda env create" when building?
I have a project on ReadTheDocs that I'm trying to build. I'm using a very basic .readthedocs.yaml file that reads:
# .readthedocs.yaml
# Read the Docs configuration file
# See https://docs....
2
votes
1
answer
60
views
Readthedocs adding html_logo causes type error
I have some documentation deployed on readthedocs.io. It was working fine until I added the following line to my conf.py:
html_logo = '_static/logo.png',
As soon as I try to build the project on ...
0
votes
0
answers
50
views
Does readthedocs behave differently if a build branch has a slash in it?
I am using readthedocs to build documentation for my project.
I currently have two branches docstest and feature/sphinx with identical content being parsed by readthedocs. You can view each of these ...
0
votes
0
answers
43
views
readthedocs custom subdomain point from godaddy not working
Could someone helps?
It seems everything is correct setting.
I have point my subdomain from readthedocs project as below.
Type Name Value TTL Actions
CNAME docs webpres.readthedocs.io. 1 ...
1
vote
0
answers
111
views
How can I link functions in a Sphinx table?
I have added functions to the "Usage" section of my Read the Docs project which I am designing with Sphinx. I'm looking for a way that I can automatically link each function in a table or ...
0
votes
1
answer
59
views
How can I create an incoming webhook via ReadTheDocs API?
I am aware that you can create and delete incoming webhooks using the ReadTheDocs UI (for GitHub, GitLab, etc. integration), but I need to be able to do this without accessing the UI to automate the ...