The IDEAL Lab main website
See Issues on the site.
To build the website locally, clone the repo with:
git clone https://github.com/IDEALLab/ideallab.github.io.git
Then install necessary Ruby dependencies by running
bundle install from within the
ideallab.github.io directory. After this, the site can be be built with:
bundle exec jekyll build
(If you are getting errors at this stage, it may be due to your version of
gem uninstall bundler +
gem install bundler -v 1.13.1.)
To view the site, run
bundle exec jekyll serve and point a browser to
http://localhost:4000/. More information on Jekyll can be found here.
To include projects, preprocessing scripts are necessary to clone project repos and update Jekyll metadata. This can be accomplished with:
jekyll build works as normal.
Blog posts just require YAML top matter that looks something like:
--- layout: post title: Your Title author: Mark Fuge link: https://enme.umd.edu image: /images/path/to/image.png ---
author tags are required, while
image are optional. Just save a Markdown file with this top matter as something like
YYYY-MM-DD is the date of the post and
newton-institute is the
blog-title. This short title is used in the URL of the post, so this becomes
blog/blog-title/, so the short title should be long enough and unique enough not to cause conflicts with other posts.