Skip to content
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: avoid large voids sometimes occurring at page bottoms #12832

Merged
merged 2 commits into from
Aug 27, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions CHANGES.rst
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,8 @@ Bugs fixed
rise to nested ``\DUrole``'s, rather than a single one with comma separated
classes.
Patch by Jean-François B.
* #12831: LaTeX: avoid large voids sometimes occurring at page bottoms.
Patch by Jean-François B.
* #11970, #12551: singlehtml builder: make target URIs to be same-document
references in the sense of :rfc:`RFC 3986, §4.4 <3986#section-4.4>`,
e.g., ``index.html#foo`` becomes ``#foo``.
Expand Down
7 changes: 6 additions & 1 deletion sphinx/texinputs/sphinxlatexstyleheadings.sty
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,12 @@
\ProvidesPackage{sphinxlatexstyleheadings}[2023/02/11 headings]

\RequirePackage[nobottomtitles*]{titlesec}
% tests showed that this setting guarantees \section title has
% 3 lines of text following it on same page if near bottom.
\renewcommand\bottomtitlespace{6\baselineskip}
% the default setting of 0.2\textheight is about 11\baselineskip
% (for 10pt letterpaper documents) and may create large voids.

\@ifpackagelater{titlesec}{2016/03/15}%
{\@ifpackagelater{titlesec}{2016/03/21}%
{}%
Expand Down Expand Up @@ -47,7 +53,6 @@
\titleformat{\subparagraph}{\normalsize\py@HeaderFamily}%
{\py@TitleColor\thesubparagraph}{0.5em}{\py@TitleColor}


% Since Sphinx 1.5, users should use HeaderFamily key to 'sphinxsetup' rather
% than defining their own \py@HeaderFamily command (which is still possible).
% Memo: \py@HeaderFamily is also used by \maketitle as defined in
Expand Down