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.
Setup
The Python.org website is built with Pyramid, developed by Pollenation.net. Pyramid requires several third-party packages. Installation instructions for both Pyramid and its dependencies can be found at http://wiki.python.org/moin/PythonWebsitePyramidDocs.
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 webmaster@python.org if you'd like to volunteer.
If you have write access, use the following command instead:
svn co svn+ssh://pydotorg@svn.python.org/trunk/beta.python.org
If you need to convert content from the old site, you should check out the old tree:
svn co https://svn.python.org/www/trunk/pydotorg
Building Python.org
To build the Python website, run the following command from your beta.python.org checkout directory:
python build/build.py
If Pyramid and its dependencies have been installed correctly, this will build a local version of the Python website in build/out. You can check this local version for any errors you might have made.
If you are happy with the change, and the website still builds correctly, you can check in the change. The python.org subversion repository has a postcommit hook which will automatically build and install the changes on the server side.
You might also want to take a look at build/README for further information.
Pyramid Usage
A user guide is at:
https://svn.python.org/www/trunk/beta.python.org/resources/docs/readme.rst
The documentation has some python.org specific stuff in it but that is a good thing at the moment.