Configuration

collections

Takes a dictionary, which configures the Collections.

collections = {
  'my_files': {
     'driver': 'copy',
     'source': '../../extra_files/'
  }
}

See Collections for details.

Default: {}

collections_target

Defines the default storage location for all collections.

If a relative path is set, this path is relative to the documentation folder (the one which contains your conf.py).

Can be set individually for each collection by using target.

Default: _collections

collections_clean

If True all configured target locations get wiped out at the beginning.

The related driver of the collection decides, if and clean is needed and how it must be performed.

If you use nested collections, e.g _collections/collection_A/collection_B the outer clean routine of a collection (here collection_A) deletes also the content of other collections (here collection_B).

Can be overwritten for each collection be setting clean.

Default: True

collections_final_clean

If True all collections start their clean-up routine after a Sphinx build is done. Normally It doesn’t matter if the build was an success or stopped.

Works similar to collections_clean, but at the end of the build instead before.

Can be overwritten for each collection be setting final_clean.

This final clean up is normally active to keep your working tree clean and get no unnecessary files into git or any other solution.

Default: True