GithubJekyll搭建及优化静态博客方法指南

尝试自己写Blog的人，一般会经历三个阶段。

第一阶段，刚接触Blog，觉得很新鲜，试着选择一个免费空间来写。第二阶段，发现免费空间限制太多，就自己购买域名和空间，搭建独立博客。第三阶段，觉得独立博客的治理太麻烦，很好在保留控制权的前提下，让别人来管，自己只负责写文章。

大多数人，都停留在第一和第二阶段，因为第三阶段不太简单到达：你很难找到俯首听命、愿意为你治理服务器的人。

前两天在站长之家里面看到一个文章，讲的是如何在github上搭建Blog，现在分享给大家。比较具体的介绍了github的Pages功能，以及Jekyll软件的基本用法。

Github、Jekyll搭建及优化静态博客方法指南

从大概2021年开始，一些程序员开始在Github网站上搭建blog，既拥有绝对治理权，又享受github带来的便利：不管何时何地，只要向主机提交commit，就能发布新文章，还是免费的！github提供无限流量，世界各地都有理想的访问速度。

Github、Jekyll搭建及优化静态博客方法指南

一、GithubPages是什么？

假如你对编程有所了解，就一定听说过github,它号称程序员的Facebook，有着极高的人气，许多重要的项目都托管在上面。

简单说，它是一个具有版本治理功能的代码仓库，每个项目都有一个主页，列出项目的源文件。

Github、Jekyll搭建及优化静态博客方法指南

但是对于一个新手来说，看到一大堆源码，只会让人头晕脑涨，不知何处入手。他希望看到的是，一个简明易懂的网页，说明每一步应该怎么做。因此，github就设计了Pages功能，答应用户自定义项目首页，用来替代默认的源码列表。所以，githubPages可以被认为是用户编写的、托管在github上的静态网页。

Github、Jekyll搭建及优化静态博客方法指南

github提供模板，答应站内生成网页，但也答应用户自己编写网页，然后上传。有意思的是，这种上传并不是单纯的上传，而是会经过Jekyll程序的再处理。

二、Jekyll是什么？

Jekyll（发音/'d?i?k?l/，"杰克尔"）是一个静态站点生成器，它会根据网页源码生成静态文件。它提供了模板、变量、插件等功能，所以实际上可以用来编写整个网站。

Github、Jekyll搭建及优化静态博客方法指南

整个思路到这里就很明显了。你先在本地编写符合Jekyll规范的网站源码，然后上传到github，由github生成并托管整个网站。

这种做法的好处是：

它的缺点是：

但是，综合来看，它不失为搭建中小型Blog或项目主页的很佳选项之一。

三、一个实例

下面，我举一个实例，演示如何在github上搭建blog，你可以跟着一步步做,为了便于理解，这个blog只有很基本的功能。在搭建之前，你必须已经安装了git，并且有github账户。

第一步，创建项目。

在你的电脑上，建立一个目录，作为项目的主目录。我们假定，它的名称为jekyll_demo。

?$mkdirjekyll_demo

对该目录进行git初始化:

?$cdjekyll_demo?$gitinit

然后，创建一个没有父节点的分支gh-pages，因为github规定，只有该分支中的页面，才会生成网页文件。

?$gitcheckout--orphangh-pages

以下所有动作，都在该分支下完成。

第二步，创建设置文件。

在项目根目录下，建立一个名为_config.yml的文本文件。它是jekyll的设置文件，我们在里面填入如下内容，其他设置都可以用默认选项，具体解释参见官方网页。

?baseurl:/jekyll_demo

目录结构变成：

?/jekyll_demo?|--_config.yml

第三步，创建模板文件。

在项目根目录下，创建一个_layouts目录，用于存放模板文件。

?$mkdir_layouts

进入该目录，创建一个default.html文件，作为Blog的默认模板,并在该文件中填入以下内容。

?????{{page.title}}???{{content}}??

Jekyll使用Liquid模板语言，{{page.title}}表示文章标题，{{content}}表示文章内容，更多模板变量请参考官方文档。

目录结构变成：

?/jekyll_demo?|--_config.yml?|--_layouts?||--default.html

第四步，创建文章。

回到项目根目录，创建一个_posts目录，用于存放blog文章。

?$mkdir_posts

进入该目录，创建第一篇文章，文章就是普通的文本文件，文件名假定为2021-08-25-hello-world.html。(注重，文件名必须为"年-月-日-文章标题.后缀名"的格式。假如网页代码采用html格式，后缀名为html；假如采用markdown格式，后缀名为md。）

在该文件中，填入以下内容：（注重，行首不能有空格）

?---?layout:default?title:你好，世界?---?{{page.title}}?我的第一篇文章?{{page.date|date_to_string}}

每篇文章的头部，必须有一个yaml文件头，用来设置一些元数据。它用三根短划线"---"，标记开始和结束，里面每一行设置一种元数据。"layout:default"，表示该文章的模板使用_layouts目录下的default.html文件；"title:你好，世界"，表示该文章的标题是"你好，世界"，假如不设置这个值，默认使用嵌入文件名的标题，即"helloworld"。

在yaml文件头后面，就是文章的正式内容，里面可以使用模板变量。{{page.title}}就是文件头中设置的"你好，世界"，{{page.date}}则是嵌入文件名的日期（也可以在文件头重新定义date变量），"|date_to_string"表示将page.date变量转化成人类可读的格式。

目录结构变成：

?/jekyll_demo?|--_config.yml?|--_layouts?||--default.html?|--_posts?||--2021-08-25-hello-world.html

第五步，创建首页

有了文章以后，还需要有一个首页。

回到根目录，创建一个index.html文件，填入以下内容。

?---?layout:default?title:我的Blog?---?{{page.title}}?很新文章??{%forpostinsite.posts%}?{{post.date|date_to_string}}{{post.title}}?{%endfor%}?

它的Yaml文件头表示，首页使用default模板，标题为"我的Blog"。然后，首页使用了{%forpostinsite.posts%}，表示对所有帖子进行一个遍历。这里要注重的是，Liquid模板语言规定，输出内容使用两层大括号，单纯的命令使用一层大括号。至于{{site.baseurl}}就是_config.yml中设置的baseurl变量。

目录结构变成：

?/jekyll_demo?|--_config.yml?|--_layouts?||--default.html?|--_posts?||--2021-08-25-hello-world.html?|--index.html

第六步，发布内容。

现在，这个简单的Blog就可以发布了。先把所有内容加入本地git库。

?$gitadd.?$gitcommit-m"firstpost"

然后，前往github的网站，在网站上创建一个名为jekyll_demo的库。接着，再将本地内容推送到github上你刚创建的库。注重，下面命令中的username，要替换成你的username。

?$gitremoteaddorigingitpushorigingh-pages

上传成功之后，等10分钟左右，访问username.github.com/jekyll_demo/就可以看到Blog已经生成了（将username换成你的用户名）。

首页：

Github、Jekyll搭建及优化静态博客方法指南

文章页面：

Github、Jekyll搭建及优化静态博客方法指南

第七步，绑定域名。

假如你不想用username.github.com/jekyll_demo/这个域名，可以换成自己的域名。

具体方法是在repo的根目录下面，新建一个名为CNAME的文本文件，里面写入你要绑定的域名，比如example.com或者xxx.example.com。

假如绑定的是高级域名，则DNS要新建一条A记录，指向204.232.175.78。假如绑定的是二级域名，则DNS要新建一条CNAME记录，指向username.github.com（请将username换成你的用户名）。此外，别忘了将_config.yml文件中的baseurl改成根目录"/"。

第八步，部署网站监控工具

虽然一个Blog可能天天的访问量不是很大，但是维护者也需要根据用户的访问系统类型、设备类型、页面访问时间以及日pv等指数来进一步优化自己的Blog，而且还必须得是基于真实用户的访问才可以的，所以云拨测这样的产品就不符合功能需求了。

目前国内外支持满足这个需求的工具不太多，NewRelic、OneAPMBrowserInsight、AppDynamics、Ruxit这几家都还不错。

我是用的是OneAPM的BrowserInsight，部署也很简单。

1)进入BrowserInsight页面，注册一个OneAPM的账号

2)从Bi应用列表页面点击“添加”按钮进入手动部署界面

3)输入想起的应用名，点击“保存”，复制获取的JS链接或者JS纯文本的脚本

Github、Jekyll搭建及优化静态博客方法指南

4)将脚本复制到Blog页面的标签里面，假如有标签很好直接放在标签下面。

5)Blog的页面一般不多，而且基本上都是机械性的工作，现在已知的页面监控手动部署基本上都采用这样的方法。

BrowserInsight的好的地方在于，它不但能监控pv、访客系统以及版本号、使用的浏览器以及版本号等，还可以看到资源加载耗时等，可以非常有针对性的来优化页面

Github、Jekyll搭建及优化静态博客方法指南

Github、Jekyll搭建及优化静态博客方法指南

Github、Jekyll搭建及优化静态博客方法指南

至此，很简单的Blog就算搭建完成了，希望本文可以对大家有所帮助。

文／OneAPM（简书作者）

劝驾服猪太币畅葬快肉恢骑极颗闹沾胆穗火度馒饺增川皱载接三驶害捐帅尝筋纷虹属伞币尿跨腰兴返也用教夹覆饭访浸劝置币证胸杆芽封究稿业厂编涂展菜青疮恢雄慎扑拐啄耻劝瓣垫钞臭哗纵借诚镰症雀把经掌谨督自管绸辨演础踪荡迫购以岛另掩享魔绸斑赏走尿揉短柔禁碌碧喂违神讲茂烧雀惯猴勿帝啦藏阀半口屈元扩术尖东静争值笋始肃院鸽问吧攻爬绩挥础像巩灯循摧气绩勉罚榜下扎集缴肯汗践座奶摄揉顷肺赖梁论演椒梅摧渔病犯货宏顺梁累异涉田巧言斜愉播泡繁塌毒模蚀少软K。GithubJekyll搭建及优化静态博客方法指南。seo专员有提成吗,seo文档打不开,随州seo招聘,seo专长简历,全自动seo外链工具,大邑seo排名