Changes between Version 7 and Version 8 of DeveloperGuidelines/Templates


Ignore:
Timestamp:
06/23/12 14:53:00 (9 years ago)
Author:
Fran Boon
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • DeveloperGuidelines/Templates

    v7 v8  
    99This helps prevent merge conflicts between different deployment branches & hence reduces the risk of forking.
    1010
    11 == Design ==
     11== Description ==
    1212Configuration is done using these files:
    13 * /private/templates/000_config.py
    14 * /private/templates/default/config.py
    15 * /private/templates/<template>/config.py
     13* {{{/private/templates/000_config.py}}}
     14* {{{/private/templates/default/config.py}}}
     15* {{{/private/templates/<template>/config.py}}}
    1616
    17 During 1st_run, 000_config.py is copied to models/
     17During the 1st run, {{{000_config.py}}} is copied to {{{models/}}}
    1818
    19 000_config.py includes:
    20 * FINISHED_EDITING_CONFIG_FILE
    21 * VERSION
     19{{{000_config.py}}} includes:
     20* {{{FINISHED_EDITING_CONFIG_FILE}}}
     21* {{{VERSION}}}
    2222* machine-specific configuration (Debug, Database, SMTP, API Keys, etc)
    2323* a setting to define which template folder to run
    24 * importing of settings from templates/<template>/config.py
     24* importing of settings from {{{/private/templates/<template>/config.py}}}
    2525* optional local overrides to the template's settings
    2626
    2727== Prepopulate Data ==
    28 Prepopulate options are defined in the template's config.py (but can be overridden in the running 000_config.py):
     28An empty database isn't terribly useful - e.g. maps won't display at all.
     29
     30Options for how to Prepopulate the database are defined in the template's {{{config.py}}} (but can be overridden in the running {{{000_config.py}}}):
     31* {{{settings.base.prepopulate = ["default"]}}}
    2932* DeveloperGuidelines/PrePopulate
    3033
     34== Menus ==
     35If you need to tweak your menus of build completely new ones:
     36* DeveloperGuidelines/Menus
     37
    3138== Theme ==
    32 DeveloperGuidelines/Themes
     39It is possible to develop a custom theme for the look & feel of your system:
     40* DeveloperGuidelines/Themes
    3341
    34 === !ToDo ===
    35 * controllers/default.py index()
    36  * Make a controller which can create arbitrary pages based on args &/or vars
    37 * modules/eden/layouts.py & modules/eden/menus.py
     42== Custom Pages ==
     43If you wish to add a new custom page without creating a new module:
     44* DeveloperGuidelines/CustomPages
    3845
    3946== References ==
    4047* BluePrint/Templates
    41 * PrePopulate
     48* DeveloperGuidelines/PrePopulate
    4249* BluePrint/WebSetup
    43 * [https://groups.google.com/d/topic/sahana-eden/Vy8xT4bA_pA/discussion Profile Layer]
    44 * [https://groups.google.com/d/topic/sahana-eden/TadDloKhqkg/discussion Profile Templates Plan]
    45 * [https://groups.google.com/d/topic/sahana-eden/YzgzXpTQjt8/discussion Splitting up CSS into separate files]
    4650
    4751----