This repository contains the source for the website for Northeastern's CS4530, Fall 2023 class. If you are looking to browse the site, you should visit it directly, at https://neu-se.github.io/CS4530-Fall-2023/. If you are looking to edit the site, then you have come to the right place!
All materials in this repository (the lectures, assignments, and also the site itself) are released under the Creative Commons Attribution-ShareAlike 4.0 License. Please feel free to reuse or remix these materials in your class. If you do, we'd love to hear your thoughts.
This website is built using Jekyll, a lighweight static website generator that takes Markdown files as input and outputs a nicely structured website according to some template. This site uses Kevin Lin's Just the Class Jekyll template, which in turn is built on the Just the Docs template.
The local development environment for Jekyll will allow you to run a live-updating local server that lets you preview what the website will look like when it is deployed. As you make changes to the website (in the markdown files), the development server will automatically update the site that it is serving. View the Jekyll quick start guide for more information.
-
Follow the GitHub documentation for Setting up your GitHub Pages site locally with Jekyll.
-
Install a local Jekyll server if you do not already have one. To do this, say
$ gem install bundler jekyll
$ bundle install
- Start your local Jekyll server.
$ bundle exec jekyll serve
- Point your web browser to https://localhost:4000
- Reload your web browser after making a change to preview its effect.
The GitHub Actions build system for this site is configured to automatically push content into Canvas when changes are pushed to the main branch of this repository. Specifically, it will push the assignments, lectures, and the home page material into Canvas, overwriting any changes made to those assignments, modules, or home page content in Canvas.
The Canvas sync plugin benefits from some metadata on assignments (e.g. due date) and lectures (e.g. list of lessons and curricular materials). Hence, the assignments and lectures in this site include a few extra front-matter definitions at the top of each page.
To use this plugin on a new repository, configure the GitHub secrets CANVAS_BASE_URL
, CANVAS_COURSE_ID
and CANVAS_TOKEN
. Given that the plugin is embeded directly in the project (and not in a separate gem), it's also necessary to set the environmental variable JEKYLL_NO_BUNDLER_REQUIRE
to true. Ideally, after this course offering is complete, the plugin should be extracted to its own module for better reusability. Note that GitHub Pages limits which plugins can be built using the standard GitHub Pages builder, and hence, the canvas sync plugin won't work if built using GitHub Pages. However, GitHub Actions will build whatever you want, including Jekyll sites with custom plugins. See the GitHub Actions configuration in this repo.
This repository is also built by Netlify. We do not use Netlify to host the production site, but use it for development. Each commit to this repository (to any branch) is automatically deployed to a publicly-accessible web address, allowing for an easy preview/review of what the site will look like given some change. The easiest way to use this workflow is to create a pull request: Netlify will add a status message on the pull request with a link to the current deploy preview of the site as it is in that pull request. As you push more commits to the pull request, Netlify will continue to update the site. Alternatively, you can log into the Netlify control panel using GitHub sign-in and view the complete deployment history, with direct links to all deploy previews (not just for pull requests).