The World Affairs Conference Website
Hello there! Welcome to the repository for the World Affairs Conference (WAC).
Note: If you're looking for more in-depth release information pre-v3, you can find it on our old repo.
According to our website,
The World Affairs Conference (WAC) is Canada's oldest annual student-run current affairs conference.
WAC is an annual event where thousands of students in Ontario gather to hear some of the brightest minds in Canada (and in the world) discuss important current affairs topics, such as technology, politics, and ethics.
What Does This Website Do?
Good question! This website displays information about WAC for delegates, advisors, and speakers. Hopefully, we make it easy for all of you to learn about what exactly WAC is, what it's about, when it is, and all those other useful tidbits of information.
In addition, we also do registration through the website, using a system we built called donna. It makes it easier for advisors to register for WAC, and also means we cut down less trees. Awesome!
So you want to contribute to WAC? Great! We're aiming to have a full documentation set on how to edit this website, but in the meanwhile, we have a little guide for you.
- Our production-ready version of the website is stored in
master, which is available for viewing at world.ac.
- All other branches are not officially available on the web. Instead, you'll have to build and run them yourself. Refer to our setup section for more information.
Note: This guide assumes you're using a unix system.
Setting up the WAC website on a local machine is simple. All you need to do is copy-paste a few commands into your command line.
First thing you need is the repository. Clone and get into the directory with this command:
$ git clone --depth=1 https://github.com/worldaffairsconference/world.ac.git && cd world.ac
To setup your machine to run the server, you'll need the tools of the trade. The tools we use are:
- Ruby, to build our site (we recommend v2.4.0+)
- Bundler, to install our ruby dependencies
- Git, to clone this repository
- A Browser, to view the website of course!
Bundler installs these Ruby Dependencies:
- Jekyll, to build and run the website
- Sass, to write CSS better
- Rake, to help us check our code
- HTML Proofer, to help us check our HTML
If you're using a mac, Ruby comes pre-installed. That makes installing our dependencies pretty easy! (If you don't have ruby installed, you can find instructions on their website).
To install our ruby dependencies, you need Bundler. You can install it with:
$ gem install bundler
Next step is to setup our dependencies. Just run
bundleto install our ruby dependencies and also downloads other non-ruby dependencies.
Note: You might have troubles running
.sh files if you don't make them executables. Type in
chmod +x ./setup.sh, and then run
To "compile" and serve the website, run
./start.sh. Then, visit http://127.0.0.1:4000/ - and everything should work!
And voila! Everything should work for you. If something doesn't, let us know on our issues tracker.