search

usnistgov / Docs4NIST

ReadTheDocs work-alike for Sphinx documentation at the US National Institute of Standards and Technology
https://pages.nist.gov/Docs4NIST
Other
2 stars 3 forks source link

Should use xelatex instead of pdflatex #8

Closed ianhbell closed 1 year ago

ianhbell commented 1 year ago

I am not sure where this happens, but you have unicode in your generated rst, it will fail to compile to PDF, you need to use instead xelatex which handles unicode usually flawlessly.

guyer commented 1 year ago

The action invokes make latexpdf by default. This command can be overridden, but I don't know what RtD does, and I'm skeptical to make a blanket change to xelatex.

ianhbell commented 1 year ago

Hrm, I'll have to dig into what RtD does and see how they solve the problem. Here is an example with some unicode that is converted properly to html, but I now see is not converted properly to PDF on RTD: https://teqp.readthedocs.io/en/latest/getting_started/index.html#introduction . So the same problem occurs on RTD as well.

ianhbell commented 1 year ago

I am testing this as we speak: https://stackoverflow.com/a/71880248

guyer commented 1 year ago

I, in fact, have just such a line in one of my repos, for exactly that reason.

ianhbell commented 1 year ago

It seems that nbsphinx clashes with this option :(

guyer commented 1 year ago

Any incompatibility between xelatex and nbsphinx isn't going to get sorted out in this action.