Hexo - 博客搭建教程

本文章转自简书潘老师的教程https://www.jianshu.com/p/465830080ea9

hexo是一款基于Node.js的静态博客框架, hexo github链接 ,这篇教程是针对与Mac的,参考链接,由于原文讲到的hexo是以前的老版本,所以现在的版本配置的时候会有些改动。

之前是想着写博客,一方面是给自己做笔记,可以提升自己的写作、总结能力,一个技术点我们会使用,并不难,但是要做到让让别人也能听懂我们讲得,还是需要一定的技巧和经验的。很多类似于CSDN、博客园也都可以写文章,但是页面的样式我,不是太喜欢,简书还算好点得。最近看到一些大神们的博客,貌似都是用hexo写得,我也依葫芦画瓢的搭建了一个。不罗嗦了,直接上搭建步骤。

配置环境

安装Node(必须)

作用:用来生成静态页面的

到Node.js官网下载相应平台的最新版本,一路安装即可。

安装Git(必须)

作用:把本地的hexo内容提交到github上去.

安装Xcode就自带有Git,我就不多说了。

申请GitHub(必须)

作用:是用来做博客的远程创库、域名、服务器之类的,怎么与本地hexo建立连接等下讲。

github账号我也不再啰嗦了,没有的话直接申请就行了,跟一般的注册账号差不多,SSH Keys,看你自己了,可以不配制,不配置的话以后每次对自己的博客有改动提交的时候就要手动输入账号密码,配置了就不需要了,怎么配置我就不多说了,网上有很多教程。

正式安装Hexo

Node和Git都安装好后,首先创建一个文件夹,如blog,用户存放hexo的配置文件,然后进入blog里安装Hexo。

执行如下命令安装Hexo:

sudo npm install -g hexo

初始化然后,执行init命令初始化hexo,命令:

hexo init

好啦,至此,全部安装工作已经完成!blog就是你的博客根目录,所有的操作都在里面进行。

生成静态页面

hexo generate(hexo g也可以)

本地启动

启动本地服务,进行文章预览调试,命令:

hexo server

浏览器输入http://localhost:4000

我不知道你们能不能,反正我不能,因为我还有环境没配置好

配置Github

建立Repository

建立与你用户名对应的仓库,仓库名必须为【your_user_name.github.io】,固定写法

然后建立关联,我的blog在本地/Users/leopard/blog,blog是我之前建的东西也全在这里面,有:

_config.yml node_modules public source

db.json package.json scaffolds themes

现在我们需要_config.yml文件,来建立关联,命令:

vim _config.yml

翻到最下面,改成我这样子的

deploy:
type: git
repo: https://github.com/leopardpan/leopardpan.github.io.git
branch: master

然后执行命令:

npm install hexo-deployer-git –save

网上会有很多说法,有的type是github, 还有repository最后面的后缀也不一样,是github.com.git,我也踩了很多坑,我现在的版本是hexo: 3.1.1,执行命令hexo -vsersion就出来了,貌似3.0后全部改成我上面这种格式了。

忘了说了,我没用SSH Keys如果你用了SSH Keys的话直接在github里复制SSH的就行了,总共就两种协议,相信你懂的。

然后,执行配置命令:

hexo deploy

然后再浏览器中输入http://leopardpan.github.io/就行了,我的github的账户叫leopardpan,把这个改成你github的账户名就行了

部署步骤

每次部署的步骤,可按以下三步来进行。

hexo clean
hexo generate
hexo deploy

一些常用命令:

hexo new“postName” #新建文章
hexo new page“pageName” #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,’ctrl + c’关闭server)
hexo deploy #将.deploy目录部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本

报错总结

ERROR Deployer not found: git 或者 ERROR Deployer not found: github
解决方法: npm install hexo-deployer-git –save

如发生报错: ERROR Process failed: layout/.DS_Store , 那么进入主题里面layout和_partial目录下,使用删除命令:

rm-rf.DS_Store
ERROR Plugin load failed: hexo-server

原因:

Besides,utilities are separated into a standalone module.hexo.util is not reachable anymore.

解决方法,执行命令:

sudo npm install hexo-server

执行命令hexo server,提示:Usage: hexo ….

原因:

我认为是没有生成本地服务

解决方法,执行命令:

npm install hexo-server –save

提示:hexo-server@0.1.2 node_modules/hexo-server

….

表示成功了参考

这个时候再执行:

hexo-server

得到:

INFOHexois running at http://0.0.0.0:4000/.PressCtrl+C to stop.

这个时候再点击http://0.0.0.0:4000,正常情况下应该是最原始的画面,但是我看到的是:

白板和Cannot GET / 几个字

原因:

由于2.6以后就更新了,我们需要手动配置些东西,我们需要输入下面三行命令:

npm install hexo-renderer-ejs –save
npm install hexo-renderer-stylus –save
npm install hexo-renderer-marked –save

这个时候再重新生成静态文件,命令:

爱女友,爱生活
0
0
发表留言

文章
Hexo - 博客搭建教程
本文章转自简书潘老师的教程https://www.jianshu.com/p/465830080ea9hexo是一款基于Node.js的静态...
扫描右侧二维码继续阅读
March 28, 2018
zlatanera
blogger
王誉睿
一名95后。Notion爱好者,大学期间修过电脑和手机、卖过奶茶、得过国家专利,热爱读书和电影,喜欢和女朋友旅游记录生活,对未知事物拥有无限的好奇心,一名脑洞随时大开的老男孩。
我的其他网站:

Jackieの生活觀察(Notion主页)
逝去的武林
BBtime

此网站用RSSHub插件可以添加到RSS阅读器中方便查看哦

统计
文章:155 篇
分类:4 个
评论:24 条
运行时长:1年345天
by yoniu.

zlatanera