【踩雷合辑】利用Hexo搭建以fluid为主题的Github博客需要注意什么？

​ 搭建博客是一个非常漫长的过程，在期间我参照过几十篇教程，在非常厉害的Gina同学的帮助下，反反复复试验了很多很多次，经过很多天后才终于能通过我的博客网址访问我的博客主页啦。中间踩过不少雷，有时候一度绝望过（因为在网上根本搜不到和我一样的错误QAQ），好在最终坚持下来了。

​ 先附上fluid主题的官方文档：fluid-dev/hexo-theme-fluid: :ocean: 一款 Material Design 风格的 Hexo 主题 / An elegant Material-Design theme for Hexo (github.com)里面有很详细的配置教程哦。

一、_config.yml配置文件撰写

​ 它就在你所搭建的博客文档的根目录里，是非常重要的配置文档。

1.博客主题修改

​ 打开文档后拉到下面，找到

​ 将theme后改为fluid，注意fluid主题的文件要放入themes文件夹里。如果是下载了zip压缩包，需要将其解压到该文件夹里并修改名字为fluid。

2.deploy配置

​ 这个代码块就在主题配置的下方。注意不要按照网上搜索的教程配置，因为很多教程都已经很老了，所以可能会出问题。按照下面的格式配置是没有问题的。（分支必须是main）

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: git@github.com:[博客名]/[仓库名].github.io.git
  branch: main

注意：每个冒号后都有一个空格。

3.记得保存修改

​ 我所用的编译软件是vscode，这个软件直接退出是不会保存的。快捷键Ctrl+s可以保存修改，然后不用退出就可以继续hexo g+hexo s两步走试看网页效果啦。

二、博客部署的问题

​ 我们知道要搭建博客，就要去Github官网创建一个博客，然后再建立一个仓库用于保存我们的网页。博客的名字可以随意取，但是仓库名，如果你和我一样取的是英文名，第一个字母一定要小写！！！！！

​ 因为我们会发现，当我们想要进入自己的博客官网时，输入的网址格式如下：https://[仓库名].github.io/，而每次进入网址时，仓库名的第一个字母就会自动从大写变成小写，因此访问时就会显示404。

​ 不知道是主题的问题还是什么，反正这个问题害我找bug找了快两个小时……

1.配置安装缺失

有时候hexo d后报错是因为有些配置没有安装,用下面的指令安装好就可

npm install hexo-deployer-git --save

2.在根目录下部署

有时候搭建博客在部署时会忘记退出到根目录，此时也会出错。

三、其他

1.在部署博客时最好hexo clean后再hexo g+hexo d。

2.博文的文件放置在source文件夹下的_posts文件夹内。（fluid主题配置后都会默认创建一个这样的文件，里面有一篇默认的文档）

3.博客主题文档的配置需要很多图片，千万不要把他们放在public文件夹下。因为public是每次部署博客生成的静态文件，每次hexo clean之后就会将其删除。但是博客文件是会保留下来的，所以不用担心。那么这些照片，最好放在source文件夹下的img文件夹内保存（若没有就新建一个这样的文件夹）。