如何快速搭建自己的github.io博客
要完成自己的github.io
博客网站,总共分三步:
1.开通自己的 github.io
repo
2.选择一款Jekyll的主题
3.编写发布博客
开通自己的 github.io
repo
github.io
是完全基于github创建的,其本质上是在你的github账户下创建一个特殊的repo。你可以参照如下步骤完成:
-
创建repo
当然,一切的前提是你得首先有个github的账户,这里还请自行解决。登陆你的账户后,你可以创建一个新的repo。请务必注意该repo的名字,必须保持格式<username>.github.io
,其中<username>
替换成你的github账户名,这里假定创建的repo为onepiece90.github.io
-
把你创建的repo clone到本地
本文假定你已经有一定的git
使用基础了,如果没有也没关系,Google一下.
$ git clone https://github.com/niik/niik.github.io
- 编写简单的博客首页
$ cd onepiece90.github.io
$ echo “Hello World!” > index.html
$ git add index.html
$ git commit -m “Init commit”
$ git push origin master
- 打开博客网站
https://<username>.github.io
不出意外,你就可以看到你的Hello World!
博客首页了。如果不小心出了意外,通常情况下,你只需等一会再刷新就会好.
选择一款Jekyll
的主题
github.io
默认采用Jekyll
作为建站工具。Jekyll是一款当前火热的开源的静态网站建站工具,拥有非常庞大的使用群里和社区,其Github截止本文,已经有超过3W+的star,拥有丰富的插件,丰富的主题,并且有无数的人已经帮你早出了无数的轮子可供参考。Jekyll自身的强大功能已经足够你打造自己心仪的静态网站
(这里注意的是静态网站
,Jekyll
没有任何的后台数据库),然而前提是你自己还是得有一定的前端功底,而为了不至于长的太难看,你还得有一定的设计能力。这一下子把大部分人给难住了,咱们只是为了单纯的写写博客啊,至于有这么多要求吗?看到这里,很多人可能觉得此法不怎么方便啊,然则,正如刚刚反复强调的,Jekyll
已经有一个非常庞大的社区,这就意味着,你完全可以借鉴别人已经造好的轮子,放在Jekyll
这里,咱们应该成为主体(Theme)比较合适。本文推荐国内用户可以考虑一款国人开发的主题。博主的个人博客即是采用了这个主题。
-
Fork出自己的repo
为了便于管理,建议先把Huxpro fork到自己的账户下 -
clone主题
$ git clone git@github.com:keysaim/huxpro.github.io.git
- 当然,你也可以直接clone它的样板repo
$ git clone git@github.com:Huxpro/huxblog-boilerplate.git
- 添加自己的
github.io
git repo
clone了huxpro的repo之后,需要将自己创建的github.io repo设置到clone的reporepo:
$ cd huxpro.github.io
$ git remote add mine git@github.com:keysaim/keysaim.github.io.git
其中,请自行将其中的repo url换成你自己的。
- 修改必要的配置
clone之后的repo其实是Huxpro自己的博客网站,里面有非常多作者自己的博文,可根据自己的需要进行必要的删减。基于Jekyll的博客网站,对于配置,非常重要的一个文件是_config.yml文件,代开这个文件进行必要的修改:
Site settings
title: Jxx Blog
SEOTitle: 金的博客 | Jxx Blog
header-img: img/home-bg.jpg
email: hzxx9123@163.com
description: “”
keyword: “”
url: “http://onepiece1991.github.io”
…
编写发布博客
Jekyll
对于博文,都是要求放在_posts
目录下面,同时对博文的文件名有严格的规定,必须保持格式YEAR-MONTH-DAY-title.MARKDOWN
,通常情况下,咱们采用推荐的Markdown
撰写博文,基于该格式,本博文的文件名为2017-08-15-how-to-setup-your-github-io-blog.md
。
写好博文之后,就可以通过git
提交博文了:
$ git add _posts/2017-08-15-how-to-setup-your-github-io-blog.md
$ git commit -m “Add how to setup your github.io blog”
$ git push mine master
其中,mine
就是前面设置的你自己的repo。等一会(通常几秒到几十秒不等),就可以打开自己的博客网站查看博文了,这里是我的博客网站https://onepiece1991.github.io/。push成功之后,最好是再重新将自己的repo clone到本地。
注:博主是下载了GitHub Desktop然后将github.io repo clone到本地,然后通过GitHub Desktop上传的
本文转自:窗外蟋蟀的博客
git学习:
git学习二:git初级使用教程