我的第一篇文章
说明
此为本博客第三版,前两版在本人不懈努力下成了s山,无法推送至github托管,难以修复,遂放弃。
关于难点
图片
作为网页中最常见的元素之一,图片的添加是必要的。首先尝试使用原生markdown语法插入图片:
尺寸过大,效果不甚理想。由于md文件会被hexo编译为html,尝试使用<img>标签:
此方法可以通过调整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 | url: https://mzycf.github.io |
去掉所有路径下的/project/,确保本地和线上访问的根目录一致。
更多问题将随持续开发不断更新
求关注
Bilibili主页:Link Start
以上引用图片均出自本人之手,部分可在b站视频中找到




