Skip to content

Infra: Improve print style #3486

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.

Sign up for GitHub

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

Jump to bottom
Merged
hugovk merged 4 commits into from
Nov 14, 2023
Merged

Infra: Improve print style #3486

hugovk merged 4 commits into from
Nov 14, 2023

Conversation

@srittau
Copy link
Contributor

@srittau srittau commented Oct 13, 2023 •
edited
Loading

  • 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
Copy link
Contributor Author

srittau commented Oct 13, 2023 •
edited
Loading

(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
Copy link
Member

AA-Turner commented Oct 13, 2023

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

A

@srittau
Copy link
Contributor Author

srittau commented Oct 13, 2023 •
edited
Loading

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
@hugovk
Copy link
Member

hugovk commented Oct 18, 2023

These look great!

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

@srittau
Copy link
Contributor Author

srittau commented Oct 18, 2023

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
Copy link
Contributor Author

srittau commented Oct 18, 2023

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
Copy link
Contributor Author

srittau commented Oct 18, 2023

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
Copy link
Contributor Author

srittau commented Oct 18, 2023

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
Copy link
Member

hugovk commented Nov 14, 2023

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