Python.org Website Maintenance

This is a guide to setting up and using the software necessary to maintain the Python.org website. This document is under construction; more information may be found at http://wiki.python.org/moin/PythonWebsite

If you wish to volunteer to help maintain the Python.org website, please sign up to the pydotorg-www mailing list.

Obtain Python.org Data

The command to check out a working copy of the Python.org site data from the Python Subversion repository is:

svn co https://svn.python.org/www/trunk/beta.python.org

Please note that this repository contains several hundred megabytes.

To be able to directly make changes to these files, you will need write access to the repository. Please send a note to pydotorg-www@python.org if you'd like to volunteer to work on the site.

If you have write access, use the following command instead:

svn co svn+ssh://pydotorg@svn.python.org/trunk/beta.python.org

Building a Local Copy

Refer to build/README for a list of dependencies and details on building a local copy of the website. In summary: You will need Python 2.5 or 2.6, mako, pyyaml, and docutils and about 1 to 3 minutes for the initial build of the website.

Diagnosing Problems

The links on the status page are useful, especially the "Log of all commits and builds" and the "Post commit logging file" (which may be very large).

Notice: While Javascript is not essential for this website, your interaction with the content will be limited. Please turn Javascript on for the full experience.