Skip to content

Support project specific configurations

Jump to bottom
Alexander Schwartz edited this page Nov 24, 2018 · 21 revisions
Warning
 This is an experimental feature. While it is experimental, names, conventions and functionality may change

There are usually specific settings for each project that apply to all Asciidoc sources: these might be the image directory or activating experimental options.

A file called .asciidoctorconfig will contain a snippet that will be pre-pended before rendering the asciidoctor file.

Sample content:

// .asciidoctorconfig
:experimental:
:icons: font

The handling will be a mixture of behaviors like .asciidoctorconfig and .gitconfig.

The order of processing will be as follows:

  1. load the .asciidoctorconfig file from the root of the project tree (most general configuration)

  2. load the .asciidoctorconfig files from the different directories leading to the specific file to be rendered

  3. load the .asciidoctorconfig file from current folder where the file to be rendered resides (most specific to the file opened)

  4. now prepend all the files found in the previous steps to the file to be rendered and render it in the preview.

Benefits of the solution: * project specific configuration is possible * hierarchical configuration is possible * you can use the asciidoc syntax you are familiar with (you can even use includes and other elements as well)

While this is currently only supported by the IntelliJ plugin, you can use Asciidoc’s include syntax to

Clone this wiki locally