Hexo快速入门

参考资料：①hexo框架使用入门 ②主题particleX的配置和使用 ③redefine主题文档

常用指令：

hexo g  //生成页面
hexo d  //部署
hexo s  //本地预览
hexo g -d  //生成并部署

Q： particleX主题的代码块有行号，怎么办？
A：看particleX theme的介绍，关闭highlight即可

Q：头像和背景的URL？
A：需要图床。作者使用的是铁锈图床（能用就行）（不知道放进file里面上传url可不可以，file见后面）

Q：Hexo放置Pdf？
A：参考：【如何在网页中实现pdf在线预览】10分钟学会如何利用Hexo博客上传本地pdf文件并在线预览pdf_白马金羁侠少年的博客-CSDN博客

后面编辑文档的时候看到了，这里说一下，基于hexo生成的网页全部放在public文件夹下面的，路径索引根据这个来就好。但是由于之前使用的是particleX主题，索引方式为何这么勾把奇怪，我也不知道。

注意：对于particleX，由于生成的文件编排方式不同，文件路径应该为：

../../../../file/{pdfName}.pdf

注意file放置在写博客的source文件夹下，与_posts同级

每个markdown应该带的信息头：

---
author:
- SpiritTrance
date: 2022-08-26
title: 计算机网络学习笔记
description:
- 计算机网络学习笔记
tags:
- 计算机网络
categories:
- 学校课程
---

Q：对于Tags页面，Categories页面没有内容？
A：第一步：在根目录打开Git Bash，输入以下内容：

hexo new page "tags"

第二步：在source里面发现tags目录，进入，打开index.md，文件头输入以下信息即可：

---
title: "tags"
type: "tags"
layout: "tags"
---

categories同理，about可以自己编写内容进行自我介绍。

Q：gitalk搭建？
A：参考以下网址：
https://zhuanlan.zhihu.com/p/141078552
https://blog.csdn.net/m0_46916422/article/details/124065600
最后参考particleX作者的blog，在_config.yml里面配置好即可。

踩坑1：未找到相关issue，联系@xxx

首先确保OAuth application的homepage URL是存放评论的仓库的URL，callback URL是blog网址的URL。

然后注意调用Gitalk的方法中，repo是仓库名而不是URL。

这些确保正确后，点击登录（本地localhost貌似不行，要部署上去），按照提示授权即可。

如果主题用的是particleX的话，注意_config.yml的repo是存放评论的仓库名（而非URL），生成Gitalk评论区的代码在source目录的script.ejs中，可以查看原始调用方式

踩坑2：Error: Vaildation Failed.

部分文章评论区出现这种报错。一般情况是Gitalk的id长度超过50，所以避免id长度超过50即可。

一般id用的是pathname，所以保证pathname不要过长，别用中文，只含数字字母下划线即可，没有必要使用md5压缩长度（网上搜到解决办法大多是MD5压缩长度）。

particleX使用的id也是pathname，即文件名，即_posts下的文件名称而非文件中的title文章名称，注意particleX的路径还会添加日期，所以文件长度不能超过39（前面多了2022/08/26，url里面能看到）

Q：latex公式渲染？

A：首先下载pandoc，然后再做相应配置（参考particleX作者的博客，略，后面再改）

Q：电脑不同，迁移博客？

A：作者是直接粗暴地把文件夹复制到新电脑，然后按照创建博客的步骤搭一遍，然后source（博客）直接复制过来覆盖，根目录的config.yml复制过来覆盖，以及theme（因为自己改过）进行覆盖。

提示

后面更新博客的时候稍微清楚了一点，你完全可以在根目录下创建git仓库，然后利用.gitignore过滤掉其他文件，只留source文件夹，存档即可。实际上：

hexo g      # 根据theme的定制生成public文件夹
hexo clean  # 删除public文件夹

图片的寻址也是在public文件夹下面进行的。

Q：如何插入图片？
A：参考这篇博客

后面编辑文档的时候看到了，particleX使用的方式是testpic.png，然后在source/_posts/hexoStarter/testpic.png放置图片，后面使用的redefine主题，直接根目录索引就可以了= =

Q：如何插入pdf文档？
A：首先需要安装插件，然后在source文件夹下创建文件夹file，然后在正文输入：

{% pdf ../../../../file/fileName.pdf %}

[笔记地址](../../../../file/fileName.pdf)

Q：hexo cheatsheet(一键安装)
A：

sudo apt-get install npm -y
sudo apt-get install nodejs -y
sudo npm install -g hexo-cli -y       # hexo框架
sudo apt install pandoc -y
sudo npm uninstall hexo-renderer-markded --save -y
sudo npm install hexo-asset-image --save -y
sudo npm install hexo-deployer-git --save -y
sudo npm install hexo-pdf -S -y
sudo npm install hexo-renderer-pandoc -y
sudo npm install --save hexo-deployer-git -y
sudo npm install --save hexo-asset-image -y
sudo npm install --save hexo-math -y
sudo npm uninstall --save hexo-renderer-marked -y
sudo npm install --save hexo-renderer-pandoc -y
sudo npm install --save hexo-filter-flowchart -y