Getting Started with Github Pages15 Sep 2015
Why use Github Pages and Jekyll?
- I’m relatively new to Github, so it seems like a good way to learn more about it
- Learn markdown, again because it’s used by Github and it seems like a great way to document things.
Setting up Github Pages
Here are the basic steps I followed for setting up Github Pages. For additional information see Github Pages.
- Create a repository called username.github.io.
Clone lanyon repo and copy files to your new repository.
git clone https://github.com/poole/lanyon.git cd lanyon cp * <path_to_github_pages_repo>
Create a directory called
_draftsin your Github Pages repo. This will serve as a staging area for new blog posts that you do not want published.
Install Jekyll. Jekyll will allow you to test your changes locally before pushing them to Gihub.
gem install jekyll
Now that things are setup, here’s a basic workflow for publishing new posts.
_postsdirectory, create new file
Add YAML front matter block at the top of the file
--- layout: post title: Blogging Like a Hacker ---
Write something informative (this will probably include a lot of google searches on markdown) then test with Jekyll
Make sure everything looks good by opening browser to http://127.0.0.1:4000/
Push changes to Github
git commit git push
- Open browser to username.github.io
Layout and Design Ideas
I like the simplicity that this format allows. I borrowed most of the design of the page from the following places.
Add Custom URL
After getting comfortable with the basic setup and workflow of Github pages I wanted to add a custom URL for the site. Here are the steps I followed to setup my domain registered with Namecheap.
- Login to your account, select Domain List and click Manage next to the domain you would like to configure.
- Click Advanced DNS and add the following host records:
- Type: A Record Host: @ Value: 22.214.171.124 TTL: 30 min
- Type: A Record Host: @ Value: 126.96.36.199 TTL: 30 min
- Type: CNAME Record Host: www Value: username.github.io. TTL: 30 min
- Save all changes.
- Navigate to your custom URL. Your blog page should load just like it did when navigating directly to username.github.io.
Overall I’m pretty happy with this setup. Considering I’m not a web guy and have never setup my own blog before, I feel like this will give me a good foundation to build on. Some things I would like to add down the road are: Enabling comments, Linking to Twitter/other social media, Search and better Tagging, and Google Analytics. I’m sure there will always be something else to tweak and play around with. Most importantly, this is a great way to get blogging and share information with my co-workers and peers.
###Update I added Twitter and comments to my blog. Joshua Land has a great write up on how to do this.
I’m still very happy with Github Pages and how my blog has progressed. There’s so much flexibility with this platform and it’s so easy to add content to new posts.