Hexo使用指南

作者: Gooooood | 来源:发表于2016-05-02 15:39 被阅读9200次

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

相关文章

网友评论

    本文标题:Hexo使用指南

    本文链接:https://www.haomeiwen.com/subject/zemlkttx.html