Static Sites and GitHub (or Gist)
Resources
The code in this repository has been helpful when working with Jekyll and GitHub Pages.
Ben Balter’s post “Explain like I’m five: Jekyll collections” has also been very useful.
The data for my blog is automatically transformed by Jekyll into a static site whenever I push its repository to GitHub.
Installing Jekyl
I used the github-pages Ruby Gem to do this.
Health check
Checks your GitHub Pages site for common DNS configuration issues.
github-pages health-check
Running Jekyll
- Run
bundle exec jekyll serve - Your site should be available at http://localhost:4000
Find out about installing Jekyll, keeping it updated (with GitHub Pages), configuration settings, e.t.c. here.
Turning Jekyll off
You can completely opt out of Jekyll processing by creating a file named .nojekyll in the root of your Page repository and pushing that file to GitHub. This should only be necessary if your site uses directories that begin with an underscore, as Jekyll sees these as special directories and does not copy them to the final destination.
License
The following directories and their contents are Copyright Jason Niemi. You may not reuse anything therein without my permission:
- _drafts/
- _includes/
- _layouts/
- _posts/
- _site/
- about/
- images/
- javascripts/
- stylesheets/
Post written on 2015-05-20 00:00:00 -0700