Latex reduce left margins #8657
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
The way the line is broken in case of a long item label is buggy and this shows in case of nested description lists. We fix this, but the we then need a hack around Sphinx automatically inserted ``\leavevmode`` which would again cause an extra blank line after the long term label. This suppresses about 2500 extra blank lines in PDF output... closes scipy#8652
StrahinjaLukic
pushed a commit
to StrahinjaLukic/scipy
that referenced
this pull request
Apr 14, 2018
DOC: fix LaTeX package expdlist bug causing blank lines in PDF The way the line is broken in case of a long item label is buggy and this shows in case of nested description lists. We fix this, but the we then need a hack around Sphinx automatically inserted ``\leavevmode`` which would again cause an extra blank line after the long term label.
jfbu
added a commit
to jfbu/matplotlib
that referenced
this pull request
Nov 30, 2019
Already sphinx>=1.8.1 is a requirement, and 'maxlistdepth' is available since Sphinx 1.5. This commit also suppresses usage of LaTeX expdlist package as it breaks PDF builds with recent LaTeX (2019 at least). The April 2018 code at scipy/scipy#8657 which patched expdlist for other reasons appears to fix also this issue and could be added here. Also, this commit sets up XITS as main document font: usage of XITS achieves that the section documenting Mathtext does not report missing glyphs during the LaTeX build. Probably STIX2 would work too. (with DejaVu Serif, there were 134 unique Unicode glyphs needed by the PDF build and reported missing from the font). XITS font is available in LaTeX distributions of recent years. This commit was tested with Sphinx v1.8.5 and Sphinx v2.2.1. (and using current TeXLive TeX distribution)
6 tasks
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This builds upon #8654 (else reduced left margin reveals another bug of LaTeX package
expdlist, as explained here).The goal is to get deeply nested lists less likely to overflow in right margin. We only reduce slightly from
60ptto50ptthe indentation, except for top level descriptions (whose items are labeledParametersetc...) which is set with15ptindentation.Additionally, only those items are in bold italic; the parameters are in bold, not italic.
Relates to #8655 (see screenshots there for worst-case scenarii)