Hexo是一个快速、简洁且高效的博客框架。Hexo使用Markdown解析文章,在几秒内,即可利用靓丽的主题生成静态网页。本文介绍如何在Mac以及Windows上搭建Hexo,Linux用户也可以参考。网上关于Hexo的教程也比较多,但大都会让读者在一两个点上卡住。综合官网教程以及自己在安装过程中遇到的问题写下了本教程,一步一步来就可以无痛安装。
使用Hexo搭建的个人博客网站:
zhaoshuo.me
安装Hexo
安装Nodejs
Mac用户和Windows用户安装比较简单,直接下载Node.js按照默认配置安装即可。Linux用户下载编译后的文件解压后即可使用(在其bin文件夹下有npm和node的命令工具)。为了方便起见,Linux用户还需要使用ln命令将node和npm设为全局生效:
$ ln -s /解压目录/bin/node /usr/local/bin/npm
$ ln -s /解压目录/bin/npm /usr/local/bin/npm
安装完成后打开命令行工具(Windows用户在开始菜单打开Node.js文件夹下的Node.js command prompt)进行接下来的操作。
更改npm源
$ npm config set registry https://registry.npm.taobao.org npm info underscore
国外的NPM源并不稳定,即使翻墙也不一定能将Hexo下载下来,所以这里直接更改为淘宝源。
安装hexo
$ npm install -g hexo-cli
这里安装的是hexo最新版本,如果想安装以前的的版本请运行命令$ npm install -g hexo
以上步骤不出问题的话就已经在本地机器上搭建起了Hexo环境。下面介绍Hexo的具体使用方法。
Quick Start
创建hexo工程
$ hexo init blog
创建一个文件夹blog(此处blog换成你自己想要的名字),使用Hexo命令初始化blog为hexo工程目录。
新建POST
$ cd blog
$ hexo new “HelloWorld”
进入初始化后的blog文件夹,创建名为HelloWorld的文件,此时会在/blog/sources/_post/目录下生成HelloWorld.md文件。
生成静态文件
$ hexo generate
使用Hexo引擎将Markdown格式的文件解析成可以使用浏览器查看的HTML文件,HTML文件存储在blog/public目录下。
运行hexo服务器
$ hexo server
打开命令行提示的地址,一般是http://0.0.0.0:4000/,既可以看到我们的Hexo网站。如果提示找不到server命令则需要运行命令$ npm install hexo-server --save
,Hexo3.0之后把server独立出来了,所以需要单独安装。
此时Helloworld文章中没有任何内容。打开/blog/sources/_post/目录,使用编辑器打开其中的HelloWorld.md并在其中添加markdown格式的内容保存,然后重新运行以下命令:
$ hexo generate
$ hexo server
打开浏览器查看修改后的内容。以后创建并查看新的POST,运行以下命令即可:
$ hexo new “your post name”
$ hexo generate
$ hexo server
安装主题
Hexo提供了默认主题landscape。如果想要使用别人的主题则需要用到Git工具。Windows用户和Mac用户安装Git都比较简单,Windows用户登录git官网下载软件安装,Mac用户只需在命令行中键入Git命令就会自动提示安装(详细安装教程请移步Git)。安装完成后打开命令行工具(Windows用户打开开始菜单Git目录下的Git Bash)。
$ cd /blog/themes
$ git clone https://github.com/wuchong/jacman.git ./jacman
$ cd ./jacman
$ git pull
然后在修改/blog/config.yml文件,将其中的theme改成jacman
theme: jacman
重新运行以下命令,查看更换主题后的效果
$ hexo generate
$ hexo server
这里有一些常见的hexo主题,读者可以挑选自己喜欢的安装。
接下来我们将本地Hexo上传到Github免费静态内容空间中,并使用域名访问网站。
申请Github免费静态内容空间
打开Github网站注册账号(账户创建和配置)并使用设置的用户名创建一个Repository。点击网站右上角的+号,选择New Repository
注意Repository Name必须和你设置的用户名一致。其他默认,确定创建。
此时专属于你的静态内容空间就已经创建好了。在浏览器中输入your username.github.io即可访问。
将Hexo上传到Github上
安装deployer-git
$ npm install hexo-deployer-git --save
在/blog/_config.yml中修改deploy属性(注意:之后有空格)
deploy:
type: git
repository: https://github.com/thesingularityisnear/thesingularityisnear.github.io.git
branch: master
将Repository换成你申请的Git仓库地址
使用https的方式部署每次提交到Github都要输入用户名和密码,如果嫌麻烦请使用SSH的方式请移步到Git教程。
运行一下命令将Hexo上传到Github
$ hexo generate
$ hexo deploy
使用域名访问Hexo
购买个人域名
可以选择在万网或者godady上购买域名。各有利弊。不过考虑到只是用来做个人网站的域名,为了方便建议在万网购买。
解析域名
域名服务商都会提供相关解析服务,域名解析配置均相同
绑定独立域名
进入blog/source文件夹,创建名为CNAME的文件
运行以下命令
$ hexo generate
$ hexo deploy
万事OK,快试试用你的独立域名访问Hexo吧。
参考资料
主题
http://www.zhihu.com/question/24422335
官网教程
https://hexo.io/zh-cn/index.html
问题集锦
https://github.com/hexojs/hexo/issues/1154
http://blog.csdn.net/wx_962464/article/details/44786929