Adding pages

stuff jekyll processes

Jekyll will ‘process’ markdown, sass, and scss that contains a ‘front matter’ block at the top:

---
---

Everything else it just copies into _site (which is gitignored).

source and images

Markdown source lives in crunch/ and images in crunch/images. Within a markdown file, this means you can just use relative links: ![alt text](images/descriptive-name-for-image.png).

adding to nav

To get it to show up in the main navigation – the sidebar – add an entry to _data/crunch/crunch_sidebar.yml. It’s yaml. If your title contains a colon, quote the string.

There is a block of the topnav commented out that could provide a dropdown menu, to allow switching audiences or views of the site or whatever.

styles

The majority of styling is in css/theme-crunch.scss; some is also in customstyles.scss for reasons of specificity (rather than rewrite to consolidate everything in theme-crunch, useful values have just been changed in customstyles).

Both of these import _sass/values.scss which contains named values matching those used in Whaam. If you are looking for a shade of grey, look there and use a variable. Scss prefixes variables with $.

Fontawesome and Glyphicon icons are included and ‘just work’ (see theme doc).