Building docs from multiple repos on one site

397 views
Skip to first unread message

M.B.

unread,
Dec 5, 2019, 7:25:49 PM12/5/19
to sphinx-users
We have a Sphinx documentation site for our software product, nothing fancy. It hosts our general documentation, let's say at docs.xyz.org

Our software is made up of many packages across many repositories on github, many of which are community contributed (we're open source).
We're looking for a way to push package documentation from disconnected repos (written in rst, kept in a top level /docs directory in the repo) to our main sphinx site.

The naming structure could be something like docs.xyz.org/version/package_name for the package ReadMe and docs.xyz.org/version/package_name/tutorials for any tutorials, but it could also be something like tutorials.xyz.org/version/package_name, or anything similar.

Is anything like this possible? I can't find any information on accumulating and rendering pages from across multiple repos.

Any info or direction is greatly appreciated!

Luc Saffre

unread,
Dec 5, 2019, 9:21:23 PM12/5/19
to sphinx...@googlegroups.com, M.B.
Not exactly the same, but maybe inspiring: we have a rather complex system of interdependent Python packages and Sphinx doctrees, and I try to document it on the following page:

https://www.lino-framework.org/dev/writedocs.html

Luc
--
You received this message because you are subscribed to the Google Groups "sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/6e3a761f-fae8-433b-b3ff-0be2e30cc11c%40googlegroups.com.

Reply all
Reply to author
Forward
0 new messages