[sphinx-users] Re: Adding background color of notes and attention to Sphinx-generated PDF files

2016-10-12 Thread Minkai Li
I add this commands to my conf.py preamble,But it does not work. It can not compile. I use restructuredtext and sphinx in Ubuntu environment 在 2016年10月12日星期三 UTC+8上午7:34:18,Peter Burdine写道: > > You will need to add some Latex commands to your preamble. For example, > the following will make

[sphinx-users] Re: Text doesn't fit in simple table column - Latex-PDF export

2016-10-12 Thread Minkai Li
use CSV tables 在 2011年9月8日星期四 UTC+8上午4:48:36,Alan Evangelista写道: > > I've created the following simple table in restructuredText: > > = > === > Tag RequiredDescription > = >

[sphinx-users] Re: Customizing Relbar (both top/bottom) Links

2016-10-12 Thread Komiya Takeshi
Hi, It seems cloud_sptheme uses relbar() marcro to generate relbar. So you might be able to remote the hyperlink to genindex.html by overriding it. But, more simply way, you can disable to generate genindex using "html_use_index = False". Then the hyperlink will be removed automatically.

[sphinx-users] Re: PDF version shows one huge chapter? Table of contents issues with latexpdf

2016-10-12 Thread 'EMK' via sphinx-users
Once again I should confess that I am running Sphinx v1.3.2, so if there have been bug fixes that address this, I need to

[sphinx-users] how do I add subtitle?

2016-10-12 Thread Fiona Hanington
Hi (Excuse the newby question -- I am new to rst and sphinx and the person who set things up here has left, so I am trying to work things out.) I need to add a subtitle to an existing doc. Sphinx docs on the internet tell me that to add a title/subtitle, I simply need to add this to my

[sphinx-users] Re: Adding background color of notes and attention to Sphinx-generated PDF files

2016-10-12 Thread Peter Burdine
This is where you need to learn about LaTeX. Those commands include the character '@', so you need "\makeatletter" before those commands and "\makeatother" after those commands. The @ sign is a special character in LaTeX, so you need to tell the system that you are using it as a letter, then

[sphinx-users] Re: Sphinx-1.5a1 has been released

2016-10-12 Thread Komiya Takeshi
Hi, Originally, TocTree class is defined at sphinx.directives.other. so it is not moved. It is only imported at sphinx.directives. At 1.5a1, the imports are removed once. But I recovered it at current HEAD. Please wait 1.5a2. Thank you for reporting. Takeshi KOMIYA 2016年10月7日金曜日 9時24分39秒

[sphinx-users] Re: PDF version shows one huge chapter? Table of contents issues with latexpdf

2016-10-12 Thread Komiya Takeshi
> Can you give an example of how to use the orphan metadata tag? > Here: :orphan: Title of document == blah blah blah... > >- Where do I put the tag, in the file that is causing the build >warning or in the TOC file? > > The top of each files which are not listed

Re: [sphinx-users] Sphinx-1.4.7 released

2016-10-12 Thread Komiya Takeshi
Hi, Yes, the latest release is surely 1.4.8. sphinx-doc.org says wrong version. 1.4.9 is a version in development. We will fix the page in following issue: https://github.com/sphinx-doc/sphinx/issues/3027 Thanks, 2016年10月4日火曜日 3時26分57秒 UTC+9 Jeff McKenna: > > Hi Komiya-san, > > Just to

[sphinx-users] Re: Table of Contents bar on the left is not correct.

2016-10-12 Thread Komiya Takeshi
Hi, I think globaltoc helps you. Please add following settings to your conf.py: html_sidebars = { '**': ['globaltoc.html', 'relations.html', 'sourcelink.html', 'searchbox.html'], } In detail, please see the document: http://www.sphinx-doc.org/en/stable/config.html#confval-html_sidebars

[sphinx-users] Re: Is there any way to automatically add section titles to the genindex?

2016-10-12 Thread Komiya Takeshi
Hi, To make a extension you want, you have to do following things: * collect sections in the documents * register the each section to index Before develop extension, you should learn how to make a Sphinx extension: http://www.sphinx-doc.org/en/stable/extdev/index.html And you should also read

[sphinx-users] Re: Text doesn't fit in simple table column - Latex-PDF export

2016-10-12 Thread Komiya Takeshi
Hi, That might come from the behavior of LaTeX engine. As a adhoc way, you can give a hint to LaTeX engine with following notation: .. tabularcolumns:: |p{1.0cm}|p{1.0cm}|L| = === Tag Required Description =

[sphinx-users] Re: PDF version shows one huge chapter? Table of contents issues with latexpdf

2016-10-12 Thread Komiya Takeshi
Ah, I understand your situation. Sorry, :orphan: does not effect for this case. The warnings from included files are resolved at 1.4.x series. Please update Sphinx to newest one. Thanks, Takeshi KOMIYA 2016年10月13日木曜日 8時27分53秒 UTC+9 EMK: > > >

[sphinx-users] Re: Text doesn't fit in simple table column - Latex-PDF export

2016-10-12 Thread Komiya Takeshi
Note: I filed this as following issues: https://github.com/sphinx-doc/sphinx/issues/3042 https://github.com/sphinx-doc/sphinx/issues/3043 2016年10月13日木曜日 11時47分19秒 UTC+9 Komiya Takeshi: > > Hi, > > That might come from the behavior of LaTeX engine. > As a adhoc way, you can give a hint to LaTeX