This is the Sampa group website, built with Jekyll and bibble.
It's based on our research group website template, which you can use to build your own nice group website! 🎣
Most pages are just Markdown files that you can edit directly. People are
listed in _data/people.yml
and the news is generated from _data/news.yml
.
Try editing directly in GitHub! It's like magic.
For both long-form blog posts and short news updates, we use Jekyll's blogging system. To post a new item of either type, you create a file in the _posts directory using the naming convention YYYY-MM-DD-title-for-url.md
. The date part of the filename always matters; the title part is currently only used for full blog posts (but is still required for news updates).
The file must begin with YAML front matter. For news updates, use this:
---
layout: post
shortnews: true
---
For full blog posts, use this format:
---
layout: post
title: "Some Great Title Here"
---
And concoct a page title for your post. The body of the post goes after the ---
in either case.
The requirements for building the site are:
- Jekyll: run
gem install jekyll
- Pybtex: run
pip install pybtex
- bibble: included as a submodule. Because git is cruel, you need to use
git clone --recursive URL
or issue the commandsgit submodule init ; git submodule update
to check out the dependency. - ssh and rsync, only if you want to deploy directly.
make
compiles the bibliography and the website content to the _site
directory. To preview the site, run `jekyll serve`` and head to
http://0.0.0.0:4000.
To upload a new version of the site via rsync over ssh, type make deploy
. A web hook does this automatically when you push to GitHub.
If you use an alternative Python when building the bibliography, use make PYTHON=/path/to/python
.
publications update: /_include/pubs.html
news update: /_posts
projects update: /_projects
poeple update: /_data/people.yml /img/people/