Hexo使用指南

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仓库地址

repository地址

使用https的方式部署每次提交到Github都要输入用户名和密码,如果嫌麻烦请使用SSH的方式请移步到Git教程

运行一下命令将Hexo上传到Github

$ hexo generate
$ hexo deploy

使用域名访问Hexo


购买个人域名
可以选择在万网或者godady上购买域名。各有利弊。不过考虑到只是用来做个人网站的域名,为了方便建议在万网购买。

解析域名
域名服务商都会提供相关解析服务,域名解析配置均相同

参数配置

绑定独立域名
进入blog/source文件夹,创建名为CNAME的文件

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,189评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,577评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,857评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,703评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,705评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,620评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,995评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,656评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,898评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,639评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,720评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,395评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,982评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,953评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,195评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,907评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,472评论 2 342

推荐阅读更多精彩内容