安装Hexo
要使用Hexo必须先安装Git和Node.js。本文是在Ubuntu20环境下进行操作的。使用其它系统也可以将下面的操作作为参考。
安装Git
sudo apt-get install git-core安装Node.js
推荐安装当前最新版。不同的Hexo版本依赖不同版本的Node.js。下面是版本对照表。
这里建议安装Node.js最新稳定版。
Node.js官方下载网址：
https://nodejs.org/en/download/
这里以二进制安装方式进行，也可使用源码编译安装。
按图示下载好二进制文件包。
按照下面的方式操作即可安装好。
tar xvf node-v16.15.1-linux-x64.tar.xz mkdir /data mv node-v16.14.2-linux-x64 /data/nodejs ln -s /data/nodejs/bin/* /usr/bin/ npm install yarn
echo "PATH=$PATH:/data/nodejs/bin" >> /etc/profile
source /etc/profile
安装Hexo
npm install -g hexo-cli创建博客
新建博客目录
hexo init blog安装node依赖
cd blog
npm install本地启动博客服务器
hexo server如果有出现下面的报错信息，可更改一下端口号。
在博客目录内的_config.yml文件内添加下面的代码来更改hexo-server运行时的端口号：
server:
port: 4001 #端口号随意，默认是4000
compress: true
header: true更改后的效果：
现在用浏览器访问http://localhost:4001就可以看到初始的博客了。
写博客文章
创建博客文章
hexo new "My first blog"运行上面的命令将创建一片名为My first blog的博客文章。
可以看到文章保存到了source/_posts目录下了。并且文章是以markdown的形式保存的。
其实也可以自己手动在source/_posts目录下新建markdown文件。当我们编译博客目录时，这些markdown文件将会生成对应的网页文件。
当我们用命令创建一个新的博客时，其实是用了一个默认模板来创建一个新的markdown文件。这个模板是保存在scaffolds目录下的。
其中post.md就是博客文章的模板。一个常见的模板是这样的。
post模板
---
title:}
date:}
categories:
tags:
description:
photos:
---
title: 文章标题
date: 文章的生成时间
categories: 文章分类，这个分类会在网站上统计
tags: 文章的标签
description: 文章的概要
photos: 文章的封面
注意，每一篇文章的头部都需要有一个这样的开头。description和photos是可以不加的。
一个简单的示例：
---
title: Costmap是什么？ #文章页面上的显示名称，一般是中文
date: 2022-05-02 15:30:16 #文章生成时间，一般不改，当然也可以任意修改
categories: ROS2 #分类
tags: [ROS2,Costmap] #文章标签，可空，多标签请用格式，注意:后面有个空格description: 详细介绍了costmap
---
显示摘要
在文章中添加下面的内容
<!--more-->注意，摘要显示和文章描述显示只能选择一个。如果要显示文章描述，则文章的开头要加上description。若想显示摘要，则文章开头不可加description。不然只会显示description。然后把<!--more-->加入到文章中。<!--more-->之前即为摘要。效果如下：
如果想在摘要中显示图片可以将<!--more-->放在图片链接后面。比较合适的图片尺寸为1600x900。
更改博客主题
因为博客文章是用markdown来写的，所以我们可以任意更换文章呈现的主题。
这里使用NexT来作为示范。
将NexT主题下载到themes目录。
cd themes
git clone https://github.com/theme-next/hexo-theme-next然后在_config.yml文件中配置需要使用的主题。
theme: hexo-theme-next主题也是可以配置的。详细的配置和使用说明请查看官方文档。
NexT 使用文档:
http://theme-next.iissnan.com/getting-started.html
设置头像
编辑 themes/hexo-theme-next/_config.yml：
avatar: <avatar-url>添加标签页面
- 新建页面：
hexo new page tags- 设置页面（编辑
source/tags/index.md）：
---
type: "tags"
comments: false
---- 修改菜单（编辑
themes/hexo-theme-next/_config.yml）：
menu:
tags: /tags添加分类页面
- 新建页面：
hexo new page categories- 设置页面（编辑
source/categories/index.md）：
---
type: "categories"
comments: false
---- 修改菜单（编辑
themes/hexo-theme-next/_config.yml）：
menu:
tags: /categories添加 about 页面
- 新建页面：
hexo new page about- 设置页面（编辑
source/about/index.md） - 修改菜单（编辑
themes/hexo-theme-next/_config.yml）：
menu:
about: /about给博客安装搜索插件
使用本地搜索，按以下步骤配置：
- 安装
hexo-generator-searchdb插件：
npm install hexo-generator-searchdb --save- 编辑
_config.yml：
search:
path: search.xml
field: post
format: html
limit: 10000- 编辑
themes/hexo-theme-next/_config.yml：
# Local search
local_search:
enable: true给博客文章设置永久链接
Hexo 默认文章链接生成规则是按照年、月、日、标题来生成的。一旦文章标题或者发布时间被修改，URL 就会发生变化，之前文章地址也会不可访问。而且 URL 层级很深，不利于分享和搜索引擎收录。
如果文章标题中有中文，URL 被转码后会很长，比如：https://www.shoufei.xyz/2022/06/12/%E4%B8%8B%E8%BD%BDturtlebot4%E6%BA%90%E7%A0%81%E6%9D%A5%E5%AD%A6%E4%B9%A0/。
我们可以使用 hexo-abbrlink插件为每篇文章生成一个唯一字符串，这个字符串ID不受文章标题和发布时间的影响，比如：https://www.shoufei.xyz/p/ae5fa866。
- 安装插件
点击即可访问插件源码地址 hexo-abbrlink 。
在博客目录下运行下面的命令安装插件
npm install hexo-abbrlink --save- 配置
修改博客根目录配置文件 _config.yml 的 permalink：
# permalink: :year/:month/:day/:title/
permalink: p/:abbrlink.html # p 是自定义的前缀
abbrlink:
alg: crc32 #算法： crc16(default) and crc32
rep: hex #进制： dec(default) and hex不同算法和进制生成不同的字符串ID：
crc16 & hex
https://post.zz173.com/posts/66c8.html
crc16 & dec
https://post.zz173.com/posts/65535.html
crc32 & hex
https://post.zz173.com/posts/8ddf18fb.html
crc32 & dec
https://post.zz173.com/posts/1690090958.html
- 验证
先清理下本地的文件 hexo clean，然后重新生成 hexo g，启动博客 hexo s。该插件会在每篇文章的开头增加内容：
abbrlink: df27ccfb这个字符串就是这篇文章的唯一标识，无论修改标题还是发布文章都不会改变。
参考：
https://zhuanlan.zhihu.com/p/134492757
部署博客
目前我学习到两种部署博客网站的方式。一种是使用Github Pages来托管博客网站，一种是通过Netlify来托管。
使用Github Pages
安装部署插件
cnpm install --save hexo-deployer-git在github上新建一个仓库，用于存放网页内容。注意，设定的仓库名称必须是用户名+github.io的形式。
然后修改_config.yaml中的配置，加上目标仓库的地址。
运行hexo d后其中的publish目录中的内容将被推送到设定的远程仓库中。
注意，每次推送都是完全覆盖。
注意，这里repo的地址需要用ssh的仓库地址。
注意，repo必须保持为公开状态。
这时通过访问用户名+github.io就能看到你的博客了。
常用命令
下面命令的顺序就是一个部署流程。
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo clean #清除hexo生成的内容，建议生成前先clean一下，避免出现异常
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #将博客内容部署到GitHub可简写为：
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy参考：
https://hexo.io/zh-cn/docs/github-pages
使用Netlify
Netlify 是一个提供网络托管的综合平台。它集持续集成（CI），CDN 自定义域名， HTTPS ，持续部署（CD）等诸多功能于一身。
首先，还是在Github上新建一个仓库，只是这次对仓库的名称没有要求了。然后用git工具将博客目录的文件推送到该仓库。
注意，不需要使用hexo g来生成博客网页。这一步我们将在Netlify 上完成。所以推送的东西不应该包含运行hexo g命令生成的文件。
然后，在Netlify 上注册一个帐号。最好直接使用Github帐号。
并添加好维护博客内容的仓库。
设置编译命令
设置部署的分支
修改默认域名
Netlify 会默认为我们的博客生成一个域名，但是这个域名比较复杂。我们可以自定义这个域名。
绑定自己的域名
首先需要购买一个自己的域名。可以购买域名的网站如下：
https://wanwang.aliyun.com/domain/
https://dnspod.cloud.tencent.com/
个人博客用的域名是可以不用备案的。
在netlify网站上添加自定义域名
修改**DNS，设置域名重定向
因为是在腾讯云上购买的域名，所以登录https://www.dnspod.cn/后，在我的域名栏就可以看到已经购买的域名了。
若是在其他平台购买的域名也可以直接添加到这里
添加记录
这里添加Netlify上设置的网站域名。我的是shoufei.netlify.app。默认的是字母加数字的，这里我自定义了的。添加好域名映射后就可以用自己的域名访问博客网站了。
申请SSL证书
点击右侧的SSL图标即可免费申请
网站不安全的标志
增加SSL证书后
参考：
https://zhuanlan.zhihu.com/p/77651304
提交网站给搜索引擎
https://www.sousuoyinqingtijiao.com/
在该网站提交自己的网站给各个搜索引擎。
参考
https://uchuhimo.me/2017/04/11/genesis/
http://ibruce.info/2013/11/22/hexo-your-blog/
Hexo官方手册:
Hexo主题：
