本文记录了一些在网站开发初期遇到的常见问题以及解决方法,记录在这里用于巩固自己记忆以及帮助搜索这些问题的人能更快地解决问题!

1、远程部署网站后未加载最新的文章

使用hexo new “” ,创建文章并完成,上传gitee、部署网站、刷新后发现新文章仍未发布
这种情况一般是上传问题!

首先检查hexo d上传后的gitee仓库的最后一次更新时间是否为"刚刚"
若不是,则检查_config.yml中的仓库地址repository和分支branch是否正确
若是,则在giteePages服务页中,手动点击更新,待重新部署后,文章正常显示!

2、使用md语法写的文章图片不显示或加载失败

(1)我们需要安装一个图片路径转换的插件,插件名字为hexo-asset-image,只需执行以下命令

先进入你的hexo根目录下,然后执行以下命令下载插件
npm install https://github.com/7ym0n/hexo-asset-image --saveasset-image --save

(2)打开hexo根目录下的_config.yml文件,修改post_asset_folder为true

这一步的目的是:打开文章资源文件夹功能。
当资源文件管理功能打开后,Hexo将会在你每一次通过 hexo new 命令创建新文章时自动创建一个文件夹。
这个资源文件夹将会有与这个md文件一样的名字。将所有与你的文章有关的资源放在这个关联文件夹中之后,
你可以通过相对路径来引用它们,这样你就得到了一个更简单而且方便得多的工作流。

(3)使用相对路径引用图片或其他静态资源

在md语法中,使用的是这种方式引用图片:

使用! [](你的博文名字/图片名称)插入图片即可。

但是在hexo3之后这种语法已经不适用了,引用资源时采用下面这种方式:

首先将图片等静态资源放在hexo new 命令执行后生成的同名文件夹中
然后在图片引用处:
{% asset_img "图片名称&后缀" "图片描述信息" %}"图片描述信息" %}

官方参考使用说明地址:

https://hexo.io/zh-cn/docs/asset-folders问题解决参考博主地址:

问题解决参考博主地址:

https://blog.csdn.net/weixin_33827590/article/details/93066614?spm=1001.2101.3001.6650.1&utm_medium=distribute.pc_relevant.none-task-blog-2%7Edefault%7ECTRLIST%7ERate-1-93066614-blog-113460538.pc_relevant_multi_platform_whitelistv4eslandingrelevant2&depth_1-utm_source=distribute.pc_relevant.none-task-blog-2%7Edefault%7ECTRLIST%7ERate-1-93066614-blog-113460538.pc_relevant_multi_platform_whitelistv4eslandingrelevant2&utm_relevant_index=1

3、访问网站时样式加载失败

这个问题是比较常见的一个问题了,即使之前我解决过,但今天居然又遇到这种情况,但很快也又解决了!
我分享一下我面对这个问题的一个解决思路:

1、一般都是路径错误,在网页端按F12进入调试页,就可以查看样式未加载的404报错信息中的URL错误
2、观察仓库中图片的路径
3、在hexo g生成的public文件夹中的index.html中查看css引用地址和仓库中的图片路径的不同之处

4、一般都是根路径的问题,我这里的root直接为”/“,表示为仓库的根路径
这样在引用图片的时候不需要加格外的相对路径,直接输入图片名称即可引用

4、网站URL取消子域名

之前我这个博客的网站地址是https://Doublepeach/gitee.io/Doublepeach/git.io
可以看到,这个网址比较长,而且前后域名和子域名重复,完全一样。
而现在的域名:https://doublepeach.gitee.io 就简洁多了 ,那怎么做到的呢?
(1)首先在仓库的管理页中,将仓库名称和仓库地址修改为一样的,如下:

(2)然后在hexo根目录下的_config.yml文件中修改repository仓库地址为新地址
(3)还是在_config.yml中,修改URL为 https://仓库名.gitee.io 即可

5、文章模板设设置

每次hexo new 新文章时都需要写一些顶部的文章配置,为了方便,可以直接修改创建文件时的模板内容
修改位置为: hexo根目录下的scaffolds(脚手架)下的post.md
这里推荐的常用模板:

---
title: {{ title }}
date: {{ date }}
tags: 标签
description: 描述信息
sticky: 优先级
comments: 是否开启评论(true或false)
keywords: 关键字
top_img: 顶部图片
---