This first post just describes how to set up Jekyll and GitHub for
a personal page / blog combo.
My github username is
I wanted a setup where I have a personal site at https://goodfeli.github.io
and a blog at https://goodfeli.github.io/blog. Because it wasn’t immediately
obvious how to do this, I thought I should document the process.
- Register a GitHub account if you do not already have one.
- Make a repository called
<username>.github.io, in my case
goodfeli.github.io. Make another repository called
- (Optional) I recommend setting both repositories to be private. Otherwise anyone can file a GitHub issue on the repository and it will be publicly visible.
- In your
<username.github.io>directory, make a branch called
master. Make an
index.htmlfile for your personal page. Pushing this to GitHub will result in it being published to the web at https://goodfeli.github.io. Note that we will not be making a
blogsubdirectory within this repository; instead the separate
blogrepository will serve that content.
- Install Jekyll following the instructions for your platform.
jekyll new blogand use the contents of the resulting directory to initialize the
gh-pagesbranch of your
blogrepository. Yes, the
<username>.github.iorepository will serve the
masterbranch and the
blogrepository will serve the
gh-pagesbranch. Your blog with the default Jekyll files is now available, in my case, at https://goodfeli.github.io/blog.