Changes between Version 7 and Version 8 of DeveloperGuidelines/Templates

Timestamp:

06/23/12 14:53:00 (12 years ago)

Author:

Fran Boon

Comment:

--

DeveloperGuidelines/Templates

@@ -9 +9 @@
 This helps prevent merge conflicts between different deployment branches & hence reduces the risk of forking.
 
-== Design ==
+== Description ==
 Configuration is done using these files:
-* /private/templates/000_config.py
-* /private/templates/default/config.py
-* /private/templates/<template>/config.py
+* {{{/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/
+During the 1st run, {{{000_config.py}}} is copied to {{{models/}}}
 
-000_config.py includes:
-* FINISHED_EDITING_CONFIG_FILE
-* VERSION
+{{{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
+* importing of settings from {{{/private/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):
+An empty database isn't terribly useful - e.g. maps won't display at all.
+
+Options for how to Prepopulate the database are defined in the template's {{{config.py}}} (but can be overridden in the running {{{000_config.py}}}):
+* {{{settings.base.prepopulate = ["default"]}}}
 * DeveloperGuidelines/PrePopulate
 
+== Menus ==
+If you need to tweak your menus of build completely new ones:
+* DeveloperGuidelines/Menus
+
 == Theme ==
-DeveloperGuidelines/Themes
+It is possible to develop a custom theme for the look & feel of your system:
+* 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
+== Custom Pages ==
+If you wish to add a new custom page without creating a new module:
+* DeveloperGuidelines/CustomPages
 
 == References ==
 * BluePrint/Templates
-* PrePopulate
+* DeveloperGuidelines/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]
 
 ----