Creating a Github Pages Site with Jekyll
This is the start of my tech blog so I thought why not describe the steps it took to create it? The tasks were trivial maybe but not obvious.
Here goes:
- install Ruby
- install Bundler
- install Jekyll
Go to the directory where you want to put your site directory
Create a Gemfile
Add
Run
To see that the install went correctly run
Go to your browser and navigate to http://127.0.0.1:4000/.
You will see a generic Jekyll page. you can start personalizing the site by editing the _config.yml. The official instructions are pretty good
To add new posts, simply add a file in the _posts
directory that follows the convention YYYY-MM-DD-name-of-post.ext
and includes the necessary front matter. Take a look at the source for this post to get an idea about how it works.
Jekyll also offers powerful support for code snippets:
Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.