搭建hexo博客

记录搭建hexo博客的步骤。

默认安装好了node.js和git,如若没有:

基本功能

安装hexo

npm install hexo-cli -g
hexo init blog
cd blog

npm install hexo-deployer-git --save # 安装git插件

修改_config.xml

# URL
url: <your url>

# Deployment
depoly:
    type: git
    repo: git@<your repository>
    branch: master

初始化git

1 2	git config --global user.email "you@example.com" git config --global user.name "Your Name"

创建ssh秘钥

1
2
3

ssh-keygen -t rsa
cat /root/.ssh/id_rsa.pub # for Linux
type C:\\Users\<user's name>\.ssh\id_rsa.pub # for windows

复制到github里的ssh密钥。

备份源码至同一仓库（可选）

git remote add origin <your repository>
git add .
git commit -m "<commit message>"
git push --set-upstream origin origin/source

简单命令

hexo s # server 创建本地服务器，打开https://localhost:4000即可查看
hexo g # generate 生成网页文件
hexo d # deploy 配置到github
hexo clean # 清理生成文件

主题相关

更换主题，以Next为例

1	git clone https://github.com/next-theme/hexo-theme-next themes/next

修改_config.xml

1
2
3

# Extensions
## Themes:
theme: next

配置主题themes/next/_config.yml。参见文档内注释即可

创建tags界面(categories同理)

1	hexo new page tags

在source/tags/index.md修改为

---
title: tags
type: tags
---

数学模式

需要更换markdown引擎

1 2	npm uninstall hexo-renderer-marked --save npm install hexo-renderer-kramed --save

在node_modules/kramed/lib/rules/inline.js中修改一些语义处理

//escape: /^\\([\\`*{}\[\]()#$+\-.!_>])/,
escape: /^\\([`*\[\]()#$+\-.!_>])/,
//em: /^\b_((?:__|[\s\S])+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
em: /^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,

最后再在主题配置和文件头里打开mathjax即可

插图方式

打开本地配置_config.yml的开关

1	post_asset_folder: true

在source文件夹下建立images文件夹，将图片放于此文件夹下，引用时

1	![<name>](/images/<pic-name>)

或者放在创建文章时的同名文件夹下，引用时直接使用名字

引用其他博文

将配置文件的永久链接修改为

1	permalink: :category/:title/

至此文件储存路径为”/目录/标题”，因此引用时可

1 2	[](../<同级目录下的文件>) [](/<绝对路径-目录>/<标题>)