« Blocks Additions and deprecations »
Elastic Docs ›Docs HOWTO ›Asciidoc Guide

Including files

edit

Including files

edit

For long documentation, you probably want to break up the Asciidoc files into smaller units, and just include them where appropriate:

include::myfolder/mydoc.asciidoc[]

Paths are relative to the file which contains the include statement.

Across repositories

edit

If you have to include files in a different repository then use its -root attribute to locate the files:

include::{elasticsearch-root}/docs/foo.asciidoc[]

Books that reference another repository should register that reference in conf.yaml.

  -
    repo:   elasticsearch
    path:   docs/foo.asciidoc

The path should be as specific as possible because we skip rebuilding books if changes to the referenced repository don’t change the referenced path.

« Blocks Additions and deprecations »