Bug 8186 - PDF documentation has very long lines
Summary: PDF documentation has very long lines
Status: NEW
Alias: None
Product: ThinLinc
Classification: Unclassified
Component: Documentation (show other bugs)
Version: trunk
Hardware: PC Unknown
: P2 Normal
Target Milestone: LowPrio
Assignee: Bugzilla mail exporter
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2023-07-10 15:54 CEST by Pierre Ossman
Modified: 2023-07-11 13:57 CEST (History)
0 users

See Also:
Acceptance Criteria:


Attachments

Description Pierre Ossman cendio 2023-07-10 15:54:03 CEST
The default font size in rst2pdf is just 10pt. This results in very long lines, that can be very difficult to read. The common¹ acceptable range is 45-75 characters, with 66 being the optimum. The PDF currently has around 100 characters.

Changing this is unfortunately a lot of work, as many things in rst2pdf's styles don't automatically follow the font size.

¹ https://en.wikipedia.org/wiki/Line_length
Comment 1 Pierre Ossman cendio 2023-07-10 15:55:30 CEST
Since this is about readability, it might be worth also changing from justified text to left aligned.
Comment 2 Pierre Ossman cendio 2023-07-11 13:57:54 CEST
For reference, our DocBook-based PDF had similar line length. It had left aligned lines, though, not justified.

Note You need to log in before you can comment on or make changes to this bug.