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

Use A4 as the default page size (pdf-page-size) #319

Closed
fwilhe opened this issue Sep 13, 2015 · 6 comments
Closed

Use A4 as the default page size (pdf-page-size) #319

fwilhe opened this issue Sep 13, 2015 · 6 comments
Assignees

Comments

@fwilhe
Copy link
Contributor

fwilhe commented Sep 13, 2015

Hello,

the current default pdf-page-size is US Letter. Most of the world uses the A format (most commonly A4). I would like to discuss, if we could introduce this as the default format in asciidoctor-pdf.

Of course, one format has to be the default, and everyone prefers the one that she uses on a daily bases. I think going for the ISO standard is a reasonable choice.

Also, the property that the A format scales nicely to bigger and smaller sheets (two A5 sheets being exactly one A4, etc, due to the aspect ratio) makes it superior format (in my completely biased point of view, at least).

Any thoughts on that?

@orloffm
Copy link

orloffm commented Sep 13, 2015

...and also the default font color isn't black, so it appears gray on Kindles. And font is quite small for A4. Etc, etc.

So just create your own style and have by your document.

@mojavelinux
Copy link
Member

Most of the PDF writers I've seen use A4 by default, so it's clear that we should align with this default. We will need to check the fonts when we make this change to make sure they are properly sized (thanks for mentioning that @orloffm).

It's very likely that the Letter page size is a requirement that got inadvertently carried over from the contract for which we originally created Asciidoctor PDF. For general purpose, I think it's clear that A4 should be the default.

@mojavelinux mojavelinux added this to the v1.5.0.beta.1 milestone Sep 13, 2015
@mojavelinux mojavelinux self-assigned this Sep 13, 2015
@mojavelinux
Copy link
Member

so it appears gray on Kindles

I'm assuming you mean a grayscale Kindle? If so, it's unfortunate that Kindle doesn't properly shade off-black text. It's well documented that slightly off-black text is better for readability on color screens (as it softens the otherwise stark contrast).

@orloffm
Copy link

orloffm commented Sep 13, 2015

Yes, I've got a Kindle DX. It has lower DPI then modern Kindles and the grayish text is blurry.

@mojavelinux
Copy link
Member

That's really odd that the Kindle DX applies the CSS even though it is a black and white device. However, there is a solution for this. CSS has a media query for color devices. We should move all colors in the stylesheet inside that media query so that the black and white devices only see black and white color settings.

See http://www.sitepoint.com/web-foundations/media-queries/#d5e1351

@mojavelinux
Copy link
Member

Oops, I was thinking we were talking about EPUB3. In the case of PDF, I'm not sure there is much we can do. Of course, you can use your own theme to set the text color in PDF.

stephenhay added a commit to stephenhay/asciidoctor-pdf that referenced this issue Dec 16, 2015
Resolves asciidoctor#319.

Visually confirmed in Evince: File > Properties.
stephenhay added a commit to stephenhay/asciidoctor-pdf that referenced this issue Dec 16, 2015
Resolves asciidoctor#319.

Visually confirmed in Evince: File > Properties.
@mojavelinux mojavelinux changed the title Default pdf-page-size Use A4 as the default page size (pdf-page-size) Aug 5, 2016
@mojavelinux mojavelinux removed the next label Aug 5, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants