[sphinx-users] Python documentation theme ?

2019-10-04 Thread Nicholas Yue
Hi, I would like to use the theme with Python 3 (e.g. https://docs.python.org/3/index.html ) I'd like to be able to have a drop down for multiple version so that user can jump between different versions being documented. Cheers -- Nicholas Yue Graphics - Arnold, Alembic, RenderMan, OpenGL,

[sphinx-users] Documenting + consolidating multiple repos/directories into one searchable html output

2019-10-04 Thread Nicholas Yue
Hi, I have success documenting individual repo/directory However, I would like to document a collection of related (git) repositories python source code into on html outputdir. Is that possible ? What is the recommended approach ? I have had a look at sphinx-multibuild with multple

[sphinx-users] Re: Formatting references in PDF

2019-10-04 Thread jfbu
Le 04/10/2019 à 19:51, Jeff Larson a écrit : Sphinx references within a PDF are formatted as italics. How can I change this to fixed width font? The word "link: in a reference such as :ref:`link` will be italicized. Inspecting the generated .tex source shows that such references are a

[sphinx-users] Formatting references in PDF

2019-10-04 Thread Jeff Larson
Sphinx references within a PDF are formatted as italics. How can I change this to fixed width font? The word "link: in a reference such as :ref:`link` will be italicized. Inspecting the generated .tex source shows that such references are a sphinxcrossref, which is not a package that I know

Re: [sphinx-users] i18n: Translated msgid strings in content files not merged into HTML output

2019-10-04 Thread Aliahegr Javadi
Hi i cheng for ever having you Plase for fllowers erve good perogram. Writing Isee and go Thankyou Aliasghar javadi در 2019 10 3 20:26، "'Mark Peters' via sphinx-users" < sphinx-users@googlegroups.com> نوشت: > Since upgrading from Sphinx 1.8 to 2.1, the translated strings in the PO > files in my

[sphinx-users] Re: Ignore parts of index.rst in the latexpdf build

2019-10-04 Thread Jeff Larson
Thank you very much On Friday, October 4, 2019 at 7:06:02 AM UTC-5, Jeff Larson wrote: > > Is it possible to have Sphinx ignore part of index.rst when building the > pdf with latexpdf? > > For example, my index.rst file contains (but does not begin with) the > lines > > .. image::

[sphinx-users] Re: Ignore parts of index.rst in the latexpdf build

2019-10-04 Thread Stefano David
Hi On Friday, 4 October 2019 14:06:02 UTC+2, Jeff Larson wrote: > > Is it possible to have Sphinx ignore part of index.rst when building the > pdf with latexpdf? > Yes, it is, by using the directive only:: html before the lines you don't want to include in the (latex)pdf. Remember to indent

Re: [sphinx-users] Ignore parts of index.rst in the latexpdf build

2019-10-04 Thread Eric Larson
You could probably solve this by ignoring the file with bad content, and then in a new file, using two consecutive `.. include` directives -- one with a `:end-before:` and the other with a `:start-after:`, after doing some labeling before and after your RST section to be ignored.

[sphinx-users] Ignore parts of index.rst in the latexpdf build

2019-10-04 Thread Jeff Larson
Is it possible to have Sphinx ignore part of index.rst when building the pdf with latexpdf? For example, my index.rst file contains (but does not begin with) the lines .. image:: https://img.shields.io/ :target: https://pypi.org/ .. image:: https://travis-ci.org/ :target: