= Templates =
[[TOC]]

== Introduction ==
Templates allow selecting alternate configuration sets.

This allows a separation between Core Code & !Settings/Custom Code.

This helps prevent merge conflicts between different deployment branches & hence reduces the risk of forking.

== Design ==
Configuration is done using these files:
* /private/templates/000_config.py
* /private/templates/default/config.py
* /private/templates/<template>/config.py

During 1st_run, 000_config.py is copied to models/

000_config.py includes:
* FINISHED_EDITING_CONFIG_FILE
* VERSION
* machine-specific configuration (Debug, Database, SMTP, API Keys, etc)
* a setting to define which template folder to run
* importing of settings from templates/<template>/config.py
* optional local overrides to the template's settings

== Prepopulate Data ==
Prepopulate options are defined in the template's config.py (but can be overridden in the running 000_config.py):
* DeveloperGuidelines/PrePopulate

== Theme ==
DeveloperGuidelines/Themes

=== !ToDo ===
* controllers/default.py index()
 * Make a controller which can create arbitrary pages based on args &/or vars
* modules/eden/layouts.py & modules/eden/menus.py

== References ==
* BluePrint/Templates
* PrePopulate
* BluePrint/WebSetup
* [https://groups.google.com/d/topic/sahana-eden/Vy8xT4bA_pA/discussion Profile Layer]
* [https://groups.google.com/d/topic/sahana-eden/TadDloKhqkg/discussion Profile Templates Plan]
* [https://groups.google.com/d/topic/sahana-eden/YzgzXpTQjt8/discussion Splitting up CSS into separate files]

----
DeveloperGuidelines