On Thu, 7 Mar 2019 at 01:40, Cleber Rosa <cr...@redhat.com> wrote: > I have the impression that this can be simplified by making use of > "only" tags: > > https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-only > > So, conf.py could detect if it's being run on readthedocs.org: > > ON_RTD = os.environ.get('READTHEDOCS', None) == 'True' > > And manipulate the "tags" variable accordingly: > > if ON_RTD: > tags.add('devel') > tags.add('interop') > > Then, on an index.rst, it could be a simple matter of: > > .. only:: devel > ================ > Developers Guide > ================ > .. toctree:: > docs/devel > > .. only:: interop > ============= > Interop Guide > ============= > .. toctree:: > docs/interop > > .. only:: devel and interop > =============== > QEMU Full Guide > =============== > .. toctree:: > docs/devel > docs/interop
Thanks for pointing out the tags functionality. That said, this won't do what we want, will it? * building the docs gives all the docs in the build tree * but we only install via 'make install' the ones the user wants thanks -- PMM
