Hexo配置博客简明实录

Hexo基础

Hexo框架

以下操作请先安装node.js,并配置环境变量.
建立项目需要魔法,速度较慢,需要重复尝试.

1
2
3
cd <folder>H
npx hexo init
npm install

Butterfly主题

以下操作请先提前配置好git.
安装主题以butterfly为例,如果失败可以删除./themes,重复尝试.

1
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

渲染器安装

1
npm install hexo-renderer-pug hexo-renderer-stylus --save

渲染器_config.yml文件配置

1
2
3
4
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: butterfly

建议新建_config.butterfly.yml文件,此文件会覆盖_config.yml同名变量,可用以区分主题配置和博客信息配置.

Hexo常用指令

新建内容在./source文件夹下
新建草稿

1
npx hexo new draft <DraftName>

新建文章

1
npx hexo new post <PostName>

新建页面

1
npx hexo new page <PageName>

清除静态文件

1
npx hexo clean

生成静态文件

1
2
npx hexo generate
npx hexo g

启动服务器(无草稿)

1
2
npx hexo server
npx hexo s

启动服务器(有草稿)

1
2
npx hexo server --draft
npx hexo s --draft

推送部署静态文件

1
2
hexo deploy
hexo d

详细左转hexo中文文档


Blog上线推送与搜索引擎收录

Gitpage推送与Vercel部署

delpoy插件安装

1
npm install hexo-deployer-git --save

_config.yml文件配置

1
2
3
4
deploy:
type: git
repo: <SSH>
branch: <BranchName>

在vercel上导入github的被推送仓库,选择others类型,并且保证生成命令置空,创建即可,此后每次向github推送vercel上都会自动创建新的部署.
自定义域名只需要买一个,让后把vercel的domain粘上去就好了.

搜索引擎收录Google&Bing

Bing的站点管理器
详见Github

1
npm install hexo-generator-sitemap --save

每次生成静态文件时就会在public下生成sitemap.xml


Blog写作与Markdown语法

Markdown语法

MarkDown中文文档
MarkDown数学公式表示方法

KaTeX数学公式渲染

卸载原有渲染器

1
npm un hexo-renderer-marked --save  

安装KaTex渲染器

1
npm i hexo-renderer-markdown-it-katex

_config.yml中配置

1
2
3
4
5
6
7
8
9
10
11
markdown:
render:
html: true
xhtmlOut: false
breaks: true
linkify: true
typographer: true
plugins:
anchors:
level: 1
collisionSuffix: ''