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.

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

Infra: Improve print style #3486

Merged
merged 4 commits into from
Nov 14, 2023
Merged

Infra: Improve print style #3486

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
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

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.

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

hugovk commented Nov 14, 2023

Thank you! 🖨️📃📃📃

@JelleZijlstra JelleZijlstra deleted the print-css branch November 14, 2023 18:57
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