/wwc-website

Project repo for the WWC PDX website

Primary LanguageCSSMIT LicenseMIT

wwc-website

Project repo for the WWC PDX website

[this is a work in progress - check back soon for updated versions]

SETUP

How to get this project running on your machine.

  1. Install Git.

    Open terminal (Mac) or command prompt (Windows) and check that it's installed:

    which git

    That should return a path (e.g., /usr/local/bin/git).

  2. Install Python 3.

    Download the latest version of Python (which as of this writing is 3.6.3). The downloadable installer should work for any operating system: https://www.python.org/downloads/

    Once installed, check that it's installed:

    which python3

    That should return a path (e.g., /usr/local/bin/python3). If you're using Windows and get an error message, try using python without the 3.

  3. Fork this repository. This creates a copy of the repository on your GitHub account.

  4. Clone the git repository. This creates a copy of the repository's files on your machine.

    git clone git@github.com:YOUR_GITHUB_USERNAME/wwc-website.git
  5. Move into that repository. Depending on where you put it, you may have to cd into other folders first.

    cd wwc-website
  6. Set up a Python virtual environment. A virtual environment (or virtualenv) isolates the project so that changes made to the project won't affect any others you're also developing.

    python3 -m venv venv

    Now activate the virtual environment. For Mac:

    source venv/bin/activate
    

    For Windows:

    venv\Scripts\activate
    

    You should see (venv) prefixed in front of your terminal prompt, letting you know the virtualenv is active.

  7. Install the requirements using pip. pip is a tool for installing and managing Python packages. It is already installed if you downloaded Python 3 in step 2. It is also automatically installed if you created a virtual environment in step 6.

    You can make sure you have the latest version of pip with this command:

    pip install --upgrade pip

    If for some reason you don't have pip installed, follow these installation directions.

    Once you have pip, install the required packages like this:

    pip install -r requirements.txt
  8. Run the app:

    python manage.py runserver

    You should be able to see the site at http://localhost:8000/.

    The admin dashboard is available at http://localhost:8000/admin.

DJANGO BASICS

Please see this Django guide for information on how to get started with Django, and standards to follow when contributing.

WEBSITE PROPOSED REDESIGN

Current desktop mockup prototype

Current mobile mockup prototype

OLD WEBPAGE

Current desktop site

ATTRIBUTIONS