🌎 The brand new, awesome WAC Website repo!
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_data
_includes
_layouts
_plenaries
css
files
img
js
.gitignore
.htaccess
.travis.yml
404.html
Gemfile
Gemfile.lock
LICENSE.md
README.md
Rakefile
_config.yml
addresses.html
build.sh
contact.html
faq.html
index.html
keynote.html
plenaries.html
schedule.html
setup.sh
staff.html
start.sh
unsetup.sh

README.md

world.ac

Build Status GitHub Release

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.

What's WAC?

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!

Development Notes

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.

Branch Info

  • 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.

Setup

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 ./setup.sh. ./setup.sh runs 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 ./setup.sh!

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.