Hi there: I am evaluating AsciiDoc for my documentation needs.
The one thing that bothers me most often with Microsoft Word or LibreOffice Writer is that paragraphs or tables are not kept together when generating a PDF or printing. Not everyone can always read the docs on a screen. It looks unprofessional when a page break comes at the wrong time. I haven't learnt too much about AsciiDoc yet, but support for keeping paragraphs together does not seem quite right yet. I found this on the Internet: "You can apply the unbreakable option globally to all block elements by defining the unbreakable-option attribute in your document header." But I could not find a practical example with paragraphs or with a table or item list. I found this from tool AsciiDoctor: "I also want to mention that there's a block role in AsciiDoc called "keep-together" that was designed to control this sort of thing. We don't currently honor that role, but we could." I also saw this comment: "You said you tried the FOP backend, did you try using the dblatex backend, it converts docbook to latex and therefore (theoretically) can make use of that expertise." I also saw that Asciidoc-pdf does support some "keep-together" option, but does not document exactly how to use it. There is also some way I found to manually trigger a page break for PDF output only: Page break only in PDFs: ifdef::backend-pdf[<<<] This is all rather vague and inconsistent (keep-together/unbreakable). Is there a clean way to mark some content as "keep together", so that it works no matter what output format I want? The marketing and sales guys do not like bad-looking documentation. I must say, abrupt page breaks do look unprofessional. It is a shame, but this detail is serious enough that it currently prevents my switching to AsciiDoc. Thanks in advance, rdiez -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/asciidoc. For more options, visit https://groups.google.com/d/optout.
