Using Jekyll and GithubPages to build your own blog [macOS]

Table of Contents

<a id="1"></a>Introduction

GithubPages is now a easy way to build a website for you and your project. The code of your website is stored in the Github so it is convenient for you to edit and push your posts.

Jekyll is a tool for building GithubPages, which is also simple and easy to understand.

My blog, this website, is build using Jekll and GithubPages. You can get its original code from here.

Now let's strat building your own blog. The following guideline is in macOS environment.

<a id="2"></a>Method

<a id="21"></a>Step One

You should have an account in Github and create a new repository base on your github username. Here is the guideline in GithubPages website. The name of your repository maybe your-username.github.io. Make sure the name is correct. Then in the repository's setting page:

image
image

You can see:

image
image

Here you can launch automatic page generator to generate your site quickly. But in this circumstance you don't need to, because we are going to build website using jekyll.

After creating the repository, your should clone it to your mac. I suggest your using Github Desktop to do it.

<a id="22"></a>Step Two

In Terminal, using the following code to install jekyll:

$ gem install jekyll

If your have enabled password in you mac. You may use this instead:

$ sudo gem install jekyll

<a id="23"></a>Step Three

After installing jekyll, you can download some jekyll template from Jekyll Theme and choose the one your like most. And copy all the files in the folder to the repository folder your create in Step One:

image
image

Now run Terminal in your repository folder:

$ cd your repository folder

Run jekyll serve:

$ jekyll serve

In this step, due to the template your choose, you may need to install some other jekyll gems. Just follow the guide in terminal.

After jekyll serve successfully, a website will run in http://localhost:4000/ by default for developing.

<a id="24"></a>Step Four

Until now, the blog has been built. You can commit the change to master of your repository and visit your blog at url such as your-username.github.io.

But this is not the end, it's time to add things to your blog.

Basically, to add a post to your blog, you can write a post in Markdown grammar and put it in the _posts folder in your repository:

image
image

For more information about the files and folders in a jekyll template, you can read documents here.

<a id="3"></a>Ending

There are lots of things you can do with the jekyll template such as adding google analytics, disqus supporting and so on. We will discuss them in the future posts. Here we just talk about the base of building a blog. It's easy only if your have done it. Hope you enjoy it.

My Github:LinShiwei (Lin Shiwei) · GitHub

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容