ggrossetie / asciidoctor-web-pdf

Convert AsciiDoc documents to PDF using web technologies
https://asciidoctor.org
MIT License
449 stars 92 forks source link

Missing lines at bottom of page in arrays that span several pages. #618

Open erch opened 2 years ago

erch commented 2 years ago

I'm experiencing an issue with missing lines at the page junctions for arrays that span several pages.

I have attached an example of a document that contains an array with 200 lines and with the first column that contains the line number.

In the resulting test.pdf obtained by running asciidoctor-web-pdf test.adoc you can see that starting at the line 55 there is one line missing at each end of page.

This issue happens as well as on Linux and Widows 10.

test.zip

This is a blocking issue for us and we would appreciate your help to solve the problem.

Eric

erch commented 2 years ago

I forgot to mention that if I suppress the header options there is no missing line.

EDIT: after more testing this is not true, I did a test with an array that had more lines and it appears that it had a missing line at a page junction.

ggrossetie commented 2 years ago

I'm experiencing an issue with missing lines at the page junctions for arrays that span several pages.

Do you mean tables? If so, this is a known limitation of Paged.js (the underlying engine we are using to paginate content).

This is a complex issue but some work should be included in Paged.js 1.0: https://gitlab.pagedmedia.org/tools/pagedjs/-/issues/332 (no official release date).

The current workaround is to manually break large tables into smaller tables that fit on one page.

erch commented 2 years ago

You I meant table. The issue happens even on small tables, so it is not possible to know how to split the tables. It would be fair to put a warning in the documentation about this issue because it is not reliable to build a document with table with the current version. I hope that Paged.js will quickly solve their problem.

ggrossetie commented 2 years ago

The issue happens even on small tables, so it is not possible to know how to split the tables.

You should open a new issue at https://gitlab.coko.foundation/pagedjs/pagedjs/-/issues with your "small tables". The underlying issue might be easier to fix.

It would be fair to put a warning in the documentation about this issue because it is not reliable to build a document with table with the current version.

Feel free to submit a pull request to add a mention in the README.

I hope that Paged.js will quickly solve their problem.

🙏🏻