1 概述
本博客基于Jekyll搭建个人博客作为模板创建而成,非常感谢作者!
2 准备工作
jekyll需要依赖ruby、msys、rubygem、bundle。基本安装步骤大致如下:
- 安装Ruby(最新的集成了gem、bundle)
- 安装msys
- 在msys里面使用如下命令更新相关数据库(相关的依赖的东西,必须要执行这步骤,不出意外基本上会失败):
pacman -Syu
- 运行如下命令安装jekyll(不出意外基本上会失败)
gem install jekyll
3 异常处理
这里软件的兼容性还是做得比较好的,唯独是因为有各种墙,数据无法获取。
3.1 配置gem源
要使gem能正常工作,需要配置gem的源(原始的https://rubygems.org/不能用)
对于国内常规用户,将源指向https://gems.ruby-china.com/即可,使用如下命令行:
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
gem sources -l
对于公司用户,受公司访问限制影响,如果要使用比较麻烦,需要找对应公司是否有提供镜像源链接 http://xxxx.xx.xxx,替换上述的https://gems.ruby-china.com,即可
3.2 配置bundle源
使用如下命令,配置bundle源
bundle config mirror.https://rubygems.org https://gems.ruby-china.com
对于公司受限用户,如果能找到对应镜像源链接,也参照gem的配置即可
3.3 配置msys源
msys的镜像源配置,不是通过命令进行的,需要了解几个关键文件。
- 文件1:C:\msys64\home\keenjin\.bashrc(配置代理)
export ALL_PROXY=http://web-proxy.xxxxxx.com:8080 export HTTP_PROXY=http://web-proxy.xxxxxx.com:8080 export HTTPS_PROXY=https://web-proxy.xxxxxx.com:8080 export http_proxy=$HTTP_PROXY export https_proxy=$HTTPS_PROXY export ftp_proxy=$http_proxy export rsync_proxy=$http_proxy export no_proxy=localhost,.xxx.com
- 文件2:C:\msys64\etc\pacman.d\mirrorlist.msys(配置源)
Server = http://mirror-xxx.xxx.com/msys2/msys/$arch/ Server = http://repo.msys2.org/msys/$arch/ Server = https://sourceforge.net/projects/msys2/files/REPOS/MSYS2/$arch/ Server = http://www2.futureware.at/~nickoe/msys2-mirror/msys/$arch/ Server = https://mirror.yandex.ru/mirrors/msys2/msys/$arch/
- 文件3:C:\msys64\etc\pacman.d\mirrorlist.mingw32(配置源)
Server = http://mirror-xxx.xxx.com/msys2/mingw/i686/ Server = http://repo.msys2.org/mingw/i686/ Server = https://sourceforge.net/projects/msys2/files/REPOS/MINGW/i686/ Server = http://www2.futureware.at/~nickoe/msys2-mirror/mingw/i686/ Server = https://mirror.yandex.ru/mirrors/msys2/mingw/i686/
- 文件4: C:\msys64\etc\pacman.d\mirrorlist.mingw64(配置源)
Server = http://mirror-xxx.xxx.com/msys2/mingw/x86_64/ Server = http://repo.msys2.org/mingw/x86_64/ Server = https://sourceforge.net/projects/msys2/files/REPOS/MINGW/x86_64/ Server = http://www2.futureware.at/~nickoe/msys2-mirror/mingw/x86_64/ Server = https://mirror.yandex.ru/mirrors/msys2/mingw/x86_64/
3.4 生成blog以后,jekyll serve异常
这里的异常,往往是因为gemfile和gemfile.lock跟当前环境不匹配导致的,某些版本号不一样了。这里需要重新运行如下bundle install,安装各种依赖的库(由于前面设置了bundle的安装源,所以这里就不会有问题了,要是没有可访问的镜像源,可能还是异常的)
4 总结
凡是无法执行成功,都可能是安装源失败。linux有个比较好的点,所有的依赖,都在安装的时候自动去下载安装
5 评论系统
本文首先尝试使用的评论系统,是github官方的gitment,具体过程,是参考Jekyll博客添加Gitment评论系统
但是试用之后,发现,gitment系统已经停止服务了,需要自己搭建服务器去搞,就算了,换做valine评论系统,这个更加轻量级,不需要像gitment一样需要用github账号登录。
具体添加方式,依旧是在_include\comments.html里面修改,增加如下:
{ % if site.valine_comment.enable % }
<div id="valinecomments"></div>
<script src="//cdn1.lncld.net/static/js/3.0.4/av-min.js"></script>
<script src="//unpkg.com/valine/dist/Valine.min.js"></script>
<script>
new Valine({
el: '#valinecomments',
app_id: { { site.valine_comment.leancloud_appid } }, //这里变量的取值在网站配置文件里_config.yml
app_key: { { site.valine_comment.leancloud_appkey } }, //这里变量的取值在网站配置文件里_config.yml
placeholder:{ { site.valine_comment.placeholder } } //这里变量的取值在网站配置文件里_config.yml
});</script>
{ % endif % }
另外,需要在_config.yml中分配配置app_id、app_key、placeholder。这三者,是从leancloud上注册生成的,具体参照步骤https://valine.js.org/quickstart.html中进行。 _config.yml中配置如下:
valine_comment:
enable: true
leancloud_appid: xxxxxxxxxxxxx-xxx # app_id
leancloud_appkey: xxxxxxxxxx # app_key
placeholder: "欢迎提出您的宝贵意见" # placeholder
6 本地启动jekyll
jekyll serve