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.
Want to build your own version of Convergence? No problem!
You'll need a few things:
- 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:
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.