Blog built by Jekyll on Github (tutorial for amateurs) 1

Building a blog has always been a dream of mine. Recording every bit of growth and knowledgy newly learnt makes me feel good. Thus I open this blog.

Introduction

Among all the way to build a personal lightweight static blog, building on github is one of the quikest and easiest way for amateur, in my perspective. In this blog, I’m going to inctroduce the way I learnt to build a blog by Jekyll on github. For the Github part, the best and clearest tutotial I learnt from is from qiubaiying, in Chinese though. Again, it’s for program amateurs and you can have your own blog page within 1 minus.

Environment

Windows 7

Requirement

Github DeskTop

MarkdownPad 2

Tutorials

1-8

There are several good collections with tons of excellent resources. Here recommands Jekyll.Wiki .

Find the github repository of your favored template and fork it or download it. Mine was downloaded from Suyan. You can fork mine if you like it,

1-9

Just enter yourusername.github.io in the repository name.

1-10

Pull down and you’ll find Github Pages. Choose master branch in Source. Click save.

1-4

Now, your blog is already online!!!

!!!!!!

Just that easy,uh! Tell me how many seconds you cost!

If you still don’t believe, enter yourusername.github.io in your address bar of your browser.

Of cause, it still looks the same with mine but just a little more settings it will turn to yours completely.

Open your repository in your github page and find the _config.yml file. Open it.

1-5

Items you need to change include: title, email, description, url(your blog address), author, social account(if you have one and keep it empty if you don’t), disqus(empty it if you don’t have one), ga(empty it if you don’t have one)

1-6

Now, the blog is yours,,, except the content. You can change the content of README.md and index.md in the browser as well.

Find the files named yourusername.github.io and the blogs are saved in the folder _posts. Delete all the files in it and start to create your own.

Well, you have finished half work of building your own blog. Next tutorial is going to talk about the Jekyll part and how to operate your blog.

Thanks for reading!

Any questions are welcome. I’m a starter myself so feel free to ask!

On the edge

Table of Contents