-
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: improve docs of 'printindex' and 'makeindex' #8851
Conversation
generate the index differently, append some content after the index, or | ||
change the font. As LaTeX uses two-column mode for the index it is | ||
often advisable to set this key to | ||
``'\\footnotesize\\raggedright\\printindex'``. Or, to obtain a one-column |
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.
The jsbook.cls
does this automatically, but not the ujbook.cls
used with uplatex
. As uplatex
will be default at next major release I did not add this information. But note that the switch to uplatex
has the after effect that index for Japanese document does not use \footnotesize
setting... so the advice here might be useful to Japanese users in future :)
change the font. As LaTeX uses two-column mode for the index it is | ||
often advisable to set this key to | ||
``'\\footnotesize\\raggedright\\printindex'``. Or, to obtain a one-column | ||
index, use ``'\\def\\twocolumn[#1]{#1}\\printindex'`` (this trick may fail |
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.
This trick works with our default 'manual'
and 'howto'
also with Japanese, but for the latter either with 'howto'
or with uplatex
. With platex
and 'manual'
(jsbook.cls
) it will not work because since #8779 (support for hlist
directive) we load multicol
package and jsbook.cls
in that case does not use \twocolumn
macro in theindex
environment.
I figured it was not worthwile adding these details as anyhow uplatex
will soon be default.
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.
I figured it was not worthwile adding these details as anyhow uplatex will soon be default.
+1
@@ -527,7 +538,6 @@ Keys that are set by other options and therefore should not be overridden are: | |||
``'title'`` | |||
``'release'`` | |||
``'author'`` | |||
``'makeindex'`` |
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.
I have searched througout our files and I see no reason why this 'makeindex'
was said to be set by other options. There may have been some confusion with the makeindex
step which uses mendex
with Japanese class, or it was right in the past, but something changed.
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.
LGTM
change the font. As LaTeX uses two-column mode for the index it is | ||
often advisable to set this key to | ||
``'\\footnotesize\\raggedright\\printindex'``. Or, to obtain a one-column | ||
index, use ``'\\def\\twocolumn[#1]{#1}\\printindex'`` (this trick may fail |
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.
I figured it was not worthwile adding these details as anyhow uplatex will soon be default.
+1
Merging, thanks! |
Closes #8055