-
-
Notifications
You must be signed in to change notification settings - Fork 3.2k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
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
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Okay, looks like this worked (on CircleCI at least) so I updated the other CI configurations with the new latex dependencies. Thanks for the update @Erotemic !
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