A Jekyll website powered by Minimal Mistakes theme, hosted on GitHub Pages.
Repo and tutorial website for Minimal Mistakes theme:
_config.yml- Site configuration_pages/- Main pages (Research, People, Publications, Join Us, News)resources/- Resource sub-pages (Datasets, Software, Hardware, Group Notes)
_posts/- News/blog posts_people/- Individual person files (faculty, postdocs, PhD students, MScR students)_resources/- Resource collection entries for grid display_includes/- Custom template includes (person-grid.html, resource-grid.html, footer.html)index.md- Homepageassets/- Images, CSS, and other assets
If you are not comfortable with GitHub, you can open a new Issue on the GitHub repository and select 'Add Person to Website' as the template, which provides a handy form to act off of.
If you know what you are doing, it is possible to create or delete markdown files in _people/:
---
title: "First Last"
last_name: "Last"
type: "faculty" # or "postdoc", "phd", "mscr"
excerpt: "**Job Title**"
image: /assets/images/people/first-last.jpg
profile_url: "https://bristol.ac.uk/profile"
---Notes:
- These markdown files are by convention named in the format
firstname-lastname.md. - Images also need to be added in the
/assets/images/people/directory in the formatfirstname-lastname.jpg, and are recommended to be square aspect ratio,jpgformat, and ideally between 400x400 and 800x800 pixels in size. - The default recommendation is for
profile_urlto link to your People page (for staff) and Pure page (for PGRs, who do not universally have a People page). However, you could also choose to link to your personal website etc. if desirable.
People are automatically sorted alphabetically by last name and grouped by type on the People page.
Create a new markdown file in the _pages/ directory with frontmatter:
---
title: Page Title
permalink: /page-url/
layout: single
---
Your content here.Create a new markdown file in the _posts/ directory with the naming convention YYYY-MM-DD-title.md:
---
title: "Post Title"
date: 2026-03-03
categories:
- category-name
---
Your content here.Resource pages are in _pages/resources/ and displayed as a grid via the _resources/ collection.
-
Install Ruby (if not already installed)
-
Install dependencies:
bundle install
-
Run the site locally:
bundle exec jekyll serveVisit the indicated address (normally something like
http://127.0.0.1:4000/) in your browser.
To customize the site further:
- Edit
_config.ymlfor site-wide settings - Modify page frontmatter for individual page settings
- Add custom CSS in
assets/css/main.scss