Skip to content

Infra: Improve print style#3486

Merged
hugovk merged 4 commits into
python:mainfrom
srittau:print-css
Nov 14, 2023
Merged

Infra: Improve print style#3486
hugovk merged 4 commits into
python:mainfrom
srittau:print-css

Conversation

@srittau

@srittau srittau commented Oct 13, 2023 •
edited
Loading

Copy link
Copy Markdown
Contributor
  • Remove header.
  • Remove TOC sidebar.
  • Remove TOC header if closed.
  • Use appropriate page margins and max-width.
  • Remove underlines from links and abbreviations.
  • Use more compact headings.

Closes: #3480

📚 Documentation preview 📚: https://pep-previews--3486.org.readthedocs.build/

@srittau
Improve print style
fe9b884 
* Remove header.
* Remove TOC sidebar.
* Remove sidebar header if closed.
* Use appropriate page margins and max-width.
* Remove underlines from links and abbreviations.
* Use more compact headings.
@srittau srittau requested a review from AA-Turner as a code owner October 13, 2023 15:05
@srittau

srittau commented Oct 13, 2023 •
edited
Loading

Copy link
Copy Markdown
Contributor Author

(Not to scale)

A4

image
image

A5

image

Letter

image

Legal

image

@hugovk hugovk changed the title [rendering] Improve print style Infra: Improve print style Oct 13, 2023
@hugovk hugovk added the infra Core infrastructure for building and rendering PEPs label Oct 13, 2023
@AA-Turner

AA-Turner commented Oct 13, 2023

Copy link
Copy Markdown
Member

For printed media, would it be better to use a serif typeface?

A

@srittau

srittau commented Oct 13, 2023 •
edited
Loading

Copy link
Copy Markdown
Contributor Author

Using Times New Roman:

image

I just printed it to see it on paper, and honestly, I'm not a huge fan. Possibly with a slightly lower line height.

Edit: But I can change it if you prefer.

srittau
srittau commented Oct 13, 2023
View reviewed changes
Comment thread pep_sphinx_extensions/pep_theme/static/mq.css
@hugovk

hugovk commented Oct 18, 2023

Copy link
Copy Markdown
Member

These look great!

It could be worth reducing the margins somewhat, as the PEPs can use a lot of pages?

@srittau

srittau commented Oct 18, 2023

Copy link
Copy Markdown
Contributor Author

I've used slightly smaller margins using DIN 5008 (German standard for letters) as a guideline. The 2.5 cm margin on one side of the page allows for punched holes for ring binders etc.

@srittau

srittau commented Oct 18, 2023

Copy link
Copy Markdown
Contributor Author

Alternating margins would only work for double-sided printing. I'll try 2cm margins on both sides and see if there's still enough space.

@srittau

srittau commented Oct 18, 2023

Copy link
Copy Markdown
Contributor Author

Using 2cm margins on the sides is unfortunately too tight for punched holes when using the "Schnellhefter" (folder) used here in Germany. Therefore, I'd recommend leaving the 2.5cm side margins.

@srittau

srittau commented Oct 18, 2023

Copy link
Copy Markdown
Contributor Author

A typical A4 page with 2.5cm side and 2cm top/bottom margins:

a4

@hugovk hugovk merged commit 6643c37 into python:main Nov 14, 2023
@hugovk

hugovk commented Nov 14, 2023

Copy link
Copy Markdown
Member

Thank you! 🖨️📃📃📃

@JelleZijlstra JelleZijlstra deleted the print-css branch November 14, 2023 18:57
@hugovk hugovk mentioned this pull request Dec 11, 2025
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@hugovk hugovk hugovk approved these changes
@AA-Turner AA-Turner Awaiting requested review from AA-Turner AA-Turner is a code owner

Assignees

No one assigned

Labels

infra Core infrastructure for building and rendering PEPs

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Print stylesheet

3 participants

@srittau @AA-Turner @hugovk