This is supposed to be a Hello, World post. I’m going to write down all of the things that I had to do to get this blog up and running again on Github. There are a lot of small missteps that I made along the way, and this is my give back to the community to help document the trail for folks that come after me.
Someday I’ll even get my old posts back up and running again. Having complete control of my content, and how it’s published, with no black magic, is really appealing to me.
Posts live in the _posts directory, and have a unique front matter
You’ll need to create a file using the naming convention
Once you have the file created, you’ll need to add some front matter to your
post that will be used by Jekyll to ensure that it gets the correct formatting.
In the case of a
post, you’ll need to ensure that you add the following
front-matter to your post. I had added
layout: post by mistake, which
incidentally is what the Jekyll documentation
tells you to do, and you will get no formatting for your blog post if you do
I haven’t investigated whether this is a problem with the way Github Pages implements Jekyll yet. This is my suspicion, because of the magic that is used by the Github Theme Chooser where all of the theme details are abstracted away from your Github Pages repository.
--- layout: default title: "Title of your post" ---
You won’t get SSL if you use a custom domain
This isn’t surprising at all, since you really don’t want to mess with the
pain that is creating your own real-signed SSL certificate, and installing it.
You will get SSL if you don’t mind serving from the Github domain for your
pages, which is
In the future, I may decide to have a separate SSL landing page for my own
custom domain, and then use that as a who are you? page with a link to my blog
on Github Pages default domain name, which is
that this will always redirect to your custom domain if you have the custom
domains feature enabled.