This page collects documentation which describes how to work with TurboGears to accomplish an effect. Normally you should have completed a few Advanced Tutorials so that you have a feel for the general workflow within TurboGears before you dive into these documents.
These pages are the most useful pages for a new TurboGears developer to read after going through the tutorials. Reading the material here will help make you a more productive developer with TurboGears.
We cannot stress this enough: Read These Pages!
Todo
link repoze.who, repoze.what, and the other key middleware
SQLAlchemy is the default data-storage layer for TurboGears 2.1. The SQLAlchemy-migrate project is the officially supported mechanism for updating and migrating your database.
Todo
Document initial DB setup in websetup.py
Todo
Link DB setup (MySQL, PostgreSQL, etceteras) docs
Todo
document the transaction module, part of the repoze.tm package, introduction for implementers here… http://repoze.org/tmdemo.html
webob – WebObtg.flash – Flashtg.decorators – DecoratorsTodo
Document “community” sites; user-signup mechanisms (e.g. tgext.registration2), OpenID, Recaptcha, etceteras as sub-section
The TurboGears Admin system is built on top of the Sprox and tgext.crud system. You can use the same automatically generated forms and controllers to help you quickly prototype your applications. The Movie Tutorial introduces this usage of Sprox.
By default your TurboGears 2.1 project will be configured to use the Genshi templating language. TurboGears allows for the use of alternate templating languages.
Note: most new users do not need to choose an alternate templating language.
Modern web-sites are dynamic, flexible, Javascript-code-heavy pieces of software. You will almost certainly want to use one of the major Javascript libraries to make the process of creating your sites less painful. The ToscaWidgets package provides plug-ins for each of the three major libraries, JQuery, Dojo and Ext, as well as the older Mochikit package which was the default in TurboGears 1.x.
Todo
JQuery, Dojo, EXT usage doc-links
Todo
Link documentation for doing JSON RPC/Ajax here
Todo
Difficulty Medium: document how to “freeze” applications (PIP, zc.buildout, etceteras) for re-deployment with precisely the same software on each machine (no downloads etceteras)
Todo
document use of Nginx beyond just saying you can do it
Todo
(maybe) document use of Twisted WSGI wrapper?
Todo
Difficulty: Medium. optimization tips for SQLAlchemy usage
Todo
Difficulty: Easy. Validate that toctree maxdepth values are appropriate
Todo
Difficulty: Easy. Explain usage of tgscheduler and how to use SQLAlchemy in a task