Comments (4)
Hi @tajmone, thanks for your comment. I agree it seems like a problematic feature, while I also agree it would be great for asciidoctor-multipage to support it if possible/practical since it is included in the Asciidoctor syntax. You're welcome to contribute some code or sponsor me here on GitHub if you'd like to see faster development (I too would like to have footnotes supported—issue #3).
from asciidoctor-multipage.
It doesn't seem like a good idea, but it allows the writer to put things like lists and other such things in a single table cell.
It's actually an extremely useful feature; even in simple tables its use is often required to enforce certain styles or to bypass some bugs and quirks with Asciidoctor's native HTML template.
It looks like Asciidoctor internally processes this type of cell as as a separate document.
Yes, and not without problems either. Advanced features have been problematic to handle (footnotes, Index entries, and other features relative to the global document), and a number of them have been buggy or inconsistent in their behaviour in the course of time. Various issues have been solved, but I'm not sure if it yet works 100% as expected.
The multipage extension currently breaks when it encounters this new document.
Its lack of support in asciidoctor-multipage is a major impediment in adopting this extension (along with no support for footnotes) for my projects, because in most documents where there are tables I end up using an a
cell or column (even if just to fix some quirky behaviour of the native template); so I really hope you'll eventually find a way to fix the problem.
But it's probably going to be a problematic challenge, as mentioned above, because an a
cell is effectively parsed as a sub-document of a kind, making it hard to trace references to the global document (notes, etc.). Also, since Asciidoctor supported nested tables, things could get rather ugly if you have an a
cell in a nested table.
from asciidoctor-multipage.
Thanks to @veselov for contributing a fix for this issue (#14).
If anyone notices any new problems related to nested documents, please open a new issue with details.
from asciidoctor-multipage.
Thanks @veselov! This was a major leap forward.
from asciidoctor-multipage.
Related Issues (20)
- Preamble affects included attributes HOT 2
- Error in multiparts documents when partnums attribute is specified HOT 1
- Use --out-file break the links to home HOT 1
- Custom `toclevels` / option to keep full TOC HOT 4
- Clarify usage of Cross-References HOT 2
- ToC generated inside block level (a) table cells with toc2 attr set on command line HOT 5
- Wrong numeration of appendix chapters HOT 4
- source highlight style does not extract to a file HOT 6
- Do not generate the configurate theme style file for Rouge highlighter HOT 2
- The tags which are in the section title are escaped HOT 1
- The appendix section number is wrong. HOT 4
- Variables not substituted in TOC HOT 3
- How do I prevent asciidoctor-multipage from resetting the latex equation counter after every HTML Page? HOT 3
- Error: "Failed to execute goal de.saumya.mojo:gem-maven-plugin" HOT 4
- Inheriting included attributes HOT 9
- wrong permissions on /var/lib/gems/3.0.0/gems/asciidoctor-multipage-0.0.16/bin/asciidoctor-multipage ? HOT 1
- Using output file name for first page (--out-file FILE is not supported) HOT 1
- Cannot disable stylesheets across all pages HOT 1
- Page title based on heading title HOT 4
- Rewrite some parts of extension, adding a Page class HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from asciidoctor-multipage.