Bug#1062983: Developers Reference in A4 instead of US Letter
On Mon, Feb 05, 2024 at 10:23:39AM +, Holger Levsen wrote: > On Mon, Feb 05, 2024 at 11:00:42AM +0800, Paul Wise wrote: > > > I think for English at least I'd prefer to offer both A4 and letter, for > > > eg > > > the German translation I think it's enough to only provide A4. > > Looks like that info can be gotten from the locales on glibc systems: > [...] > > nice, thanks. > > > For languages with one translation instead of one per dialect, > > you could produce documents in each of the unique sizes. > > I don't understand, what do you mean with "one per dialect" here? I assume dialect means pt_PT vs pt_BR. Each locale can have a different page size even if the translation is the same. Cheers, -- Bill. Imagine a large red swirl here.
Bug#1062983: Developers Reference in A4 instead of US Letter
On Mon, Feb 05, 2024 at 11:00:42AM +0800, Paul Wise wrote: > > I think for English at least I'd prefer to offer both A4 and letter, for eg > > the German translation I think it's enough to only provide A4. > Looks like that info can be gotten from the locales on glibc systems: [...] nice, thanks. > For languages with one translation instead of one per dialect, > you could produce documents in each of the unique sizes. I don't understand, what do you mean with "one per dialect" here? -- cheers, Holger ⢀⣴⠾⠻⢶⣦⠀ ⣾⠁⢠⠒⠀⣿⡁ holger@(debian|reproducible-builds|layer-acht).org ⢿⡄⠘⠷⠚⠋⠀ OpenPGP: B8BF54137B09D35CF026FE9D 091AB856069AAA1C ⠈⠳⣄ Cholera is over. It's safe to put sewage in our drinking water again. (@stimmyskye) signature.asc Description: PGP signature
Bug#1062983: Developers Reference in A4 instead of US Letter
On Sun, 2024-02-04 at 19:25 +, Holger Levsen wrote: > I think for English at least I'd prefer to offer both A4 and letter, for eg > the German translation I think it's enough to only provide A4. Looks like that info can be gotten from the locales on glibc systems: $ LANG=en_AU.utf8 locale -k LC_PAPER height=297 width=210 paper-codeset="UTF-8" $ LANG=en_US.utf8 locale -k LC_PAPER height=279 width=216 paper-codeset="UTF-8" For languages with one translation instead of one per dialect, you could produce documents in each of the unique sizes. Seems like this is a GNU extension to POSIX though: https://manpages.debian.org/bookworm/manpages/locale.5.en.html#Locale_category_sections https://manpages.debian.org/bookworm/manpages/locale.5.en.html#LC_PAPER https://manpages.debian.org/bookworm/manpages/locale.7.en.html#LC_PAPER -- bye, pabs https://wiki.debian.org/PaulWise signature.asc Description: This is a digitally signed message part
Bug#1062983: Developers Reference in A4 instead of US Letter
hi & thanks for filing this bug report! On Sun, Feb 04, 2024 at 10:57:03AM +0100, Sebastian Geiger (Lanoxx) wrote: > May I request, that: > > a) We switch to A4 as the default format for the developers-reference > since that is the format used by most of the world. > b) We consider offering both formats on the Debian manuals page, so that > users can choose their preferred format. I think for English at least I'd prefer to offer both A4 and letter, for eg the German translation I think it's enough to only provide A4. -- cheers, Holger ⢀⣴⠾⠻⢶⣦⠀ ⣾⠁⢠⠒⠀⣿⡁ holger@(debian|reproducible-builds|layer-acht).org ⢿⡄⠘⠷⠚⠋⠀ OpenPGP: B8BF54137B09D35CF026FE9D 091AB856069AAA1C ⠈⠳⣄ "I like beautiful people. I don't care about their looks." signature.asc Description: PGP signature
Bug#1062983: Developers Reference in A4 instead of US Letter
Package: developers-reference Version: 13.4 I just downloaded the developers-reference from https://www.debian.org/doc/devel-manuals and I noticed that it is being formatted in US Letter. While this may be the preferred format for US users, the rest of the world is using A4 sized pages. I am not sure if there is any recommendation in Debian to choose a paper size for documentation. I went over some common Debian user and developer manuals and noticed that there is a mix of paper sized, but the A4 format seems to be most common: * https://www.debian.org/doc/manuals/debian-faq/debian-faq.en.pdf (A4) * https://www.debian.org/doc/manuals/refcard/refcard.en.pdf (A4) * https://www.debian.org/doc/manuals/debian-reference/debian-reference.en.pdf (A4) * https://www.debian.org/doc/manuals/hamradio-maintguide/hamradio-maintguide.en.pdf (letter) * https://www.debian.org/doc/debian-policy/policy.pdf (letter) * https://www.debian.org/doc/manuals/debmake-doc/debmake-doc.en.pdf (A4) * https://www.debian.org/doc/manuals/maint-guide/maint-guide.en.pdf (A4) May I request, that: a) We switch to A4 as the default format for the developers-reference since that is the format used by most of the world. b) We consider offering both formats on the Debian manuals page, so that users can choose their preferred format. In general it would be nice to have a consistent solution for all documents. I often like to print the manuals and then its a bit odd to see the large US letter margins on an A4 page. Given that all PDFs are build automated pipelines, its probably possible that we automatically build both formats and introduce a general mechanism on https://www.debian.org/doc/ that allows users to choose their preferred format? Kind Regards Sebastian Geiger