Use xetex for uft8 latex backend#4326
Conversation
|
+1 for xelatex. Is that not enough to solve the unicode problems? I've never heard of "xindy" either. |
|
I don't don't have deep knowledge about latex or sphinx and I know nothing of xindy, but I only got it to work after including |
|
Looking into this a little more, it seems like the missing dependency for xindy is
It's a bit annoying that this requires another external dependency, but it's a small one and easy to install. I'd vote for the latter just because it reduces the chances of getting bit with LaTeX-unicode in the future. Relevant sphinx docs on xindy: https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-latex_use_xindy |
|
Based on the docs, it does look like we want to use xindy over the default makeindex when utf8 characters are enabled. Looks like you also need to I tried installing |
5bc738d to
717c3a4
Compare
rossbar
left a comment
There was a problem hiding this comment.
A minor modification to the dependencies list and a suggestion for a less-verbose sphinx conf file. Other than those two things, I think this should go in for better unicode support (in the source) for our latex docs.
I tried this via docker and it worked, but we'll see if CircleCI agrees. If so, then I'll update the travis and gh-actions configs as well.
Co-authored-by: Ross Barnowski <rossbar@berkeley.edu>
Co-authored-by: Ross Barnowski <rossbar@berkeley.edu>
Co-authored-by: Ross Barnowski <rossbar@berkeley.edu>
Closes #4325 This is a component of #4169
I finally settled on
Turns out xindy --- don't really know what that is --- was causing errors, and this setting allows xelatex to work (I think xindy is more a pdflatex thing?).
This PR does not have any dependencies
This PR is depended on by #4294, #4350, and #4327