静态博客生成工具hexo

hugo 文档请看 hugo

安装 nodejs yarn hexo

推荐使用 yarn 来代替 npm
首先安装 nodejs，和 npm, 然后再安装 yarn

安装 yarn

1	npm install -g yarn

设置淘宝源

1	yarn config set registry https://registry.npm.taobao.org -g

安装 hexo

1	yarn global add hexo-cli

创建新项目

如果找不到 hexo,请把 yarn global bin 添加到环境变量

1	hexo init myblog

修改配置

修改语言为中文

vim myblog/_config.yml

# Site
title: 张理坤的博客
subtitle: '飞机师的风衣'
keywords:
author: 张理坤
language: zh-CN
timezone: 'Asia/Shanghai'

安装 next 主题

github 地址：https://github.com/theme-next/hexo-theme-next

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

修改 theme 配置文件 vim next/_config.yml
scheme: Pisces

添加搜索功能

1	yarn add hexo-generator-searchdb

然后主题配置文件 next/_config.yml
local_search: 标签，配置参数 enable: true

添加看板娘

git 地址： https://github.com/EYHN/hexo-helper-live2d/blob/master/README.zh-CN.md

1 2	yarn add hexo-helper-live2d yarn add live2d-widget-model-epsilon2_1

在 _config.yml 添加下面配置

live2d:
  enable: true
  scriptFrom: local
  pluginRootPath: live2dw/
  pluginJsPath: lib/
  pluginModelPath: assets/
  tagMode: false
  log: false
  model:
    use: live2d-widget-model-epsilon2_1
  display:
    position: right
    width: 150
    height: 300
  mobile:
    show: true
  react:
    opacity: 0.7

module.use 里面的和你安装的要一样

设置头像

将图片放入博客目录/themes/next/source/images，并重命名为 avatar.[格式]
编辑主题配置文件 _config.yml
vim 博客目录/themes/next/_config.yml

1	avatar: /images/avatar.png

添加分类和标签

分类

hexo new page categories
成功后会提示：

1	INFO Created: ~/Documents/blog/source/categories/index.md

添加 type: "categories" 到 index.md 中:

---
title: 文章分类
date: 2017-05-27 13:47:40
type: "categories"
---

给文章添加“categories”属性
打开需要添加分类的文章，为其添加 categories 属性。
注意：hexo 一篇文章只能属于一个分类，如果写两个分类，则是给分类嵌套

---
title: hexo
abbrlink: ab21860c
date: 2021-02-02 17:28:26
---

添加图片

安装插件

1	yarn add https://github.com/iuxt/hexo-asset-image.git

vim myblog/_config.yml

1	post_asset_folder: true

创建新文章

1	hexo new test

使用

将图片放在同名文件夹, 在 md 里面引用

1	![pilot](pilot.jpg)

自定义域名

在 source 目录添加 CNAME 文件，文件内容是你的域名
添加解析 CNAME 到 github 的域名

开始写文章

新创建文章

hexo new <标题>

然后编辑 vim source/_posts/<标题>.md

本地查看效果

hexo s

发布文章

安装 git 插件

1	yarn add hexo-deployer-git

修改 hexo 配置文件 vim hexo/_config.yml，配置 git 地址

theme: next

deploy:
  type: 'git'
  repo: ['git@gitee.com:iuxt/iuxt.git', 'git@github.com:iuxt/iuxt.github.io.git']
  branch: master
  message: 'hexo update'

发布

1	hexo clean && hexo d

优化

url 格式优化

有人给我评论了, 但是后面我更新了一下目录结构, 发现评论丢失了, 究其原因是因为文章的 url 变了，所以想将文章的 url 固定下来，也便于 seo
默认的生成规则是：:year/:month/:day/:title，是按照年、月、日、标题来生成的。比如：https://iuxt.gitee.io/2021/05/08/%E5%B7%A5%E5%85%B7/adb%E5%B8%B8%E7%94%A8%E6%93%8D%E4%BD%9C/

安装插件

1	yarn global add hexo-abbrlink

vim config.yml

permalink: :abbrlink/
# abbrlink config
abbrlink:
  alg: crc32  # 算法：crc16(default) and crc32
  rep: hex    # 进制：dec(default) and hex

seo

robots.txt

在 source 目录下创建 robots.txt 文件

# welcome to : iuxt.github.io
User-agent: *
Allow: /
Allow: /archives/
Allow: /categories/
Allow: /about/

Disallow: /js/
Disallow: /css/
Disallow: /fonts/
Disallow: /vendors/
Disallow: /lib/
Sitemap: https://iuxt.github.io/sitemap.xml

sitemap.xml

安装插件

1 2	yarn add hexo-generator-sitemap yarn add hexo-generator-baidu-sitemap

themes/next/_config.yml 添加

baidusitemap:
    path: baidusitemap.xml
sitemap:
    path: sitemap.xml

然后 hexo g, 看下 public 目录下有没有生成 sitemap.xml 和 baidusitemap.xml 文件