Re: [Standards] Broken XEP PDFs on xmpp.org/extensions (no ToC)

2017-03-20 Thread Marvin Gülker
On Mon, Mar 20, 2017 at 09:43:31AM -0500, Sam Whited wrote:
> Sorry about that; this was an oversight on my part. I've fixed it and
> will merge the changes when CI passes (although if you know a more
> elegant way, I'm all ears):
> 
> https://github.com/xsf/xeps/pull/453/files

There is latexmk, a script that determines how often LaTeX needs to be
run[1]. I have never used it, though. I usually use the bruteforce
solution to just call {pdf,xe,lua}latex three times in a row. Your
solution is nicer.

Marvin

[1]: http://personal.psu.edu/jcc8//software/latexmk-jcc/

-- 
Blog: https://www.guelkerdev.de
PGP/GPG ID: F1D8799FBCC8BC4F
___
Standards mailing list
Info: https://mail.jabber.org/mailman/listinfo/standards
Unsubscribe: standards-unsubscr...@xmpp.org
___


Re: [Standards] Broken XEP PDFs on xmpp.org/extensions (no ToC)

2017-03-20 Thread Sam Whited
On Mon, Mar 20, 2017 at 3:02 AM, Marvin Gülker  wrote:
> I looked into this problem a little more, and it appears that the
> Makefile only runs xelatex once.

Sorry about that; this was an oversight on my part. I've fixed it and
will merge the changes when CI passes (although if you know a more
elegant way, I'm all ears):

https://github.com/xsf/xeps/pull/453/files

—Sam
___
Standards mailing list
Info: https://mail.jabber.org/mailman/listinfo/standards
Unsubscribe: standards-unsubscr...@xmpp.org
___


Re: [Standards] Broken XEP PDFs on xmpp.org/extensions (no ToC)

2017-03-20 Thread Marvin Gülker
On Sat, Feb 25, 2017 at 09:42:10AM +0100, Marvin Gülker wrote:
> However, it appears there's a number of XEPs on xmpp.org/extensions
> whose PDF files have no Table of Contents, albeit the HTML versions
> have.

I looked into this problem a little more, and it appears that the
Makefile only runs xelatex once. That's not sufficient to build the ToC,
since LaTeX generally needs at least two runs to build a document from
scratch successfully (collecting and resolving crossreferences,
especially for the ToC). See here:

  
https://github.com/xsf/xeps/blob/860f1ab116bca50481c0f73f6be25f9792c97615/Makefile#L82

Changing that to run xelatex multiple times (at least twice) fixes the
problem. I didn't have the "Gentium Basic" font available, but a
"Gentium Plus" font, which looks pretty similar, so changing the font
name in xep2texml.xsl was also required. After these changes, I was able
to compile XEPs to PDFs from the XSF GitHub repository linked to
above. There are some other problems (e.g., in XEP-0136 there is a
nested table that fails to compile in XeLaTeX), but I won't bother with
them for now.

Greetings
Marvin

-- 
Blog: https://www.guelkerdev.de
PGP/GPG ID: F1D8799FBCC8BC4F
___
Standards mailing list
Info: https://mail.jabber.org/mailman/listinfo/standards
Unsubscribe: standards-unsubscr...@xmpp.org
___