How does ReadtheDocs URL look like with multi projects after modifying makefile?

[sachin-suresh-rapyuta]

As per the steps explained in Using Sphinx’s Makefile, PROJECT=dev make html can be used to build HTML locally. But, how to manage this on publishing to ReadtheDocs?

Say, I want to build and publish updates to dev and/or user projects, should I have to define the commands twice for 2 different projects? Something like below:

# Put your default project here.
PROJECT ?= user
BUILDDIR = _build/$(PROJECT)

PROJECT ?= dev
BUILDDIR = _build/$(PROJECT)

After publishing to ReadtheDocs, what does the URL for 2 different projects look like:

Is it:

• readthedocs-hosted.com/en/latest/user/
• readthedocs-hosted.com/en/latest/dev/ ?

[stsewd]

But, how to manage this on publishing to ReadtheDocs?

You'll need to define an environment variable for each project, see https://sphinx-multiproject.readthedocs.io/en/latest/quickstart.html#importing-your-projects-on-read-the-docs.

After publishing to ReadtheDocs, what does the URL for 2 different projects look like:

You'll need to create a different project on Read the Docs for each sphinx project, so your documentation will be served as:

• first-doc.readthedocs-hosted.com/en/latest
• second-doc.readthedocs-hosted.com/en/latest

You can also make use of subprojects (https://docs.readthedocs.io/en/stable/subprojects.html) and have your docs like:

• first-doc.readthedocs-hosted.com/en/latest
• first-doc.readthedocs-hosted.com/projects/second/en/latest/