Le 08/01/2018 à 20:20, 'Erin Kelly' via sphinx-users a écrit :
I'm getting a blank Release line on my PDF title page. That is, after my image 
and the document name, there's a smaller italic line that says */Release/* but 
since I'm not using a release number there's nothing else there. I don't want 
the word Release to appear.

I previously used a workaround that involved adding the statement 
'releasename': '' to latex_elements, but that approach is no longer working.

That workaround is documented many places, including here in this group 
<https://groups.google.com/d/msg/sphinx-users/_DAyYxRfZ9Y/K5IvN2alLEkJ > (from 
2014). I haven't found any updated information about how to fix this.

I'm suspicious that some of the latex fixes that went in around 1.5.5 are 
responsible for the change - possibly this one? 
https://github.com/sphinx-doc/sphinx/issues/3392

I have documents produced in March 2017 where it worked (no */Release/* line on 
the title page); I'm not sure what version I used to build those. As of version 
1.5.5 the workaround stopped working. I tried rebuilding my last correct 
document (the March 2017 source files) using 1.5.5 and it gets a blank 
/*Release*/ line.

I installed 1.6.6 this morning and it gives the same result.

Is there a new workaround, or a fix to suppress the */Release/* line on the PDF 
title page when the release term is empty?


Hi,

the Sphinx LaTeX style file is dysfunctional with an empty release number: 
indeed it does

    \fancyhead[LE,RO]{{\py@HeaderFamily \@title, \py@release}}

which means that in case of empty release number you will get page headers with 
a comma after the title and then blank space.

But to address your problem you can set

 'releasename': ' ',

in latex_elements (this will suppress its line too, moving the location of 
author a bit up)

(the problem with ``''`` is that it fools test in sphinx/writers/latex.py)

To not move author location on title page, use

    'releasename': '\\mbox{}',


But you will have the header problem (at least with 'manual') I mentioned above.

To workaround this you will have to use the fancyhdr LaTeX commands to 
re-define your headers and inject this via 'preamble' key

(else, one needs to hack into what `\@title` does)

Best,

Jean-François



--
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Reply via email to