Getting Started with TurboGears 1.1

Status:	Official, Work in progress

Contents

Introduction
Installation
Quickstart: Creating a Project
Define Your Model
Using The Database
The Controller
Templates
Where to Go From Here

Introduction

So you found out about TurboGears web framework and have decided you want to give it a try. Welcome to the TurboGears community!

This document tries to guide you through the process of creating your first TurboGears project and give you pointers to further documentation. The documentation herein is valid for version 1.1 of TurboGears and all later minor releases (e.g. 1.1.1) of this version.

TurboGears is fully compatible with TurboGears 1.0 and almost all of the documentation for this version does still apply. In cases where there have been important changes from 1,0 to 1.1 we will indicate this in this guide.

Please note that there is also the TurboGears 2 project, a reinvention of TurboGears based on Pylons, which has its own tg2 documentation site.

Installation

Please see the Installation guide.

Quickstart: Creating a Project

After installation, to start a new TurboGears project, you simple run the quickstart command from a command line:

$ tg-admin quickstart

This will ask for all the necessary information, like the name of your project etc. and will create a new project directory in the current working directory. This is all you should need to know to get started, but more options can be found on the quickstart guide.