Archive:Intro To Web Team

Revision as of 18:49, 14 October 2007 by Paulproteus (talk | contribs) (Mailing Lists)
Jump to: navigation, search

So you've decided to join the web team? Sweet! We can use all the help we can get. This page is the place to start understanding the website's infrastructure so that you can help hack! There's also a more detailed Website documentation, if that was what you were looking for. We have Web_Team#Meetings sometimes.

Chatting Us up on IRC

We chat in #freeculture on If you know nothing about IRC, fear not! We have an easy guide to IRC (click). Making a practice of idling in the IRC channel and asking questions is a great way to begin to get involved with the website and the organization in general!

The Server

The web server is hosted in Japan. It's a box that runs some flavor of linux. It contains the Web site, wiki, planet, blog, and a cornucopia of chapter websites.

Connecting to it

Instead of using FTP, we use SSH (click to learn how to use it).

File Structure

It can be confusing, so we should explain it.

  • backups/ - Old files we probably aren't using, but we somehow don't want to delete them.
  • cache/ - Cache files for things like downloaded calendars, Planet feeds, etc.
  • config/ - Various configuration files, currently only for our (broken) calendaring system
  • chapter-hosting/ - Since most chapter websites are similar, this is where their files are stored
  • domains/ - Major domains we host, like:
    • domains/ - main website
    • domains/ -
    • etc.
  • lib/ - (PHP mostly) libraries to support various web apps or other software we have installed
  • Maildir/ - Email storage for the mailbox
  • passwords/ - Where most passwords get stored.
    • passwords/mysql_passwords - a list of all the MySQL passwords we have. This is used by a nightly cron job that saves all the MySQL databases to files.
  • planet/ - configuration and software for the program "Planet", which we use for making our feeds for the front page.
  • software/ - Various code that we use or wrote.
  • subdomains/ - Code that handles redirects for chapter subdomains
  • subversion-repository/ - The svn repository storage
  • tmp/ - Temporary directory for files made that are known to later be able to be deleted.

Other directories that are just distractions:

  • gavinfacebook/ - A directory Gavin and Asheesh made
  • svn/ - A directory Asheesh uses for storing his personal configuration files, like .bashrc

The Back End

(this should include the software behind the sections, where they are in the document tree, and any necessary info for using/administrating them)

The "Main" Site is powered by Wordpress. That means that the actual content of the pages can be updated by WebDev laymen.

The Wiki

The wiki is, of course, powered by MediaWiki.

Mailing Lists

Website_documentation#Mailing_lists documents our Mailman setup, which is the app that runs our mailing lists.

The Planet

The Planet is powered by something else.

Chapter Websites

There are also a few chapter websites at These consist of any combination of a blog, a wiki, and a mailing list. See Hosting chapters.