Configuration

The project-specific configuration of the @PLUGIN@ plugin is done in the @PLUGIN@.config file in the refs/meta/config branch of the project.

  [web]
    indexFile = Documentation/README.md

The documentation links in web UI will link to this file.

Default: `README.md`

The global formatter configuration can be overridden per project. Configuring any parameter for a formatter overrides the complete global formatter configuration.

Multiple extensions may be specified for a formatter.

Overrides the [globally configured file extensions](#formatterExt)
for this formatter.

Multiple mime types may be specified for a formatter.

Overrides the [globally configured mime types](#formatterMimeType)
for this formatter.

Multiple prefixes may be specified for a formatter.

Overrides the [globally configured prefixes](#formatterPrefix)
for this formatter.

For some formatters a custom CSS file for the rendering can be provided in the refs/meta/config branch of the project:

• ASCIIDOCTOR: xdoc/asciidoctor.css
• MARKDOWN: xdoc/markdown.css

Custom CSS files are NOT inherited from parent projects.

The global configuration of the @PLUGIN@ plugin is done in the $site_path/etc/@PLUGIN@.config file.

The plugin contains an init step that creates the initial plugin configuration.

  [formatter "ASCIIDOCTOR"]
    ext = adoc
  [formatter "MARKDOWN"]
    mimeType = text/x-markdown
  [formatter "PLAIN_TEXT"]
    mimeType = text/plain

Supported formatters:

• ASCIIDOCTOR
• MARKDOWN
• PLAIN_TEXT

Multiple extensions may be specified for a formatter.

Can be overridden on [project-level](#ext).

Multiple mime types may be specified for a formatter.

Can be overridden on [project-level](#mimeType).

Multiple prefixes may be specified for a formatter.

Can be overridden on [project-level](#prefix).

If `false` inline HTML blocks as well as inline HTML tags are
suppressed. Both will be accepted in the input but not be contained
in the output.

When this option is changed the `xdocs-x_doc_resources` cache must
be flushed.

**WARNING:** Allowing HTML for user-provided input is a security
risk, e.g. code for XSS attacks may be contained in the HTML.

*CANNOT* be overridden on project-level.

Supported for the following formatters: `MARKDOWN`

Default: `false`

When a formatter is disabled the `xdocs-x_doc_resources` cache must
be flushed.

*CANNOT* be overridden on project-level.

Default: `true`

*CANNOT* be overridden on project-level.

Supported for the following formatters: `ASCIIDOCTOR`

Default: `true`