Project repo for the WWC PDX website
- Development project link: https://wwcodeportland.github.io/wwc-website/)
- Project Trello board: https://trello.com/b/p1GOexLQ/wwc-website-project
[this is a work in progress - check back soon for updated versions]
How to get this project running on your machine.
-
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
). -
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 usingpython
without the 3. -
Fork this repository. This creates a copy of the repository on your GitHub account.
-
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
-
Move into that repository. Depending on where you put it, you may have to
cd
into other folders first.cd wwc-website
-
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 thevirtualenv
is active. -
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
-
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.
Please see this Django guide for information on how to get started with Django, and standards to follow when contributing.
Current desktop mockup prototype