记一次搭建hexo博客（二）配置与注意事项

config.yml文件

进入宝塔，hexo博客文件夹（看你文件夹安装在哪），通过文件找到你的博客文件夹，打开 _config.yml

title    网站标题
subtitle    网站副标题
description    网站描述，主要用于SEO，告诉搜索引擎一个关于您站点的简单描述，通常建议在其中包含您网站的关键词
keywords    网站的关键词。支持多个关键词。
author    您的名字，参数用于主题显示文章的作者。
language    网站使用的语言。对于简体中文用户来说，使用不同的主题可能需要设置成不同的值，请参考你的主题的文档自行设置，常见的有 zh-Hans和 zh-CN。
timezone    网站时区。Hexo 默认使用您电脑的时区。请参考 时区列表 进行设置，如 America/New_York, Japan, 和 UTC 。一般的，对于中国大陆地区可以使用 Asia/Shanghai。
theme 变更主题只需要在这里填写主题名称，主题文件需放入themes文件夹下

这是部分信息，还有些信息可以通过 hexo中文文档 来查阅

注意事项

1、在某些情况（尤其是更换主题后），如果发现对站点的更改无论如何也不生效
解决办法：执行clean语句

npx hexo clean

2、执行命令hexo server，提示：Usage: hexo …. 提示找不到该指令
解决办法：在Hexo 3.0 后server被单独出来了，需要安装server，安装的命令如下：

npm install hexo-server –save

安装此server后再试，问题解决

3、localhost:4000 端口被占用，可执行 hexo s -p 5000 修改成5000 端口

4、YAMLException: incomplete explicit mapping pair; a key node is missed; or followed by a non-tabulated empty line at line 1, column 33:
解决方案：
（1）出现这种情况，一般都是缺少空格，在:冒号之后要有空格！检查x行y列附近的冒号，其之后是否跟了空格。
（2）仔细检查_config.yml文件中所有冒号后面的空格，格式很严格，必须是只有一个，半角。不管是多了还是少了都会报错，这是yml解释器所定义的语法。如果不确定的话，将输入法调整到英文模式，删除所有冒号后面的空格重新输入，不要使用Tab。

5、ValidationError: ‘null’ is not a string!
解决方案： 一般都是因为文章无内容，可能是因为在这篇博客文章中，有某些属性没有填写，比如author属性，tag属性，categories属性等，导致该属性是空的，即null，所以报错。
友情提示：如果你是用MarkdownPad 2来进行博文写作，可能在打开该md文件之后，对文件名进行了修改，导致出现了两篇文章。就会出现错误。

6、执行hexo g命令后，报错：incomplete explicit mapping pair; a key node is missed
解决方案：
主题目录下所有yml文件中所有有空格的字段都用双引号括起来，尤其注意languages下面的yml文件

7、在gitee新建仓库时名称最好是保持跟你注册时的个人空间地址是一样的。因为这样就不会生成二级域名了。如果不跟注册时的个人空间地址一样的话，到时候自己的网站就会有二级域名的存在了

8、提交gitee。
安装 hexo-deployer-git。

 npm install hexo-deployer-git --save

需要先生成本地密钥，再把密钥配置到gitee上个人设置里的SSH公钥里

创建密钥
ssh-keygen -t rsa -C “你的邮箱”
查看密钥
cat ~/.ssh/id_rsa.pub

再_config.yml文件的deploy处配置，repo为仓库的ssh地址

deploy:
  type: git
  repo: <repository url> 
  branch: [branch]
  message: [message]

最后通过

hexo clean && hexo deploy

来进行提交

9、ERROR Deployer not found: git
解决方法：

npm install --save hexo-deployer-git

10、Hexo更改主题后启动服务器，界面显如下字符：

extends includes/layout.pug block content include includes/recent-posts.pug include includes/partial

执行如下命令，即可解决：

npm install --save hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive
清除缓存
hexo clean
生成静态文件即可
hexo g