[sphinx-users] Prevent glossary entries to be included in the index

2024-09-26 Thread Steevie
Hi there, I can not find in the docs any information about the problem mentioned in the subject. When building a glossary and an index, every entry in the glossary becomes also an entry in the index, which is quite redundant and somehow an unwanted behaviour. Indeed, my reference English styl

[sphinx-users] Re: How to avoid heading's link showing "Page x" in footnote's number

2024-05-14 Thread Steevie
On Mon, 13 May 2024 13:57:45 -0700 (PDT), Nhut Nguyen wrote: > Hi everyone, > > I use Sphinx to generate PDFs for my book. If a *heading* contains a > *link* > like this illustration and I want it to appear in the footnote, some > will show "Page x," like below. It does not always happen. Just *s

[sphinx-users] Re: Getting the base URL

2024-05-07 Thread Steevie
Hi Carl, On Tue, 7 May 2024 09:24:33 -0700 (PDT), Carl Gay wrote: > Hi Stefano, thanks for the reply. If I understand your solution > correctly, it requires duplicating the toctree for each distinct URL. > What I want is that if any member of the team builds/runs the site on > their local machine

[sphinx-users] Re: Getting the base URL

2024-05-07 Thread Steevie
Hi Carl, On Sun, 5 May 2024 09:44:16 -0700 (PDT), Carl Gay wrote: > My project has some external HTML files that are put in place as a > separate build step and I would like to add a link to them in my > toctree. Currently I have this, and it works fine, but it assumes a > static URL and therefor

[sphinx-users] Re: sphinx-doc and pdf as booklet

2024-04-29 Thread Steevie
On Sun, 28 Apr 2024 03:31:04 -0700 (PDT), Oleh Kravchenko wrote: > Hello, Sphinx-Doc community! > > I'm looking for a way to generate a PDF file as booklet. > Is it possible with Sphinx-Doc? There are AFAIK two packages that allow to print a latex document as a booklet: booklet and 2up. You can

[sphinx-users] Re: sphinx-build: Can't find conf.py in dir given by -c (v7.2.6)

2024-04-02 Thread Steevie
On Fri, 29 Mar 2024 06:44:20 -0700 (PDT), Emil Karlén wrote: > Hi, thanks for help, > > but the sphinx-build man page says it should be a lower case "-c": The "-C" option I was referring to is an option of make, not of sphinx- build. I didn't notice that you did add it to the makefile, sorry for

[sphinx-users] Re: sphinx-build: Can't find conf.py in dir given by -c (v7.2.6)

2024-03-19 Thread Steevie
On Fri, 15 Mar 2024 17:54:25 -0700 (PDT), Emil Karlén wrote: > Hello! > > I want the Sphinx source root to be the root directory of the project, > but have Sphinx conf.py in a subdirectory "sphinx". > The Sphinx Makefile is in the project root dir, and I have added > arguments > -c sphinx > to

[sphinx-users] Re: How .. contents:: works

2023-07-26 Thread Steevie
Hi, On Wed, 26 Jul 2023 08:20:19 -0700 (PDT), Lisa Scheuplein wrote: > I have looked at directives and this one is not listed in the > documentation. The previous writer used it for a table of contents at > the top of the page. > > From what I can figure out, it pulls from the heading style, H1,

[sphinx-users] Re: Change from sphinx_rtd_theme to alabaster theme not working

2023-07-06 Thread Steevie
Hi, On Wed, 5 Jul 2023 09:26:32 -0700 (PDT), Phillip Downen wrote: > I'm trying to change from sphinx_rtd_theme to the alabaster theme and > the html output does not look right...I change the theme as follows in > conf.py: > > #html_theme = 'sphinx_rtd_theme' > html_theme = 'alabaster' On every

[sphinx-users] Re: reducing ToC length

2023-05-04 Thread Steevie
Hi Nico, On Thu, 4 May 2023 11:15:24 +0200, Nico Gulden wrote: > Hello Steevie, > > I have documents with quite long tables of content, for example > https://docs.software-univention.de/manual/5.0/en/ > > I use a theme based on Sphinx Book Theme: > https://sphinx-book-th

[sphinx-users] reducing ToC length

2023-05-04 Thread Steevie
Hi all, on almost every projects I am working on, after a couple of months, the table of content becomes quite long and at times it also may result in strange side-effects (*). Scenario: I am using RTD theme and I simulated top-level parts by splitting the toctree in multiple toctress compos

[sphinx-users] Re: Enlarge 4 deep fontsize side bar with sphinx_rtd_theme

2023-04-11 Thread Steevie
Hello Ruud, sorry for getting back to you so late, On Thu, 6 Apr 2023 11:19:24 -0700 (PDT), Ruud van der Ham wrote: > With the help of Christopher Trudeau (Real Python], I have found that > when I patch css/themes.css > .toctree-l4{font-size:0.9em} > to > .toctree-l4{font-size:1.0em} > I

[sphinx-users] Re: Enlarge 4 deep fontsize side bar with sphinx_rtd_theme

2023-04-03 Thread Steevie
On Mon, 3 Apr 2023 01:51:46 -0700 (PDT), Ruud van der Ham wrote: > I have a sphinx HTML (www.salabim.org/manual) that has a 4-level deep > reference section. > Unfortunately, the font of the text in the sidebar is very small. Is it > possible to customise the font size? How? You can use the Web de

[sphinx-users] Re: html_static_path/html_logo

2022-09-09 Thread Steevie
On Thu, 8 Sep 2022 17:10:30 -0700 (PDT), Louis King wrote: > Hi all, > Trying to embellish the documentation on two programs on different > system I am using sphinx ver 5.0.0 on one and 5.1.1 on the other. Both > act the same. > In my conf.py file the html_static_path = ['../_static'] directive do

[sphinx-users] Re: Empty raw in a grid table

2022-08-12 Thread Steevie
Hi, On Fri, 12 Aug 2022 09:59:44 +0200, Vladimír Marek wrote: > I tried that as well already but it adds empty line at the top and > bottom of whole text block which is something I don't want I just want a > simple one empty line between text :-) untested but it should work: +---+---

[sphinx-users] Re: Hyperlink to autonumbered list item

2022-07-12 Thread Steevie
Hi Josué, On Tue, 12 Jul 2022 07:37:35 -0300, Josué Andrade Gomes wrote: > Hi, > > I’m trying to create a hyperlink to an autonumbered list item. The > hyperlink works fine but the items are not correctly numbered. > > Sample -- > > See: :ref:`This ` and :ref:`That ` > > Items - > >

[sphinx-users] Re: Pyto, Sphinx, and my iPad

2022-05-19 Thread Steevie
On Wed, 18 May 2022 20:50:07 -0700 (PDT), Phil Carter wrote: Hi Phil, > *Hello Jean … Thank you for your response.* > > OK. But first, are you implying that the Sphinx that is integrated into > Pyto might be a totally different app from your Sphinx tool? And purely > coincidental that they both