14

jekyll博客教程

git page

git page 你可以理解成为一个静态的远程html文件提供商(提供者是GitHub),因为动态的提供商其实是服务器提供商(数据库是你自己的,他只提供了服务器)。静态提供商因为只用提供一些竟然文件,占用的空间不大,所以一般会免费提供,而动态提供商需要负担你网站的静态文件,还有动态文件,所以占用空间大,一般是不免费的。

Jekyll / Hexo

在区别它们两个之前,你得先了解一下,它们两个究竟是什么, 这两个博客系统其实是帮你更好的完成你的博客的两个系统。比如说,一些简单的分类,博客主题等简单的功能都是它们提供的,具体的表现形式为:一个个文件夹。

其实这两者的区别主要就是在于它们都是由不同的方式实现的,你可能在网上会看到这两种方式会迷惑,其实就只是两种不同的博客提供商,他们有自己不同的博客实现。再一个重要的不同之处在于,github 只支持Jekyll这个博客系统,所以当你的github仓库为点击查看示例这种形式的目录的时候,github会直接识别,然后渲染等一些操作,形成你的博客。

第一部分:给你的 github 账户创建 博客域名

  • 先看看这个首页,看一下里面关于User or Organazition SiteProject Site的区别。虽然我感觉本质上都是仓库而已,区别只是一个域名会是username.github.io,而另一个则会是username.github.io/some-project/。对于你来说,User Site这种方式就已经足够了。

  • 安装git,git的功能不用我多说,你应该已经知道了。直接到git下载页面,进行下载就可以了。接下来就是git的使用了。

  • 选择一个你想存放你的目录的地方,在那个路径下右键 打开gitbash(当然,这一步需要你配置一下你的github账户名,如下):

    1. git config --global user.name "LiJunYao"
    2. git config --global user.email "lijunyao@gmail.com"
  • 如果你已经配置了,那就不用执行上一步。然后git clone https://github.com/username/username.github.io,这个时候,你会在当前的目录下发现一个名为username.github.io的文件夹,这个文件夹就是你个人博客中,所有博客的目录所在地。当然了,如果想要在网页上显示,你还需要将他推送至远程的库中。如果还不会使用git,参考这个教程。如果还不会,别说我认识你。

  • 上面那个步骤你可以在gitpage这个页面上看到,按照它的提示操作就可以。然后在输入你的lijunyao.github.io查看一下是否有hello world的页面。

  • 至此,你的github 博客域名算是好了。到了这一步,你应该已经掌握了git 常用命令,仓库概念。

第二部分:安装使用 Jekyll

之前说过,Jelly是一个博客提供系统,并且由于GitHub只支持这个博客系统,所以我建议你先使用这个,等以后熟练了或者想提升一下Geek属性了,在去接触Hexo博客系统。Jelly的简介,点击网址先看一下,还有它的安装之前的一些要求,以利于理解下一步为什么要安装这些东西。

  • Ruby-Install页面下载,安装即可。然后再命令行cmd,或者打开git bash,输入ruby -v. 如下:
$ ruby -v
ruby 2.3.0p0 (2015-12-25 revision 53290) [x64-mingw32]
$ gem -v
2.5.1

即表明正确安装了。

方式1: 可选的安装 Bundler

  • 命令行输入 gem install bundler安装Bundler。这是一个ruby的依赖管理,虽然听着很高大上。简单说: 通过gem是可以完成安装Jeklly的工作的。但是,gem是不适合用来团队协作的,而如果使用Bundler,则适合团队的开发,然后用Bundler安装依赖就可以了。当然了,你了解就可以了。

在安装过程中可能会报错,翻译过来就是,远程主机拒绝你的请求,这是因为它们用的是https协议,需要进行认证。比较方便的解决方式是:

$ gem sources #查看当前使用的是那个网站的资源
$ gem sources --remove [网址] # 第一步中显示的那个网址
$ gem sources -a https://gems.ruby-china.org
$ bundle config mirror.https://rubygems.org https://gems.ruby-china.org
  • 在你的本机博客目录下创建一个Gemfile文件,内容为: txt source 'https://rubygems.org' gem 'github-pages'
关于windows报错SSL的问题

由于现在很多网站都已经改为https协议,所以,需要有SSL证书,但是ruby没有自带的ssl证书,你在命令行中如果输入bundle install就会报错。解决方案如下:

  • 获取cacert.pem证书,点击这里,将证书下载到C:\Ruby23-x64\lib\目录里面。

  • 在环境变量里面设置,在环境变量中添加一个键值对 SSL_CERT_FILE=C:\RailsInstaller\cacert.pem 嗯类似于这样子的。

  • 完成以后,重新启动命令行,然后再次输入bundle install

  • 结果如下:

    Thank you for installing html-pipeline!
    You must bundle Filter gem dependencies.
    See html-pipeline README.md for more details.
    https://github.com/jch/html-pipeline#dependencies
    -------------------------------------------------
    Post-install message from github-pages:
    ---------------------------------------------------
    Thank you for installing github-pages!
    GitHub Pages recently upgraded to Jekyll 3.0, which
    includes some breaking changes. More information:
    https://github.com/blog/2100-github-pages-jekyll-3
    ---------------------------------------------------
    

方式2: 通过GEM直接安装jekyll

我也是在六月的最后一天好好回顾了一下早上写的东西,发现,你可以根本不用方式1安装,阿西吧。参考网址 HERE

$ gem install jekyll             #对,就是这么简单粗暴
$ jekyll new .  --force         #它们之间是以空格分开的,目录是在你之前的创建的那个  lijunyao.github.io 的目录
$ jekyll serve                      #在http://localhost:4000查看样式
$ jekyll build                      # 将当前的文件夹中的.md,.html 等文件转换到_site文件夹里,所以你可以直接使用markdown的格式来写博客

如果你已经有主题了

其实上面那部分主题你完全可以不看,因为如果你只要有相中的主题,那么可以直接fork过来,然后修改修改配置就可以了。

socket封装