Project Liquid is the codename of the new ACM@UIUC website.
The master branch should always be an up to date working version of the website. Please do all developement in a Github fork and submit a Pull Request when the feature is ready to launch. It is good form and easier if you keep each feature in a seperate branch on your fork.
Please use the github issue tracker to track tasks and current work.
To get started, fork the repository on Github so you have your own little plot of the internet to work with. Next, checkout that repo!
git clone [email protected]:USERNAME/liquid.git
After cloning to your computer you need to have the following system packages installed:
- mysql
- MAC:
brew install mysqlthenmysql.server start - Linux:
sudo apt-get install mysql-server
- MAC:
An important step in any Python project is setting up a sanitary work environment. You don't cook in a messy kitchen, do you?
cd liquid
virtualenv venv
source venv/bin/activate # run this whenever you open a new terminal session
Now we need to grab all of the Python packages:
pip2.7 install -r liquid/requirements.txt
Note there is a problem with certain versions of Pip and speciic packages. It works fine on Pip 1.0ish.
Run the fancy-shmancy script that will setup the database into an initial state.
python setup.py
Now let's start the website!
python liquid/manage.py runserver
Visit localhost:8000 in your browser.
Note that you will not be able to login unless you are on the UIUC campus network. If you want to work remotely, check out CITES VPN.
So you've gone through the setup above, eh? Ready to get to work? Good!
Add the acm-uiuc/liquid repository as a remote so you can pull in new changes from everyone else.
git remote add acm https://github.com/acm-uiuc/liquid.git
git fetch
Do the following whenever you want to pull in changes from the main repository.
git checkout master
git pull acm master
Now you will want to make each independant feature or bug-fix on a different branch. This keeps things tidy and lets everyone code review pull requests in small chunks. Let's make a new branch, do some work, and commit.
git checkout -b feature
# make changes ...
git commit -m "Feature X: description."
In order to make a pull request, you need to push your changes back up to Github.
git push -u origin feature
Now if you go to the acm-uiuc/liquid repository and make a pull request. After creating it, sit back and wait for the sweet, sweet praise to come in.
Sometimes (most of the time), the code reviewers will say "Hey you! You're wrong! Fix this! Change that!". Relax, we got this. Checkout your feature branch again, make your changes, and push it back up to Github.
git checkout feature
# make changes ...
git commit -m "I fixed it, yo."
git push
Your pull request will be automagically updated.
Note: It's important that you don't push commits that are not related to this pull request up to this
branch. They will be added to the pull request and everything will get very mixed up. To check what branch
you are on, use git branch or git status.
-
Python-LDAP won't install
- Mac: OS X formerly had problems that were solved by instructions here.
- Linux: Try
sudo apt-get install python-ldap
-
mysql-python, reportlab or python ldap won't install with error:
clang: error: unknown argument: '-mno-fused-madd' [-Wunused-command-line-argument-hard-error-in-future]
clang: note: this will be a hard error (cannot be downgraded to a warning) in the future error: command 'cc' failed with exit status 1
-
Should only occur on OS X with Xcode version 5.1 or greater
-
Fix: Try 'ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future pip install mysql-python=1.2.3' for mysql-python
Try 'ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future pip install python-ldap==2.3.13' for python-ldap
Try 'ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future pip install reportlab==2.5' for reportlab
Then use 'pip install -r requirements.txt'
-
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent
