Re: [sphinx-users] Re: Actual, working example of latex-pdf cover page?

2016-12-22 Thread Warren Block
On Mon, 19 Dec 2016, Warren Block wrote: On Thu, 15 Dec 2016, Peter Burdine wrote: Then I define the following for the front matter (note that some of these are commands defined in the preamble or other included .tex/.sty file): latex_contents = r'''     \setupHeadFootForFrontMatter

Re: [sphinx-users] Re: Actual, working example of latex-pdf cover page?

2016-12-20 Thread Warren Block
till being able to write that section in rst for consistency with the rest of the document and being able to generate both HTML and PDF output from it. But no, it appears not. On Dec 19, 2016 5:03 PM, "Warren Block" <wbl...@wonkity.com> wrote: On Thu, 15 Dec

[sphinx-users] TeX PDF link rendering bug

2016-12-19 Thread Warren Block
Generating a PDF with latex_pagerefs = True causes URLs to be included after links. This is great for people who are reading on paper. However, long link URLs only wrap where words can be broken, causing part of the URL to run off into the margin. An example is: Users new to ZFS who

Re: [sphinx-users] Re: Actual, working example of latex-pdf cover page?

2016-12-19 Thread Warren Block
On Thu, 15 Dec 2016, Peter Burdine wrote: I can't share my exact coverpage, but here are some references I used when learning how to do it: * https://github.com/mapserver/docs * https://github.com/i6/ibg Sorry, somehow I didn't even see these the first time. That second one has a good

Re: [sphinx-users] Actual, working example of latex-pdf cover page?

2016-12-16 Thread Warren Block
On Thu, 15 Dec 2016, Komiya Takeshi wrote: Hi, At preamble part, The "@" sign is not expanded. Please use \makeatletter before that like following:     'preamble': r'''        \makeatletter        \renewcommand{\maketitle}{          \begin{titlepage}          \noindent \Huge \@date \par        

Re: [sphinx-users] Re: Actual, working example of latex-pdf cover page?

2016-12-15 Thread Warren Block
will keep banging my head on this. On Thursday, December 15, 2016 at 8:04:46 AM UTC-8, Warren Block wrote: Is there an actual, complete example that shows the magical mix of files and latex commands to produce a modified cover sheet?  A trivial example would be fine.

Re: [sphinx-users] Actual, working example of latex-pdf cover page?

2016-12-15 Thread Warren Block
On Thu, 15 Dec 2016, Warren Block wrote: Is there an actual, complete example that shows the magical mix of files and latex commands to produce a modified cover sheet? A trivial example would be fine. It appears that \maketitle needs to be redefined, but my attempts at that fail with TeX

[sphinx-users] Actual, working example of latex-pdf cover page?

2016-12-15 Thread Warren Block
Is there an actual, complete example that shows the magical mix of files and latex commands to produce a modified cover sheet? A trivial example would be fine. It appears that \maketitle needs to be redefined, but my attempts at that fail with TeX errors. Or I could define my own and set

[sphinx-users] PDF code block font size

2016-12-14 Thread Warren Block
I would like to reduce the font size used in code blocks in latex PDF output to minimize wrapping. Some web searching found a Stack Overflow article: http://stackoverflow.com/questions/9745854/sphinx-pdf-themes But it's incomplete and the links are broken. Is there an easy way to reduce the

Re: [sphinx-users] PDFs, images, and long table bug

2016-12-14 Thread Warren Block
A followup to this: After adding 'figure_align': 'H' to latex_preamble for strict figure rendering, long tables no longer occasionally continue down off the bottom of a page. Not a cure, maybe, but a workaround. On Tue, 1 Nov 2016, Warren Block wrote: Thanks to Peter Burdine's help, I've

[sphinx-users] Dblatex?

2016-11-14 Thread Warren Block
Dblatex produces very nice PDF output with AsciiDoc. Implementation-wise, AsciiDoc produces DocBook which is then rendered to PDF by Dblatex. Conceptually, this should also be possible with Sphinx. Has anyone attempted to use Dblatex with Sphinx? Searching did not produce any results. --

Re: [sphinx-users] Re: Sphinx PDF themes

2016-11-14 Thread Warren Block
suggestions on the project's issue tracker: https://github.com/brechtm/rinohtype/issues I will be making a new release in the next couple of days. I'll announce it on this mailing list when it is available. Best regards, Brecht On 2016-10-28 01:08:36 +, Warren Block said: On Thu, 27 Oct 2016

[sphinx-users] PDFs, images, and long table bug

2016-11-01 Thread Warren Block
Thanks to Peter Burdine's help, I've started adding :class: longtable to tables so they wrap across pages in a PDF when necessary. However, this appears to have uncovered a bug. On pages where an image precedes the table but the table does not wrap to the next page, the text sometimes runs

Re: [sphinx-users] Re: Sphinx PDF themes

2016-10-27 Thread Warren Block
adding table column widths, several pages of the PDF have non-table text running off the bottom of the page. So it's looking it might be necessary to use rst2pdf. On Wednesday, October 26, 2016 at 4:30:07 PM UTC-7, Warren Block wrote: On Wed, 26 Oct 2016, Peter Burdine wrote

Re: [sphinx-users] Re: Sphinx PDF themes

2016-10-26 Thread Warren Block
with simple tables. On Tuesday, October 25, 2016 at 3:48:21 PM UTC-7, Warren Block wrote: On Tue, 25 Oct 2016, Peter Burdine wrote: > > Please post the tabularcolumns directive you are using and enough of the table definition to see the first header row.  There isn't enou

Re: [sphinx-users] Re: numref with number and caption

2016-08-27 Thread Warren Block
Done: https://github.com/sphinx-doc/sphinx/issues/2916 Thank you! On Sat, 27 Aug 2016, Komiya Takeshi wrote: Hi, It's good idea. Please post your proposal to github issues. I will implement it in future (maybe in 1.5 or 1.6). Thanks, Takeshi KOMIYA 2016年8月26日金曜日 6時17分02秒 UTC+9 Warren Block

[sphinx-users] numref with number and caption

2016-08-25 Thread Warren Block
I would like a numref-like role that inserts both a table or figure number *and* the the linked object's caption. Right now, this can be sort of crudely done (using Sphinx 1.4.4): See :numref:``,\ :ref:`example-table`. .. figure:: supernumref.jpg The Super-Numref Role Which

[sphinx-users] numrefs and figures

2016-08-17 Thread Warren Block
Looking at http://www.sphinx-doc.org/en/stable/markup/inline.html#role-numref It says: If an explicit link text is given (like usual: :numref:`Image of Sphinx (Fig. %s) `), the link caption will be the title of the reference. As a special character, %s will be replaced to figure number.

Re: [sphinx-users] Re: Figure caption problem with numfig

2016-08-15 Thread Warren Block
On Thu, 11 Aug 2016, Komiya Takeshi wrote: Since Sphinx-1.3, Sphinx provides numfig feature as a built-in. So no extensions are needed now. It will go well if you remove the sphinx-numfig extension. Absolutely right. Thank you! Thanks, Takeshi KOMIYA 2016年8月12日金曜日 12時25分05秒 UTC+9 Warren

Re: [sphinx-users] Re: Figure caption problem with numfig

2016-08-11 Thread Warren Block
On Thu, 11 Aug 2016, Komiya Takeshi wrote: Hi, Do you use sphinxtr/numfig.py? It appends "Figure n:" automatically. https://github.com/jterrace/sphinxtr/blob/master/extensions/numfig.py#L124 Please tell me what extensions you are using. The port is from here:

Re: [sphinx-users] Re: Figure caption problem with numfig

2016-08-11 Thread Warren Block
On Thu, 11 Aug 2016, Peter Burdine wrote: Did you define (or un-define) the numfig_format in your conf.py? numfig_format = {'figure': 'Figure %s',                  'table': 'Table %s',                  'code-block': 'Code %s',                 } No, I tried this but these were all still

[sphinx-users] Figure caption problem with numfig

2016-08-10 Thread Warren Block
Trying to figure out where an extra "Figure 1" is appearing in figure captions. For example :numref:`Figure %s ` shows what we are talking about. .. _fig1 .. figure:: images/sample.png Sample Caption The HTML produced (wrapped for clarity): Fig. 3.1.1 Figure 1: Sample

Conditional builds (was Re: [sphinx-users] Conditional bullet list items)

2016-07-27 Thread Warren Block
On Wed, 27 Jul 2016, Warren Block wrote: Hello. I'm new to Sphinx, but so far it is making sense. Using Sphinx 1.4.4 on FreeBSD at present. I am trying to use a single .rst file for two versions of a software project. As a more general question: The only:: and ifconfig:: options

[sphinx-users] Conditional bullet list items

2016-07-27 Thread Warren Block
Hello. I'm new to Sphinx, but so far it is making sense. Using Sphinx 1.4.4 on FreeBSD at present. I am trying to use a single .rst file for two versions of a software project. Part of this file has a bullet list describing features of the software. * New glunkifier for fribulating