Files changed (1)
-This is a simple application which provides flexible user registration for [[http://www.djangoproject.com/|Django-based projects]]. The default setup implements a fairly common workflow:
-This application assumes that you are already have a working installation of Django 1.0 or newer, and that you are comfortable enough with Django to be able to, for example, create templates based on a description of what context variables are available to them, set up your own URL configuration and work with Django's forms system.
-A useful companion to this application is [[http://www.bitbucket.org/ubernostrum/django-profiles/wiki/|django-profiles]], which implements various features related to user profiles.
-There are three basic ways to install: automatically installing a package using Python's package-management tools, manually installing a package, and installing from a Mercurial checkout.
-The easiest way by far to install django-registration and most other interesting Python software is by using an automated package-management tool, so if you're not already familiar with the available tools for Python, now's as good a time as any to get started.
-The most popular option currently is [[http://peak.telecommunity.com/DevCenter/EasyInstall|easy_install]]; refer to its documentation to see how to get it set up. Once you've got it, you'll be able to simply type
-Another option that's currently gaining steam (and which I personally prefer for Python package management) is [[http://pypi.python.org/pypi/pip/|pip]]. Once again, you'll want to refer to its documentation to get up and running, but once you have you'll be able to type
-If you'd prefer to do things the old-fashioned way, you can manually download the django-registration 0.7 package from [[http://pypi.python.org/pypi/django-registration/0.7|the Python Package Index]]. This will get you a file named "django-registration-0.7.tar.gz" which you can unpack (double-click on the file on most operating systems) to create a directory named "django-registration-0.7". Inside will be a script named "setup.py"; running
-will install django-registration (though keep in mind that this defaults to a system-wide installation, and so may require administrative privileges on your computer).
-If you have [[http://www.selenic.com/mercurial/wiki/|Mercurial]] installed on your computer, you can also obtain a complete copy of django-registration by typing
-Inside the resulting "django-registration" directory will be a directory named "registration", which is the actual Python module for this application; you can symlink it from somewhere on your Python path. If you prefer, you can use the setup.py script in the "django-registration" directory to perform a normal installation, but using a symlink offers easy upgrades: simply running "hg pull -u" inside the django-registration directory will fetch updates from the main repository and apply them to your local copy.
-Have a look at the documentation (included in the "docs/" directory of the package, or [[http://www.bitbucket.org/ubernostrum/django-registration/src/tip/docs/|browsable online]]) to see the next steps. [[http://www.bitbucket.org/ubernostrum/django-registration/src/tip/docs/quickstart.rst|The quickstart document]] will tell you what you need to know to get started, and from there you can read the rest of the documentation to see all of the available options and features.