SMPTE / html-pub

Tools for publishing SMPTE documents as HTML documents
BSD 3-Clause "New" or "Revised" License
1 stars 0 forks source link

Various Locations (PDF Only): Pagination #253

Open ERyan71258 opened 6 months ago

ERyan71258 commented 6 months ago

The following pagination adjustments should be made:

SteveLLamb commented 3 months ago

Going to move this over to HTML-pub, but I am seeing the various rules. Please correct where needed @ERyan71258:

Past that, all the mention of moving headers above also involves moving prose as well. Is there a min line count you would prefer?

Also, this ties into https://github.com/SMPTE/html-pub/issues/107

ERyan71258 commented 3 months ago

While it is nice to fill more than half a page, sometimes it just doesn't happen. I would rather see headers connected to their text, and logical breaks in text (for example, tables self-contained on one page where possible; introductions to formulae, tables or figures directly above said formulae, tables or figures), than a mandate to fill up a page.

Additionally, in an ideal world, when presenting a complex, multi-column table or complex figure, I would like the ability to click to open a larger version. In the Word world, I use landscape-oriented pages to provide more room for tables or to enlarge images.

SteveLLamb commented 3 months ago

Can we start with the following 2 rules, which will disallow page breaks in these cases:

Then if we add in controls for allowing editor defined page breaks, we can get the control you want manually, as I don't see a great way to automate that. This would be 2 seperate things at that point.

ERyan71258 commented 3 months ago

Yes, I am good with that.

Another item to add, would be the ability to set a paragraph as "Keep with Next" when generated to a PDF. I have kept sets of paragraphs together using KWN.

I designed the following into the Word template:

I would also like to see better table handling in the PDF generation. Headers do not repeat across pages. Table and column widths change across tables. Occasionally table rows are simply cut off. Table rows should not, except in rare occasions (e.g., if a cell contains man lines of code), split across pages.

SteveLLamb commented 3 months ago

Great. Marking this as a duplicate for tracking (since I referenced it in other documents), and these have been broken out in 2 seperate issues: