Reporting Bugs & Issues

One of the easiest ways to help is to simply look around the site, find things that should be fixed, and report them.

Use the PyCon-Tech issue tracker. For the registration site, use the web2conf bug list. See Reporting Bugs for details.

Editing Pages

Most of this site is a wiki, so adding/fixing content is very easy.

First you will need to get an account and site access as described here. Then log in and you will see an "Edit" button on most pages in the bottom left corner. That is all you need to do to fix typos or add some descriptions.

There is a list of open tickets for the website.

To add links, either insert the URL (http:// etc.) directly, or use this syntax:

`display text <URL>`_

The URL may be relative to the page you're editing (subpage/, ../sibling/), absolute on the site (/2010/.../), or fully qualified (http://...).

To create a page, enter the new URL in your browser. You'll see a "404: Page not found" message and a "Create Page" button. Click the button and add text. Each page should begin with a document title, like this:

===============
Page Title Here
===============

The lines of "=" (equals signs) above & below the title must be the same length, at least as long as the title text.

If you're not sure about the markup, don't worry; someone will add it or clean it up. For instructions on reStructuredText, the markup used for these pages, please see one or more of the links below:

• reStructuredText Cheat Sheet (text only; 1 page for syntax, 1 page directive & role reference)
• Quick reStructuredText (user reference)
• A ReStructuredText Primer (HTML) (or text source)
• reStructuredText Markup Specification (detailed reference)

Editing Menus (Navigation Bar)

See the instructions for the NavBar system.

Adding Public Files

To add files to the site (pdf files, images, etc) which are not part of the core design, you must add them to public folder in the pycon organizers subversion repository at:

svn+ssh://pycon@svn.python.org/pycon/2010/public/

In order to get access to this repository you must send your SSH public key to David Goodger <goodger (at) python dot org>. Once you commit changes to the repository, you must send an e-mail to Doug Napoleone <doug.napoleone (at) gmail dot com> to update the data on the web server, to make the change visible.

RSS Feeds

RSS2 feeds are available for the Recent Changes page and for the history lists of individual pages. The RSS link is the same as the page URL with '?feed=rss2' appended (e.g. /2010/recent/?feed=rss2, /2010/about/?feed=rss2).

Atom feeds can be added later, if someone wants to add them.

About This Site (PyCon-Tech)

This site is based on Django. That means it is very easy to set up your own local copy: install Python, Django, and grab the source to this site from SVN. But first you might want to watch the 30 min screencast Doug Napoleone created about this site, A ReST Wiki for PyCon2008 (slightly out of date; for instance, we no longer allow anonymous editing).

Then follow the SVN instructions: https://pycon.coderanger.net/#InstallingPyCon-Tech. Get the development server running, then poke around on your version of the site and in the admin.

If you'd like to contribute to the PyCon-Tech development, please subscribe to the pycon-tech mailing list.

About This Site (web2conf)

New in 2009: The registration area of the PyCon site is a web2py application. This means getting your own copy up is almost point-and-click easy. Install Python, web2py, and put the registration application in the web2py applications folder. For local use, set DEV_TEST=True (in applications/register/models/0.py), and you're ready to roll - start web2py locally with:

$ python web2py.py

and navigate to http://localhost:8000/register. Also be sure to poke around http://localhost:8000/admin, where you can load test data.

You can find the complete image of PyCon2010 registration application, including the PyCon2010 web2py image, at https://code.launchpad.net/web2conf.