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

Big empty spaces in some pages of the manual #890

Open
hmslima opened this issue Jun 25, 2020 · 1 comment
Open

Big empty spaces in some pages of the manual #890

hmslima opened this issue Jun 25, 2020 · 1 comment
Labels
documentation Documentation bug or improvement issue

Comments

@hmslima
Copy link

hmslima commented Jun 25, 2020

I saw the manual (version v0.10.4) and I noticed some problems. Some of them already were reported (#860/#859), but I didn't see anyone commenting about these empty spaces in the manual (if someone already did, I am sorry for doing this duplicated report).

In the page 20 of the PDF (labeled as page 15 by the document), the code (this one <font family="Times" size="10pt">Hi there!</font>) jumps for the next page while there is plenty of space left in the previous page.


Another problem, that is related to empty pages, is with new chapters. I know that when you make a chapter...

\chapter{New Chapter}

..., this title will appear in a new page; that's nice! But this new title leaves an empty page behind it or not?

Chapters that are preceded by an empty page: 1 (What is SILE?), 4 (Some Useful SILE Commands), 5 (SILE Packages), 6 (SILE Macros and Commands), 8 (The Nitty Gritty), 11 (Further Tricks)
Chapters that are NOT preceded by an empty page: 2 (Getting Started), 3 (SILE’s Input Language), 7 (SILE Settings), 9 (Designing Basic Class Files), 10 (Advanced Class Files 1: SILE As An XML Processor)

There should be some consistency in this point. Particularly I find horrendous these empty pages behind the new chapters, perhaps with the exception of the first chapter only because it's preceded by the Table of Contents.

@alerque
Copy link
Member

alerque commented Jun 25, 2020

Your first point looks like a problem to me, thanks for reporting.

Your second point has to do with odd/even page numbering. Chapters always begin on odd pages. This is quite typical for printed / bound material because it makes chapters easier to find (in LTR languages). For screen reading this doesn't make much sense, but we are not yet generating different PDFs of the manual optimized for screen vs. print. Since the output of SILE is quite commonly used in print work, I feel the convention is appropriate to use in the manual for now.

@alerque alerque added the documentation Documentation bug or improvement issue label Jun 25, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Documentation bug or improvement issue
Projects
None yet
Development

No branches or pull requests

2 participants