前言
作家写书都有序,结尾有跋。我也装模作样写一个。
搭建自己博客的初衷是为分流面试添砖加瓦。而所有的一切都不是想象中的那么顺利。作为一个小白,我遇到的很多问题都不能够自己解决,需要投靠搜索引擎寻找那些和我有相同处境的人。
因此在这篇博客记录网站维护及更新记录,算作对自己成长的记录。
About This Blog
本博客使用Github仓库 + Hexo 搭建。使用主题:hexo-theme-matery
Matery作者的仓库有详细的部署教程,网上也有相应的踩坑记录。一定要勤搜索,主动解决问题。
维护日志
出现乱码
下载好了next主题并部署了网站,打开 http://localhost:4000/ 却发现呈现出一堆乱码。
这是因为缺少了swig组件。这个组件干啥用,为啥会缺少,我没去管。
只需在Git中输入:
npm i hexo-renderer-swig
即可安装。随后我们重新加载网页,就能看到成型的博客了。
什么是front-matter?
在新建的.md文件中,就有这样一段。
---
layout:
- default_layout
title: My First Blog
date: 2022-10-15 22:28:09
categories: New Gadgets
---
它用于设置文档的几个基本属性。例如categories分类,最后会在网站上体现出来。
新手可以多尝试不同的属性,在本地观察效果,快速了解不同的属性。
图片引用
markdown引用图片时,文件路径中不能有空格或者中文!
例如 ![](./My First Blog/1.png)
就不能正常引用图片。
其他问题记录
23/11/29
发现友联的图片全爆了,遂上网找图床,并更新了一堆友联。
为了减少服务器的压力,不少站长还是选择图床存放图片的
Ref:最全的图床集合(国内外,站长必备) - 知乎 (zhihu.com)
现在使用:https://img.tg/
24/2/13
Bug Fix
在博客中引用本地图片时,务必将图片放在与Markdown文件同名文件夹下,文件夹路径与Md文件相同。
例如,某篇博客的Md文件路径为./pathToYourBlog/source/_posts/Blog.md
用到的图片素材需要放在:./pathToYourBlog/source/_posts/Blog/
文件夹下。
个人感觉非常愚蠢,但我愚蠢到不知道怎么修。
New Function
使用utterances 添加评论功能。参考博客:使用 Utterances 为静态博客添加评论 | ROIFE BLOG
按照博客的描述,最后我们能得到一段包含自定义配置的JavaScript 代码:
<script src="https://utteranc.es/client.js"
repo="[ENTER REPO HERE]"
issue-term="pathname"
theme="github-light"
crossorigin="anonymous"
async>
</script>
复制这段代码,找到Hexo主题文件夹中的layout
文件夹,在layout
文件夹中,查找与文章相关的布局文件,通常是post.ejs
或article.ejs
。
打开post.ejs
或article.ejs
文件,找到适合插入评论插件的位置,通常是在文章内容之后或侧边栏之后。
在<main>
标签的结束标签</main>
之后,插入上述代码。重新部署即可。
24/2/14
Hexo部署到远端服务器(github)时报错:
Error: Spawn failed
at ChildProcess.<anonymous> (D:\Myblog\node_modules\hexo-util\lib\spawn.js:51:21)
at ChildProcess.emit (node:events:513:28)
at ChildProcess.cp.emit (D:\Myblog\node_modules\cross-spawn\lib\enoent.js:34:29)
at Process.ChildProcess._handle.onexit (node:internal/child_process:293:12)