pandoc does not honor the AsciiDoc page breaks or include::[] macros

[todd-a-jacobs]

AsciiDoc defines <<< as a page break, but does not recognize the resulting DocBook markup of <simpara><?asciidoc-pagebreak?></simpara>. The DocBook XML is a necessary intermediate step for master documents that contain subdocuments, since pandoc doesn't (yet?) honor the include::[] macro for combining separate documents, either.

Running pandoc on a master document results in a bulleted list of include statements. Running pandoc on AsciiDoc -> DocBook output results in the page breaks simply being ignored.

[mpickering]

There is nowhere in the pandoc AST for page breaks unfortunately. There are also technical limitations with macros such as include::[]. It is better to handle that with a preprocessor and feed pandoc the complete document.

[tarikgraba]

@jgm In relation with #1934 can <?asciidoc-pagebreak?> support added to the DocBook reader?

[jgm]

You might add a note to #1934 about <?asciidoc-pagebreak?> if it's not there already.