Summary

Docaroo provide multiple options to configure the the site functionality and appearance. The configurations can be made in _config.yml and in the configuration files placed in _data folder. As a general rule, each time when a configuration is changed, it is necessary to re-build the site to make the configuration effective (if the site is running in test mode, it is necessary to stop it and serve it again).

Docaroo configurations are of two categories:

necessary at build time
necessary at run time

The configuration files are named in an intuitive way to make a clear distinction on what is necessary at build time and what is necessary to be passed to the browser to be used at run time.

Config files

Except for _config.yml, Docaroo configuration files are located in _data folder:

📁 _data/
├── 📄 buildConfig.yml
├── 📄 pageBuildConfig.yml
├── 📄 pageConfig.yml
└── 📄 siteConfig.yml

Show

File	Location	Description
_config.yml	Root	Regular Jekyll configuration file
siteConfig.yml	_data	Site configuration and settings needed at run time
buildConfig.yml	_data	Site configurations and settings needed at build time
pageConfig.yml	_data	Individual page settings needed at run time
pageBuildConfig.yml	_data	Individual page settings needed at bulid time