Jekyll & Plaid

A theme with a checkered past

About Jekyll & Plaid

Jekyll & Plaid is a GitHub Pages theme for CMU projects. You write your docs in Markdown, and GitHub builds them into pages in CMU's web template, with the Carnegie Mellon Web Kilt's components.

How It Works

It's a Jekyll remote theme, so there's nothing to install: your repository names the theme in _config.yml, and GitHub Pages builds the site each time you push. Each page loads CMU's template from www.cmu.edu and the kit from jsDelivr.

  • Markdown pages go in one column, with the CMU header, navigation, breadcrumbs and footer.
  • Full-width pages use the sections layout and the template's own HTML: heroes, full-width sections, cards and sidebars.
  • A small script turns code blocks into boxes with a copy icon, and GitHub's alerts into labeled callouts.

Each site uses the kit release the theme was tested with, unless it names another in _config.yml.

Set Up Your Site

Contributing to Jekyll & Plaid

The GitHub repository has the theme's code and documentation. To report a problem or suggest a change, open an issue or send a pull request.

The theme is under the BSD 3-Clause License. It doesn't cover Carnegie Mellon's names, marks and artwork, or CMU's web template, which the theme loads from www.cmu.edu.

Built a site with Jekyll & Plaid? Tell us about it [login required] for the CMU Web Gallery.

More From CMU Web

Jekyll & Plaid is part of CMU Web, a collection of projects for Carnegie Mellon web development.

Tools for Any Site or App

Carnegie Mellon Web Kilt

Components for websites and web apps on CMU's template.

PlaceMellon

Placeholder photos of Carnegie Mellon at any size, for mockups and prototypes.

QRnegie

QR codes with Carnegie Mellon character, from Scotty portraits to campus landmarks.

FencePost

Link previews for Carnegie Mellon websites: the image and the Open Graph tags.

The Cut & Paste

Banners, headers and icons for tools you use at CMU, sized and cropped in CMU style.

Themes for Other Platforms

Site · WordPress

Forbes & Moreword

A WordPress theme in CMU style, with the Web Kilt's components ready to insert as patterns.

App · Forgejo

Hamerschlag

A Forgejo theme in CMU style, for sites that host code and projects.

App · Vaultwarden

Hunt & Peck

A Vaultwarden theme in CMU style, for the password manager's web vault.