Prologue - Jekyll Theme

(Actively maintained, expect some changes)

Gem Version

Prologue Theme

This is Prologue, a simple, single page responsive site template from HTML5 UP, now available as a Jekyll theme from Chris Bobbe. It features a clean, minimalistic design and a sticky sidebar with navigation-linked scrolling.

Demo: https://chrisbobbe.github.io/jekyll-theme-prologue/

Added Features

  • Formspree.io contact form integration - just add your email to the _config.yml and it works!
  • Set a cover photo for any of your sections (not just the first), with alt text for screen readers and SEO
  • Add your social profiles easily in _config.yml. Only the social profiles buttons you enter in config.yml will show up on the site footer.
  • Search engine optimization (SEO) meta tags based on info you provide in _config.yml and frontmatter
  • Google Analytics built-in; just put your Tracking ID in _config.yml as google_analytics
  • Custom 404 page (called 404.html; to activate, move it to your project directory).

How to Use

There are two ways to get started:

  1. Install the jekyll-theme-prologue gem. Instructions are in the Jekyll docs. After running bundle install, you can find the theme files by running open $(bundle show jekyll-theme-prologue). A sample working _config.yml file ships with the gem; if you want to activate it, move it to your project's root directory. It will do nothing until you move it there, replacing the default _config.yml file.
  2. Fork the GitHub repository. If you want to use GitHub Pages, create a branch named gh-pages, and replace theme: jekyll-theme-prologue with remote_theme: chrisbobbe/jekyll-theme-prologue in the provided _config.yml (GitHub Pages now supports open-source themes on GitHub).

Make sure that url and base_url are set for your own website in _config.yml. For local testing, make them both blank.

Add a photo avatar to your project, then set avatar: path/to/your/avatar.jpg in _config.yml; for example, avatar: assets/images/avatar.jpg. 48x48 pixels works best.

Set a cover photo in any of the sections by adding cover-photo: path/to/photo.jpg and cover-photo-alt: some alt text to the section's frontmatter. (Don't forget the alt text for screen readers; it won't work without it.)

Special instructions

Jekyll does not support multiple layout-formatted content sections per page, and this theme is a good workaround. Bear with me for a few instructions unique to jekyll-theme-prologue.

You don't need to use Jekyll's hardcoded support for _pages or _posts, and layouts aren't provided for them. If you want to customize the templates, go to _layouts/home.html and _includes/section.html provided with the theme, but this isn't necessary.

  1. Your _config.yml file must include the following line or it will not work: collections: [sections]. This tells Jekyll to look in the _sections folder (which you will create) for your content and render it all on one page.

  2. Create a _sections folder in your project's root directory and start adding content. Sample content is provided in the GitHub repository.

All new sections should be added as html or Markdown documents in the _sections folder. The following variables can be set with frontmatter:

  • title (required)
  • order (required; orders the sequence of sections on the page. Example: 1)
  • cover-photo (optional; sets a background image for the section. Example: assets/images/banner.jpg)
  • cover-photo-alt (required if using a cover photo. Describes the photo for screen readers; e.g., "Dome of Light art installation, Kaohsiung, Taiwan")
  • icon (optional; see Font Awesome for icon codes. Example: fa-github)
  • auto-header (optional; "use-title" is default, "none" for no header, or custom header text)

There shouldn't be a need to set permalink because all content displays together in index.html.

Credits

Thanks to @andrewbanchich for his many Jekyll adaptations of HTML5 UP's elegant themes, which helped and inspired me, and of course many thanks to HTML5 UP.

Original README from HTML5 UP:

Prologue by HTML5 UP
html5up.net | @ajlkn
Free for personal and commercial use under the CCA 3.0 license (html5up.net/license)


This is Prologue, a simple, single page responsive site template. It features a
clean, minimalistic design and a sticky sidebar with navigation-linked scrolling.

Demo content images* are courtesy of the ridiculously talented Felicia Simion. Check out
more of her amazing work over at deviantART:

http://ineedchemicalx.deviantart.com/

(* = Not included! Only meant for use with my own on-site demo, so please do NOT download
and/or use any of Felicia's work without her explicit permission!)

Demo banner images* courtesy of Unsplash, a radtastic collection of CC0 (public domain)
images you can use for pretty much whatever.

(* = Not included)

AJ
[email protected] | @ajlkn

PS: Not sure how to get that contact form working? Give formspree.io a try (it's awesome).


Credits:

    Demo Images:
        Felicia Simion (ineedchemicalx.deviantart.com)
        Unsplash (unsplash.com)

    Icons:
        Font Awesome (fortawesome.github.com/Font-Awesome)

    Other
        jQuery (jquery.com)
        html5shiv.js (@afarkas @jdalton @jon_neal @rem)
        CSS3 Pie (css3pie.com)
        background-size polyfill (github.com/louisremi)
        Respond.js (j.mp/respondjs)
        jquery.scrolly (@ajlkn)
        jquery.scrollzer (@ajlkn)
        Skel (skel.io)