JuliaIntro/IntroAJulia.jl

PDF Generation

Opened this issue · 3 comments

"Hi guys, I have a couple of doubts in the output generation, PDF and HTML. Normally, I generate it in order to read in a better format. First, the footnotes in PDF appear on line, and not as footnotes. Second, the Latex mathematical symbols use a weird charset. I think is my setup, then. How can I add the right font? Usually, I generate my work on ORG-MODE using Latex and Tufte style documents."

Originally posted by @smendozabarrera in #5 (comment)

Yes, we don't have adequate documentation of how to generate a PDF. This documentation should include info about what fonts could be used. The PDF that is on the website now does not have great fonts and could be improved; as a start we should describe how this imperfect PDF file could be generated.

I'll work on this, including looking into having Travis generate a PDF for each branch. We're already building HTML for each branch; see #43.

I've worked on generation of a PDF by Travis in the cp/pdf2 branch, with HTML and PDF available online. Unfortunately the emoji in the PDF don't work yet. If I get this working a bit better, the .travis.yml will be one place to go for documentation of how to generate a PDF.

In the source asciidoc the following two lines are displayed the same in HTML but differently in PDF

`grados/2/π`
+grados/2/π+

Use of the back-tics (`) seems to be the right choice to produce a fixed-width font in HTML and PDF, while all the source files use plus (+). Theres more to be done on this.