[sphinx-users] Add section headings to sidebar? Like :caption: but in the middle of sidebar.

2019-01-28 Thread nick
I'm working on a sphinx site for a course I'm teaching, and I'm looking for a way to add section headings to break up my side-bar (Say, a "Programming Principles" caption followed by a few pages on things like abstraction, decomposition, and defensive programming. Then another caption like "Com

[sphinx-users] Re: best way to build multiple documents with sphinx but only install/ship a subset?

2019-01-28 Thread Matthew Woehlke
On 25/01/2019 07.08, Peter Maydell wrote: > Hi; for the QEMU project we're looking to convert our existing > documentation to use Sphinx, and I have a question about how best to > structure things, which I haven't been able to find an answer for in the > documentation. > > For QEMU we (will) h

[sphinx-users] Re: :doc: in a custom directive

2019-01-28 Thread Matthew Woehlke
On 23/01/2019 10.27, Maxime Adam wrote: > With that's said I'm willing to do this following directive > > class MarkAsDeprecated(Directive): > > def run(self): > > txt = "Blablabla moved to :doc:{0}".format(self.arguments[0]) > paragraph_node = nodes.paragraph(text=txt) > >

Re: [sphinx-users] Sphinx extension internationalization?

2019-01-28 Thread Vincent Férotin
Hi, Thank you very much, Takeshi Komiya: your answer described exactly what I missed. So, I'd purposed to fix the doc. in this PR: https://github.com/sphinx-doc/sphinx/pull/5991 for next users... Cheers, V.F. Le jeu. 24 janv. 2019 à 16:49, Komiya Takeshi a écrit : > > Hi, > > Sorry for confusi

Re: [sphinx-users] Raise/log warning in doctree-resolved

2019-01-28 Thread Maxime Adam
Thanks a lot don't know where I failed, but now it's working. Tanks a lot Le dimanche 27 janvier 2019 10:29:19 UTC+1, Komiya Takeshi a écrit : > > Hi, > > Thank you for answer. > > On my local, the following code works fine: > ``` > def warning(app, doctree, docname): > import sphinx >