Hexo搭建笔记

安装git

参考:http://www.runoob.com/git/git-install-setup.html

从这里下载安装:
http://sourceforge.net/projects/git-osx-installer/

安装node.js

参考:http://www.runoob.com/nodejs/nodejs-install-setup.html

从这里下载安装:
https://nodejs.org/en/download/

安装hexo

配置国内镜像源:

1
npm --registry https://registry.npm.taobao.org

参考:https://hexo.io/zh-cn/docs/

1
npm install -g hexo-cli

最好不要用sudo,不到万不得已就别加,不然生成的文件夹都是root权限的。有需要权限的问题就修改那个文件或文件夹的权限:

1
sudo chmod -R 777 文件夹或文件

/user/local/bin的权限试试这个:

1
sudo chmod -R 777 /var/root

然后参考:https://hexo.io/zh-cn/docs/setup.html

安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。

1
2
3
$ hexo init <folder>
$ cd <folder>
$ npm install

配置hexo

基本配置

注意冒号跟值之间要有空格!!!
site

1
2
3
4
5
6
title: 今夕何夕
subtitle: 博客
description: 三七的博客
author: Jadyli
language: zh-Hans
timezone: Asia/Shanghai
1
url: https://www.sanqis.com/blog
1
2
3
4
deploy:
type: git
repo: git@github.com:Jadyli/Jadyli.github.io.git
branch: master

其他的不用管。

运行hexo g,会生成网页文件,运行hexo server可以本地查看。

永久链接

第一步:

安装hexo-abbrlink,这个插件的来源参考:hexo-abbrlink介绍

1
npm install hexo-abbrlink --save

第二步:

1
2
3
4
5
permalink: blog/:abbrlink/
# abbrlink config
abbrlink:
alg: crc32 # 算法:crc16(default) and crc32
rep: hex # 进制:dec(default) and hex

blog/:abbrlink/中的blog可以替换成别的,但是不能直接删除,这里一定要有字符。

第三步:

在博客的开头加上abbrlink属性,

1
2
3
4
---
title: hexo笔记
abbrlink: hexo_build_note
---

效果就是

如果没有加这个属性,会对标题+时间进行md5然后再转base64,保存在front-matter中,网址直接用这个加密的字符串。效果如下

1
https://jadyli.github.io/blog/68648dbe/

常用命令

1
2
3
4
5
hexo n "我的博客" == hexo new "我的博客" #新建文章
hexo p == hexo publish
hexo g == hexo generate#生成
hexo s == hexo server #启动服务预览
hexo d == hexo deploy#部署
1
hexo generate --watch #监视文件变动

生成并部署到服务器

1
hexo d -g

hexo多终端同步

创建仓库

1
git init

跟github合并

添加到远程

1
git remote add origin git@github.com:Jadyli/Jadyli.github.io.git

关联远程分支

1
git branch --set-upstream master origin/master
1
git fetch
1
git pull --allow-unrelated-histories
1
git push

创建分支用于存储hexo

新建一个hexo分支存储hexo的文件。

1
git git checkout -b hexo

checkout -b表示创建并切换。
提交

1
git commit -am 's'

关联远程

1
git push --set-upstream origin hexo

主题

我用的NexT

http://theme-next.iissnan.com/getting-started.html#select-language

github: https://github.com/iissnan/hexo-theme-next

克隆地址:git@github.com:iissnan/hexo-theme-next.git

开始使用

照着做就行,注意一个地方:

1
2
3
# Value after `||` delimeter is the name of FontAwesome icon. If icon (with or without delimeter) is not specified, globe icon will be loaded.
social:
GitHub: https://github.com/Jadyli || github

social:前面的#号要去掉!

常见错误

ERROR Deployer not found: git

1
npm install hexo-deployer-git --save

Cannot find module ‘./build/Release/DTraceProviderBindings’

尝试

1
npm install hexo --no-optional

如果这样还不行,那么卸载重装

1
2
$ npm uninstall hexo-cli -g
$ npm install hexo-cli -g

如果还是不行,卸载重装node.js

1
sudo rm -rf /usr/local/{bin/{node,npm},lib/node_modules/npm,lib/node,share/man/*/node.*}
1
2
3
4
5
6
7
8
sudo rm /usr/local/bin/npm
sudo rm /usr/local/share/man/man1/node.1
sudo rm /usr/local/lib/dtrace/node.d
sudo rm -rf ~/.npm
sudo rm -rf ~/.node-gyp
sudo rm /opt/local/bin/node
sudo rm /opt/local/include/node
sudo rm -rf /opt/local/lib/node_modules

按开头的教程重装。

如果您觉得这篇文章不错,可以打赏支持下哦,谢谢