Version 76 (modified by 15 years ago) ( diff ) | ,
---|
Understand the Sahana mission
Before you start on the Sahana project, understand clearly what the project is about and what it strives to accomplish. You can find most of this in the Sahana Overview and objectives
Join the Community
Sahana is developed and guided by a large community of people from around the world, with diverse expertise. As everyone is in different timezones, the heart of this community is the mailing lists, so it is important for you to join it and actively participate in the discussion. Please join a suitable mailing list and we recommend you read the community mailing list etiquette. Apart that you can find a lot of us on #Sahana IRC Chat
Install a Development Environment
InstallationGuidelinesDeveloper
Python
Indentation matters (use 4 spaces instead of Tabs)
- http://diveintopython.org/
- http://openbookproject.net/thinkcs/python/english2e/
- Style Guide: http://www.python.org/dev/peps/pep-0008/
- lxml (XML I/O): http://codespeak.net/lxml/tutorial.html
Web2Py
This is an MVC environment (like Rails & Django. Django polls turorial conversion course).
Web2Py can work at several different levels of abstraction.
The SahanaPy framework (S3) is built on Web2Py's Auth/Crud classes in tools.py
(with some remnants of the older T2), however sometimes we need more control therefore need to drop down a level or two.
- http://web2py.com/examples/default/docs (recommend the 'New Cookbook' as well as the official Manual v2)
Recommend using the CLI to try out code snippets in the Web2Py environment (gluon, Model):
python web2py.py -S sahana -M
Model
Defines databases in: /models/module.py
The Models are loaded 1st within Web2Py processing, before the controllers.
So you can import any global modules/set any global variables here.
The Models are imported in alphabetical order, so we load the files which other modules depend on 1st, hence naming them appropriately:00_db.py
, 01_RESTlike_controller.py
, 02_pr.py
, 03_gis.py
Controller
Python functions in /controllers/module.py
e.g.
def list_records(): items=t2.itemize(table) return dict(items=items)
View
HTML/Javascript templates in /views/module/function.html
- these are normal HTML/JS files with the ability to add in Python code (e.g. variables) surrounded by brackets: {{ interpreted python here }}
- there should be an .html file available for each function in the module (name normally being the same as the function)
- these normally inherit from
views/layout.html
which also includes the JavaScript fromviews/*_ajax.html
- if there is no view defined then a default view will be displayed, which will show the values of all the data it can see, but not be formatted nicely
Static CSS/Javascript files are stored in /static
Javascript
- jQuery is used for client-side business logic (hiding fields, opening up tabs, etc):
- Tutorial 1: http://docs.jquery.com/Tutorials:How_jQuery_Works
- Tutorial 2: http://docs.jquery.com/Tutorials:Getting_Started_with_jQuery
- Main reference: http://docs.jquery.com
- We use some plugins: http://plugins.jquery.com
- & some Widgets: http://jqueryui.com
- ExtJS is used for some advanced widgets:
- W3Schools' basic JS: http://www.w3schools.com/js/
Guidelines
- WSGI likes print statements to go to
sys.stderr
notsys.stdout
: http://code.google.com/p/modwsgi/wiki/DebuggingTechniques
- SahanaPy Framework: S3
- Internationalisation
- Help for Developers Migrating from Sahana2
- How to add a new Module?
- Tips - useful links to explore