-
Notifications
You must be signed in to change notification settings - Fork 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
LaTeX: for French language and lualatex engine polyglossia and not babel is used contrarily to Sphinx documentation #12410
Comments
This fixes the documentation which was faulty since v1.7.6, but #12410 is left open until a decision is taken.
My current opinion is that lualatex should by default use same as xelatex for French i.e. babel not polyglossia because the former more completely implements French typographical rules. In the past I would have pushed the change to a branch for major releases as this is breaking change (I do not believe it matters really in that case because French users either do not care and will not notice the change or they do care and already have suitable conf.py). Ping @AA-Turner about what is policy. As said in my parenthetical remark I think we can do the change on master but what about "more breaking" changes in some other situation, should it arise? |
Describe the bug
At our doc for
'babel'
key of'latex_elements'
, it is said:This is true for
'xelatex'
but not for'lualatex'
value oflatex_engine
.How to Reproduce
index.rst
test === nothing
conf.py
Then
make latex
and the LaTeX file will contain\usepackage{polyglossia}
.Environment Information
Sphinx extensions
No response
Additional context
The discrepancy between
'xelatex'
and'lualatex'
has been there ever sincev1.7.6
. There is a code comment# for xelatex+French, don't use polyglossia
in sphinx/writers/latex.py but no explanation for why'xelatex'
only. But the documentation mentions the two so is buggy.(edited) The faulty commit was 8a23ad1. It followed on #5178 fixing #4272.
Either
'lualatex'
uses polyglossia,'lualatex'
also usebabel
with French language.Note that there are quite a few differences between babel and polyglossia for French language in output PDF, particularly regarding lists.
Hoping for comments by LaTeX experts.
The text was updated successfully, but these errors were encountered: