Maintaining the PyCon Web Site
Anyone can help, regardless of your skill level. We need raw content, so if you can type some text, we can use your help. If you can edit what someone else has typed and make it look pretty, great! If you want to help code the underlying mechanics, we need that too.
You'll need an account on this website, and you should subscribe to the pycon-organizers mailing list. Click here for instructions.
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, 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 (/2009/.../), 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)
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/2009/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. /2009/recent/?feed=rss2, /2009/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.
.