The point of this repository is to offer some in-Apereo-context resources for approaching GitHub Pages, through a lightning talk and supporting materials.
There are two things here in this README.
- Supporting materials, hyperlinks
- Meta about the slide presentation
- apereo.github.io blog (source)
- oaeproject.org (source)
- early progress on a new uPortal manual (source)
GitHub Pages is a classy, SaaS implementation of the free and open source Jekyll site generator. GitHub is pulling this off with panache, and largely with open source Jekyll and open source plugins for Jekyll.
This means you can run Jekyll locally instead, for development or even for production generation of your website.
See also:
- Jekyll for Technical Documentation (YouTube video from JekyllConf)
Jekyll is an implementation of the static site generator idea.
There are a slew of static site generators out there besides Jekyll.
You could use any static site generator with GitHub pages hosting, committing the generated site rather than just the source into the GitHub repository for your site. That is, you could still take advantage of the static hosting and much of the Git features, you'd just be losing the convenience of GitHub running the site generator transformation for you.
The slide dock is in /docs. It's implemented in the Shower open source HTML/CSS/JS slide presentation framework, builds via Jekyller, and actually builds and deploys through GitHub Pages running Jekyll to build and deploy the /docs directory as a static website.
If I knew what I was doing with Git I'd incorporate shower and the ribbon theme by reference rather than by copy, but I don't, so this repo simply has a copy of what it needs from those.
The slides include a few speaker notes.