Asciidoc has the ability to include other files: http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#include-files. The import tool needs to be updated to resolve these external references.
+1 The JBDS User Guide is split over 8? adoc files and there is one adoc file that references them all as a kind of spec I suppose.
Asciidoctor has a include test file: https://github.com/asciidoctor/asciidoctor/blob/master/test/fixtures/parent-include.adoc
Created attachment 906661 [details] Asciidoc include test
Note that it is currently possible for Asciidoctor to generate invalid DocBook if the source Asciidoc doesn't have the correct structure. The parent-include file is an example of this, and it has been logged as a bug at https://github.com/asciidoctor/asciidoctor/issues/971. The attached file has the correct structure to generate chapters.
Created attachment 906678 [details] Asciidoc include test Tests including files and images from the current and subdirectories. Also tests includes in comments and invalid includes.
Another asciidoctor bug: https://github.com/asciidoctor/asciidoctor/issues/972
Created attachment 907441 [details] Asciidoc include test
https://github.com/jbosstools/jbosstools-documentation/blob/master/userguide/src/main/asciidoc/readme.adoc is a good test for this, as it pulls in a number of images and external files. Note that the :imagesdir: ./images setting at the top of readme.adoc needs to be removed, as the images already reference the images directory. Also the <div> text in the image alt text in mobile_web_tools.adoc (line 259) will have to be removed because of https://github.com/asciidoctor/asciidoctor/issues/972.
Fixed in Build 1.7-SNAPSHOT 201406110831
The file list shows files it shouldn't. See: https://bugzilla.redhat.com/show_bug.cgi?id=1091570#c7 https://bugzilla.redhat.com/show_bug.cgi?id=1091570#c8
The file list should probably be sorted as well, so that it's easier to find the file you are looking for. Verified for everything else I could think to test, taking into account the points Matt has noted.
Sorting added in Build 1.7-SNAPSHOT 201406171006
Common image files are filtered out in Build 1.7-SNAPSHOT 201406171026
Verified that images and directories are no longer included in the list and that it is alphabetically sorted.