Robotkang

欢迎走进我的世界

科技、生活、音乐、人生


Jekyll+Github个人博客构建之路

copyright 版权声明:本文为博主原创文章,未经博主允许不得转载。 原文地址:https://robotkang.cc/1733.html

本博客的搭建真是历经了千辛万苦、一步一坑啊。

参考博客

说在前面的话 💯

  • 我们需要做很多事情。包括环境配置,账号注册,域名购买(不是必须)等。之前一直想搞一个属于自己的博客,16年我以16元的价格买了一个域名「话说域名的续费有点小贵啊..」并且用python搭了一个离线的博客之后就不了了之了「关键部署太麻烦..」。直到前几又萌生出了搭建博客的心思,才又重新搞起。好在,经过几天的瞎搞,弄出来了。

几个关键内容

  • Jekyll
    • Ruby
    • DevKit
    • Pygments
    • Python
  • Github
    • 账号
    • 客户端
  • 域名
  • 网站统计
    • 百度
    • google
  • 多说评论系统

一步一步建立自己的小站

建立github

  • 注册github。

  • 建立仓库。仓库名为<用户名>.github.io,详细请参看该博客github建立个人博客

  • 上述都是在github网页中操作。为了后续测试及更新博客的方便安装github客户端。

域名等设置

  • 我是在阿里云网站购买。也可以去其他地方。注册用户,挑选合适的域名,付款(支付宝,比较方便)。然后需要域名空间绑定,找域名服务器管理商进行管理。

  • 图床用了七牛家的。免费版的目前够用,放一些图片比较方便

Windows上安装Jekyll「也可用linux」

  • 参考:Windows 上安装 Jekyll。安装好Jekyll后。打开github客户端,登录。将之前建立的仓库clone到本地。例如我的:dearLilian.github.io, clone到d://lilian/下。就会看到d://lilian/下出现了一个名为dearLilian.github.io的文件夹。

网站评论与统计

  • 首先是网站统计,你需要在百度统计Google Analytics注册账号,并提取相应的id(详细操作请baidu or google)例如我的baidu id为e572ae9801b3a18891f123796b889f77,google id为UA-88738012-1,后面会使用。
  • 其次是网站的评论管理系统,多说(点击我要安装)上注册账号,设置域名。比如我的是www.robotkang.duoshuo.com。即多说的用户名为robotkang(后面会用到) 多说已挂!现本网站使用的是Valine评论系统,详情参考:https://valine.js.org/#/

选择博客模板

  • 例如,我选择了baixin的博客模板。如果大家喜欢,可以将这个download下来。也可以去我的github上fork我的。

将模板修改为自己的博客

  • 将上述模板下载后,解压。并将leopardpan.github.io-master里面的文件copy到kangblog.github.io文件夹里。此时,如果你打开Jekyll服务,即:命令行模式输入
cd d://zhijun/kangblog.github.io
jekyll serve

然后浏览器打开:localhost:4000,此时就能看到原作者(baixin)的博客。

那么现在来修改模板,呈现你的东西吧。(为了方便编辑各种格式的文件,建议事先安装sublime Text)

工作路径:d://zhijun/kangblog.github.io

1、修改配置文件

首先打开_config.yml文件.修改你想修改的地方。

需要修改的项目包括:

  • titile:你的博客标题

  • subtitle:你的博客子标题
  • description:你的博客描述
  • avatarTitle:你的头像里的标题
  • avatarDesc:你的头像描述
  • url:改成你的域名
  • comment里的duoshuo:改成你的多说的用户名
  • social里面的
    • weibo:你的微薄id(不是用户昵称)
    • github:你的github用户名
    • mail:你的邮箱
    • 其他的可以补充,没有的可以不写,将原文中的删除即可
  • baidu: id:你的百度统计的id
  • ga: id:你的Google Analytics的id

2、修改域名配置文件CNAME

修改为你自己的域名,如:robotkang.cc如果没有直接清空(后面访问时,直接访问自己的github page即可)

3、修改个人文件about.md

这里也应该修改为你自己的介绍。(要求会基本的markdown语法。)

4、头像

如果你想使用自己的头像,那么请打开images文件夹,将你自己的头像图片放在该文件夹,并重命名为avatar.jpg

5、网站图标

如果你想使用自己的个性网站图标,同样的将你的图标图片放在该文件夹,并重命名为favicon.png

6、博客文章

最后就是你的博客内容。请打开_posts文件夹,可以把原来的文件都删除掉,然后编辑你自己的博客。

这里面,你在新建博客时必须包含前6行的内容,其中title后写你自己的博客标题,date后写你自己的时间(但格式要保持一致),tag后写你自己的标签。后面的内容则是markdown语法的内容。 将上述文件保存,命名为:2016-08-04-MyFirstBlog.md

此时重新启动jekyll服务

shell

cd d://zhijun/kangblog.github.io
jekyll serve

然后打开localhost:4000,打开博客主页,就可以看到你刚刚发布的这篇博客了。

博客上线

之前的操作都是在本地,剩下最关键的一步啦。就是在github客户端将这些changes统统commit并sync到服务端。详细请查询github如何commit以及sync(客户端就点击几下就ok了)。用git shell的话使用如下命令:

git commit -a
git push

当同步完成后,在浏览器输入你的域名,比如我的是:robotkang.cc,然后就能看到你的博客了。任何人都可以看到哦。

掉进过的那些坑

关于jekyll

  • 在启动jekyll时候,由于gemfile中需要的gem没有安装好,或者有依赖的没有安装,总会报错。解决办法是在官网上查询好依赖关系,依次安装好。
  • 其次,项目中所需要的gem必须都要在gemfile中声明好,否则启动服务失败。

关于github提交冲突的问题

  • 发生冲突后,会发现冲突的文件会出现两种内容,当然会有一定的标志。这时候需要将你不需要的那个版本(以及冲突的那个标志)去掉。具体还需要去进一步学习github的相关内容。

后续学习

版本控制git

  • 因为需要经常更新博客。而且不只在一个终端。所以要学习好git来更熟练的操作。

markdown

  • 博客的内容基本采用markdown编写,需要熟知markdown语法才能写出更美观的博客。

HTML,CSS

  • 觉得现在的模板太丑了?那你要学习怎么去设置及设计更符合你审美的博客外观。

jekyll,ruby

  • 本博客是基于jekyll搭建的,然而到现在我还是不太知道jekyll到底是个啥。同时jekyll是基于ruby的,哦,ruby我知道是个编程语言。然而不知道怎么编,那还是去学习一下基本语法及常见应用场景吧。

搜索

  • 我还想给自己的博客添加一个搜索功能。后续再想想怎么做吧。

结束语

由于我也是个菜鸟新手。所以如果大家有什么问题的话,可以留言,也可以email(robotkang@foxmail.com)我,请教谈不上,大家一起探讨。

本文转载自Lilian,后稍加改之。特此声明!

最后编辑时间为: Dec.18, 2019 at 06:02 pm




R
支付宝打赏 微信打赏

如果文章对你有帮助,欢迎点击上方按钮打赏作者



Valine - A simple comment system based on Leancloud.