Welcome to the website for Convergence, the student-run publication at Upper Canada College. On our website, you can find an archive of our previous articles, as well as soon-to-come online specials.
Convergence was built on Jekyll and Bootstrap.
Want to build your own version of Convergence? No problem!
You'll need a few things:
- Ruby
- Bundler, to install our Ruby dependencies (Jekyll and some Jekyll helpers)
- Git, to clone this repository
- A Browser, to view the website of course!
First things first, we need to install Jekyll. We assume that you have Git, Ruby, and Bundle installed. If you don't, please visit the links above to install them. We also assume you're using a Unix-based system; if you aren't, follow jekyll's alternatives instruction page.
First, clone the git repository:
$ git clone https://github.com/malsf21/convergence.git
Then, cd into the repository:
$ cd convergence
Now, we're going to install all of our dependencies! Type in your command line:
$ bundle
We're almost done: now, we're just going to serve the site. Type the following into your command line:
$ bundle exec jekyll serve
After that, you should get a response that looks something like this:
$ bundle exec jekyll serve
Configuration file: /Users/matthew.wang/github/convergence/_config.yml
Source: /Users/matthew.wang/github/convergence
Destination: /Users/matthew.wang/github/convergence/_site
Incremental build: disabled. Enable with --incremental
Generating...
done in 0.287 seconds.
Auto-regeneration: enabled for '/Users/matthew.wang/github/convergence'
Configuration file: /Users/matthew.wang/github/convergence/_config.yml
Server address: http://127.0.0.1:4000/
Server running... press ctrl-c to stop.
Visit what follows the "Server address:" line (which is normally http://127.0.0.1:4000/).
And voila! Everything should work for you!
Note: you can use rake
to build and test the output of bundle exec jekyll build
.