skip to navigation
skip to content

Help Fund Python

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 webmaster@python.org if you'd like to volunteer to work on the site (but please don't request write access until you are sure you are going to contribute).

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

The build system for python.org has been rewritten and is now much easier to install and use. Since the code is still being worked on, for now it's best to refer to build/new-build/README for information on how to use it.

A summary of the commands (subject to change) are:

make new -- Build the site. During the first build, this takes a minute or two. Subsequently, this should only rebuild what has changed, usually in a few seconds. You may periodically need to remove the build cache or the out directory if you run into cases where the dependency model breaks down (should be rare).

make serve -- Run a local web server for the site. It prints which port it's being run on. Access it from a browser with http://localhost:8005/. You do not need to restart the server after rebuilding.

On non-Posix platforms, you can issue the same commands found in the Makefile (or write a small script that does so).