Asciidoctor-pdf: Combine multiple *.adoc documents into a single PDF?

[kytrinyx]

Is it currently possible to combine multiple *.adoc documents (for example chapters in a book) into a single PDF?

If this is undocumented, but someone has working code, I'd be happy to work on turning that into documentation.

If not, I suppose it's a fairly trivial thing to write a build script that first combines the *.adoc files into a single file.

[chloerei]

Use include http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#include-files

[kytrinyx]

Ah, of course. Thank you.

[kytrinyx]

Is there a common idiom for the top-level document for a book?

[leif81]

@kytrinyx I've seen index.adoc used often.

e.g. https://github.com/spring-projects/spring-boot/blob/master/spring-boot-project/spring-boot-docs/src/main/asciidoc/index.adoc

[kytrinyx]

Thanks!

[fractalocity]

had the same exact question. This helped out a lot. Thanks for asking the question and for the chloerei answer.

[ostermannIAO]

@leif81 Link is not valid anymore.

Here an alternative:
https://github.com/Swagger2Markup/swagger2markup/edit/master/src/docs/asciidoc/index.adoc