本来没打算写这篇博客的,以为这些东西弄成功就算是会了,但当我想打开jekyll服务器的时候,突发现我已经忘记JEKYLL是怎么下载怎么使用的了。仔细想了想,当初安装的时候也是经历了不少曲折的,看了不少文章才解决的。由此可见记录的重要性,只有记录了下来,当忘记的时候才能方便的查看,而不用问度娘或者一遍一遍的翻看着官网的文档了。
首先是Jekyll,虽然我已经没有使用Jekyll了,但Jekyll相较HEXO也是有着优点的,万一以后想用了呢?故此还是记录下来吧。
其实Jekyll并不是一定需要安装,GitHub使用的就是Jekyll,我们只需要在本地编写符合规范的网站源码,然后上传到username.github.io仓库中,就可以由github生成并托管整个网站了。安装Jekyll后,就能在本地搭建一个简单的服务器,
然后访问 http://localhost:4000/ 就能看到blog的界面了。
Jekyll的安装
首先是Jekyll官网,官网的帮助是非常大的。
Jekyll官网上说并不建议在Windows系统安装,但其实也是很好安装的。
安装ruby
jekyll是基于ruby的,因此在安装jekyll之前得首先要安装ruby。
ruby下载网站
根据自己电脑的情况选择合适的版本下载安装即可。
下载后双击进行安装,安装目录随意,但仔细看一下安装选项,注意将ruby命令添加到PATH变量下,使ruby命令能够在任何目录下进行使用。
安装完成后,打开cmd窗口或者其他shell窗口,用ruby -v测试一下,看看能不能输出ruby的版本号。
安装Ruby DevKit
DevKit 是windows平台下编译和使用本地C/C++扩展包的工具。它就是用来模拟Linux平台下的make, gcc, sh来进行编译。切换到刚才的下载页面,拉倒最下面,找到“DEVELOPMENT KIT”,然后选择合适的版本进行下载:
devkit的安装过程比较简单,选择你要安装的路径,直接进行下一步就可以了。安装成功后,使用gem -v测试是否安装成功。
安装成功后,运行如下两个命令:
ruby dk.rb init
ruby dk.rb install
安装jekyll
gem install jekyll
这是官方给的指令,但因为某些特殊的原因,我们直接使用rubygems的官方链接会特别特别的慢。不过庆幸的是,国内的淘宝有rubygem的镜像:
gem sources --remove https://rubygems.org/ // 删除官方链接
gem sources -a https://ruby.taobao.org/ // 添加淘宝镜像链接
gem sources -l // 查询是否替换成功
在一串的提示命令之完成之后,就可以用jekyll -v测试jekyll是否安装成功了,如果能够输出版本号,就说明安装成功了。
Jekyll的使用
Jekyll的配置先跳过,但具体的文章结构要跟配置文件相符。
创建文章
使用代码或者直接在_posts的目录下创建.md文件
jekyll new my-awesome-site
写作
恩,Markdown语法。
开启本地服务器
cd my-awesome-site //进入站点目录
jekyll serve
之后会显示一些信息,复制Server address,粘贴到浏览器就可以看到blog的界面了。
按下ctrl-c就可以关闭服务器了。
部署方法
直接打开GitHub,选择仓库然后Commit、Sync同步即可。博客网址为 username.github.io 。
HEXO的安装
HEXO的安装非常简单。本网站正在使用的就是HEXO,关于HEXO与Jekyll,可以参看下面这段话。
一个是Ruby写的jekyll,一个是node-js写的hexo。至于区别的话,hexo生成静态页面的速度要比较快,jekyll是把原文上传github,可以直接生成博客,也可以用在线编辑器处理,hexo是本地生成html再上传。至于用哪个可以自己两个都尝试一下,哪个用的爽用哪个咯
安装Git
这肯定是必须的,电脑里要有GitHub与Git shell。去GitHub官网下载,会同时安装GitHub desktop与Git shell,各有各的好处,可以配合起来使用。
安装Node.js
下载安装即可。
安装Hexo
所有必备应用程序安装完成后,即可使用npm安装Hexo。
在开始菜单找到Node.js command prompt ,输入如下命令:
npm install -g hexo-cli
HEXO的使用
HEXO的配置同样跳过,这不是本篇的重点,具体的文章结构也要跟主题与配置文件相符。
创建文章
使用代码或者直接在source/_posts中创建.md文件
hexo new "postName" #新建文章
其实是 $ hexo new [layout] <title> layout默认为post
layout有三种默认布局:post、page、draft
写作
恩,Markdown语法。
生成与部署
cd my-awesome-site //进入站点目录
生成
hexo generate #生成静态页面至public目录
开启本地服务器
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
更新资料
有时资料可能没有被更新,或是生成的文件与修改前的相同,可以尝试清除缓存并再执行一次。
hexo clean
部署
hexo deploy #将.deploy目录部署到GitHub
可以同时使用Coding与GitHub,需要先安装deployer-git
npm install hexo-deployer-git --save
然后在_config.yml中配置一下deploy就可以,配置不是本篇重点,具体还是看看官方文档吧。