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