hexo是一个台湾人做的基于Node.js的静态博客程序,优势是生成静态文件的速度非常快,支持markdown, 我最终选定它的原因是它速度快而且不容易出错,并且可以一键部署到github或者其它静态服务器上去。
安装
我这个教程hexo3版本,本地使用Windows10系统,在sublime Text上面写Markdown的博客,爽歪歪。
安装依赖软件
Node.js: node.js用来创建hexo博客框架的
如果是windows系统,可以直接下载安装文件安装。如果是linux系统,可以使用下面的命令行:
wgethttps://nodejs.org/dist/v6.10.0/node-v6.10.0.tar.gz
tar xzvf node-v && cd node-v
yum install gcc gcc-c++
./configure –prefix=/usr/local/nodejs
make && make install #这步时间很久20分钟
node –version # 如果命令找不到就将/usr/local/nodejs/bin加入PATH中
最新的node.js已经集成了npm,不过需要经常更新:
npm install npm@latest -g
npm –version
换淘宝源
npm install -g cnpm –registry=https://registry.npm.taobao.org
之后使用cnpm命令代替npm命令,或者你直接通过添加 npm 参数 alias 一个新命令:
alias cnpm="npm –registry=https://registry.npm.taobao.org\
–cache=$HOME/.npm/.cache/cnpm \
–disturl=https://npm.taobao.org/dist\
–userconfig=$HOME/.cnpmrc"
安装Git客户端: 把本地的hexo内容提交到github上去
安装Hexo
利用 npm 命令即可安装。打开窗口控制台,输入安装hexo命令:
cnpm install -g hexo
初始化
安装完成后,在你喜爱的文件夹下(如D:\Work\hexo),控制台执行以下指令,hexo会自动在目标文件夹建立网站所需要的所有文件。
hexo init
安装依赖包:
cnpm install
验证下,在D:\Work\hexo内执行以下命令:
hexo g #用于生成静态文件
hexo s #用于启动本地服务进行测试
然后用浏览器访问http://localhost:4000, 此时,你应该看到了一个漂亮的博客了,当然这个博客只是在本地的,别人是看不到的,hexo3.0使用的默认主题是landscape。
部署到github
在github网站(https://github.com/ )申请一个账号。
创建repository
repository相当于一个仓库,用来放置你的代码文件。登陆进入Github,进入个人页面,选择repositories,然后New一个repository。
创建时,只需要填写Repository name(格式必须为yourname.github.io)即可。比如我的是tanjh.github.io
部署本地博客
github就是一个服务器而已,如果更换了服务器,只需要在更换后的服务器上创建一个git服务,然后将配置文件中的repository修改为新git服务器地址即可。
hexo配置
先修改D:\Work\hexo中的_config.yml文件,切记:hexo的配置文件中任何’:’后面都是带一个空格的
deploy:
type: git
repository:git@github.com:tanjh/tanjh.github.io.git
branch: master
hexo git发布模块配置
安装hexo-deployer-git模块:
npm install hexo-deployer-git –save
SSH配置
如果你是第一次使用Github或者是已经使用过,但没有配置过SSH,则可能需要配置一下SSH。
在Git Bash输入以下指令(任意位置点击鼠标右键),检查是否已经存在了SSH keys。
ls -al ~/.ssh
如果存在的话,直接删除.ssh文件夹里面所有文件
输入以下指令(邮箱就是你注册Github时候的邮箱)后回车,出现提示让你输入的时候一直按回车:
ssh-keygen -t rsa -C“xxxxx@qq.com“
然后键入以下指令:
eval `ssh-agent -s`
ssh-add
到了这一步,就可以添加SSH key到你的Github账户了。键入以下指令,拷贝Key到剪切板:
clip < ~/.ssh/id_rsa.pub
然后到Github网站中,点击右上角的设置图标Settings,找到SSH keys,Ttile随便你命名,Key就粘贴上刚才复制的key,然后点Add SSH key,最后会让你重新输入下gitHub的密码
键入以下命令测试一下:
ssh -Tgit@github.com
你可能会看到有警告,输入“yes”就好
部署到github
执行以下命令部署到Github上。
hexo g
hexo d
提示输入gitHub的账号密码,就能访问你得博客网站了。我的是: tanjh.github.io
发表文章
在D:\Work\hexo目录下面,控制台执行命令:
hexo new “Hello World”
会自动在D:\Work\hexo\source_posts文件夹生成一个hello-world.md文件,用编辑器打开,在里面写文章。
记住hexo中写文章使用的是Markdown语法,自己去google下这个语法吧,很方便很强大。里面的初始内容
title: Hello World #可以改成中文的,如“新文章”
date: 2016-03-06 16:04:09 #发表日期,一般不改动
categories: blog #文章文类
tags: [文章, 测试] #文章标签,多于一项时用这种格式,只有一项时使用tags: blog
—
#这里是正文,用markdown写,你可以选择写一段显示在首页的简介后,加上
,在之前的内容会显示在首页,之后的内容会被隐藏,当游客点击Read more才能看到。
写完文章后,你可以使用hexo g生成静态文件。hexo s在本地预览效果。hexo d同步到github
hexo主题及配置
如果你不喜欢默认主题,那么可以去hexo官网找更多的主题。
我这里选择NexT主题说明一下,这个是一个非常简洁的主题。
Next主题官网:http://theme-next.iissnan.com/
安装主题
$cd D:\Work\hexo
$ gitclonehttps://github.com/iissnan/hexo-theme-nextthemes/next
启用主题
修改D:\Work\hexo下的_config.yml配置文件中的theme属性,将其设置为next
更新主题
cd themes/next
git pull
更新好后,本地启动起来效果
hexo server -g#生成加预览
主题配置
具体配置请直接参考开始使用NexT主题。