asciidoctor-pdf with complex tables

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
5 messages Options
Reply | Threaded
Open this post in threaded view
|

asciidoctor-pdf with complex tables

Elisa
I need to know what kinds of tables are possible with the latest asciidoctor-pdf because for me the pdf output is the most important.

I found some documentation of tables that are possible with "version 8.3.0" at https://asciidoc.org/newtables.html.

Needless to say, some of the tables don't work, and I'd like to know what table formats are available for use with the pdf output that is currently possible.

For the asciidoctor-pdf, I am running ruby 2.7.2p137 (2020-10-01 revision 5445e04352) [x86_64-darwin18], in order to enable the asciidoctor-pdf.

Output for AsciiDoc --version:

Asciidoctor 2.0.12 [https://asciidoctor.org]
Runtime Environment (ruby 2.7.2p137 (2020-10-01 revision 5445e04352) [x86_64-darwin18]) (lc:UTF-8 fs:UTF-8 in:UTF-8 ex:UTF-8)

When I run gem update on asciidoctor-pdf, I get a response that the latest gem is installed.

I do see that there is work being done on generating pdf output in other ways, however, it appears that footnotes, running headers and footers, fully functional TOCs and other refinements for publishing are not yet available through other pdf generators.

 
Reply | Threaded
Open this post in threaded view
|

Re: asciidoctor-pdf with complex tables

abelsromero
Elisa wrote
I found some documentation of tables that are possible with "version 8.3.0" at https://asciidoc.org/newtables.html.
Beware that's the old python implementation.
For context Asciidoctor was created as an alternative/compatible implementation that ended up being more actively mantained.

For the latest Asciidoctor docs on tables https://docs.asciidoctor.org/asciidoc/latest/tables/build-a-basic-table/. The search option at the top should help you find what you want.

EDIT: see the menu section about "Tables" on the left also
Reply | Threaded
Open this post in threaded view
|

Re: asciidoctor-pdf with complex tables

Elisa
Ah, thanks. It was just dawning on me that I've been looking at the wrong AsciiDoc documentation. :-)

Not certain how it was that I began to pull up older documentation, but now I know to check whether it's python or ruby.

Thanks!!!

Reply | Threaded
Open this post in threaded view
|

Re: asciidoctor-pdf with complex tables

abelsromero
To be fair, we've all been there. Separating the language, from the processors is not obvious but we try our best.
We hope this would improve in the comming year with the language standardization effort (https://projects.eclipse.org/proposals/asciidoc-language).

Said that, again, if you struggle with anything just open a thread.
Reply | Threaded
Open this post in threaded view
|

Re: asciidoctor-pdf with complex tables

mojavelinux
Administrator
As far as I know, Asciidoctor PDF supports all the features of tables that are supported by other converters. There are some quirks that have to do with the fact that it's a fixed-width layout, such as a table cell cannot exceed the height of a single page, but that has more to do with the PDF generation process than the converter.

If you find something that doesn't work as you expect, feel free to file an issue here: https://github.com/asciidoctor/asciidoctor-pdf/issues and I'll look into it.

Best Regards,

-Dan

--
Dan Allen (he, him, his) | @mojavelinux | https://twitter.com/mojavelinux