The Programming Languages Laboratory website

Source code for The Programming Languages Laboratory website at https://pl.cs.jhu.edu.

Development

Basic

Serve the website on your local machine for development.

1. Install VirtualBox.

2. Install Vagrant.

3. Run:

   $ vagrant up
   $ vagrant exec docker-compose up jekyll

4. Visit http://localhost:4000.

5. (Optional) To enable auto-reloading features (i.e. changes to source files are immediately available on the browser) run:

   $ vagrant fsnotify

   Edit the Markdown files with the contents and the results should be immediately available for preview by refreshing the browser.

Run tests

$ vagrant exec docker-compose run --rm jekyll rake test

Install assets dependencies

Assets dependencies (e.g. jQuery, Bootstrap) are managed using Bower, a package manager for the web.

In order to add a dependency, edit bower.json and run:

$ vagrant exec docker-compose run --rm bower

The packages are installed under assets/vendor/.

Deployment

The source branch contains the Jekyll source to generated the website, while the master branch contains the generated HTML. This is meant to keep the deployment scheme used by pl.cs.jhu.edu, which consists on serving the contents of the master.

To deploy, run the following from your local machine (not the Vagrant Virtual Machine nor the Docker container):

$ rake deploy