IntroAJulia.jl icon indicating copy to clipboard operation
IntroAJulia.jl copied to clipboard

PDF Generation

Open chrisvwx opened this issue 5 years ago • 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 https://github.com/JuliaIntro/IntroAJulia.jl/issues/5#issuecomment-678637834

chrisvwx avatar Aug 22 '20 19:08 chrisvwx

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.

chrisvwx avatar Aug 22 '20 19:08 chrisvwx

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.

chrisvwx avatar Sep 13 '20 01:09 chrisvwx

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.

chrisvwx avatar Oct 20 '20 02:10 chrisvwx