Skip to content

mit-acl/mit-acl.github.io

Repository files navigation

mit-acl.github.io

Jekyll website for Aerospace Controls Laboratory at MIT.

Setup

We build the static site locally and then push it to the gh-pages branch for hosting. This requires you clone the repository and _site folder correctly.

git clone [email protected]:mit-acl/mit-acl.github.io.git
cd mit-acl.github.io.git
git clone -b gh-pages `git config remote.origin.url` _site

Easy build

  • Update bibliography repo and commit/push any changes
    • Do not edit the contents of the _bibliography directory in this repo. The directory is pulled down fresh from the bibliography repo on each build. Thus, edits should be made and committed directly to that repo separately.
  • Build and commit the static site into _site with bash and Docker: ./build_and_deploy.bash
  • Check the deployment status here
  • Check the website at: https://mit-acl.github.io/

Alternative manual build (not recommended)

If you don't want to install Docker, you can manually build, commit, and push:

  • Update the _bibliography submodule with: git submodule update --remote
  • Commit your changes to the source repo (i.e. mit-acl.github.io)
  • Build the static site into _site with your local Jekyll installation: bundle exec jekyll build
  • Commit your build to the gh-pages branch (i.e. inside _site)
  • Check the deployment status here
  • Check the website at: https://mit-acl.github.io/

New Students

If you're a new student, you need to be added to the website. Reach out to the current ACL webmaster via Slack and provide the following:

  1. A headshot (i.e. .jpg or .png)
  2. Markdown providing your information. (See this example.) Alternatively, if you're comfortable with GitHub/GitHub pages, you're welcome to make the changes yourself and submit a pull request.

Notes