说明

此为本博客第三版,前两版在本人不懈努力下成了s山,无法推送至github托管,难以修复,遂放弃。

关于难点

图片

作为网页中最常见的元素之一,图片的添加是必要的。首先尝试使用原生markdown语法插入图片:
miku2_2

尺寸过大,效果不甚理想。由于md文件会被hexo编译为html,尝试使用<img>标签:
miku2_1

此方法可以通过调整width属性手动控制图片大小,但难以控制排版。阅读butterfly主题文档发现,主题允许使用gallery标签外挂图片:

还是作者推荐的好使。

ps:不是md和html的图怎么又炸了

主题美化

Butterfly主题预设了许多接口和开关,可以在_config.yml配置文件中修改以满足个性化需求。

首先尝试更改默认头像,在博客根目录下创建_config.butterfly.yml文件,将themes/butterfly/source/_config.yml复制进来,hexo读取_config.butterfly.yml的优先级高于主题目录下的_config.yml,可更方便的调整主题配置。
依照文档指示,在source目录下创建img文件夹,导入图片,使用img/xxx.jpg的相对路径配置文件,发现无法在本地预览中生效,使用绝对路径/img/xxx.jpg仍不可显示,尝试使用浏览器直接访问图片地址:404,显然无论相对路径和绝对路径都存在问题,未能正确指向img中的图片。
观察config中的url路径,发现url: https://MzyCf.github.io/project,由此可知实际图片目录为/project/img,修改图片路径,成功在本地预览中显示。

Github托管

好消息:典中典 坏消息:不会修

经检查我的站点根目录是 https://mzycf.github.io/,但本地 _config.yml 里 root设置成了 /project/ ,导致生成的资源路径错误,本地访问 localhost:4000/project/,但线上其实是根目录。因此,主题、Hexo 的静态资源(如 /css/index.css/js/main.js)404,页面就会变成“纯文字无样式”。

问题解决

修改url设置如下:

1
2
url: https://mzycf.github.io
root: /

去掉所有路径下的/project/,确保本地和线上访问的根目录一致。

更多问题将随持续开发不断更新

求关注

Bilibili主页:Link Start

以上引用图片均出自本人之手,部分可在b站视频中找到