本文发布于143天前,最后更新于135天前,其中的信息可能有所发展或是发生改变。
1. 前言
HEXO安装:HEXO系列教程 | 使用GitHub部署静态博客HEXO | 小白向教程
使用YUN主题:
- HEXO系列教程 | 配置云游君Yun主题PART1 | 优雅美观
- HEXO系列教程 | 配置云游君Yun主题PART2 | 优雅美观
夜梦就在这篇文章中介绍一下如何在HEXO上写文章并发布。你可以直接看官方提供的教程:写作 | Hexo
2. 发写文章
2.1 文件名称
Hexo 默认以标题做为文件名称,但你可编辑 new_post_name
参数来改变默认的文件名称。你只需要在_config.yml
中修改:
可以使用的占位符:
变量 | 描述 | 例子 |
---|---|---|
:title | 标题(小写,空格将会被替换为短杠) | |
:year | 建立的年份 | 2024 |
:month | 建立的月份(有前导零) | 04 |
:i_month | 建立的月份(无前导零) | 4 |
:day | 建立的日期(有前导零) | 07 |
:i_day | 建立的日期(无前导零) | 7 |
夜梦这里举个例子,夜梦将默认存储名称修改为 :year-:month-:day-:title.md
,然后就可以很方便地通过日期来管理文章!
2.2. 插入图片相关问题
2.2.1 问题再现
为了避免后续写文章、发布文章的时候遇到图片无法加载的问题,夜梦决定把这一部分写在创建文章之前。如果不进行此部分,你可能在本地预览图片无任何问题,但是上传到Github Pages的时候无法显示,就像下面一样:
夜梦这里提供两个办法来进行图片的插入。
2.2.2 使用图床(推荐)
最推荐的方法其实就是使用图床,这样图片可以正常显示并且不会因为本地资源的调整而出现问题。因为GitHub网络问题,如果上传过多的图片到GitHub中,加载hexo可能会很慢。使用图床就可以很好地解决这个问题。
2.2.3 修改配置与安装插件
你也可以通过修改配置并安装插件的方法完成图片的插入。你需要修改站点配置_config.yml
,将post_asset_folder
设置为true
,如下图:
然后安装插件:
代码语言:javascript复制npm install hexo-asset-image -- save
2.2.4 修复静态图片路径
如果你使用的是插件,当生成预览的时候,可能依旧无法正常查看图片。
通过直接查看HTML文件,我们可以看到是因为多了/.com/,所以在加载图片的时候无法获得正确的路径。
具体的修改也很简单,我们只需要到node_modules
中找到hexo-asset-image
,并将58、89行的
修改为:
代码语言:javascript复制$(this).attr('src', src);
console.info && console.info("update link as:-->" src);
如下图:
不出意外的话,就可以看到正常显示的图片了:
2.3 创建文章
在HEXO目录下,打开GIT BASH HERE,你可以直接使用下面的命令创建新的文章:
代码语言:javascript复制# 标准格式如下
# hexo new post <title>
# 夜梦这里举例
hexo new post HEXO博客的初步使用
创建完成,可以在终端里面看到提示:
文章post的存储路径:source/_posts
。因为我们安装了插件,所以在同一目录下,会生成一个和文章名字一样的文件夹。
2.4 写作
写作就很简单了,在.md文件里面直接用markdown语法写就可以了。
如果需要引用本地图片地话,需要把图片放到我们只需要把图片放到与文章同名的文件夹中,然后直接引用~
代码语言:javascript复制![yourDescription](yourPostTitle/yourImage.png) # 假如你的文章名是yourPostTitle,图片名字是yourImage.png
3. 发布
写完以后保存.md文件,然后运行
代码语言:javascript复制hexo clean && hexo g && hexo s
本地预览。无误后,你可以执行
代码语言:javascript复制hexo d
发布到github pages上。夜梦演示的效果如下图:
4. 注意事项
在写文章的时候,文章head里面的每个项目后面都要加空格,要不然会报错哦!
5. 其他HEXO教程推荐
配置 YUN 主题:
- HEXO 系列教程 | 配置云游君 Yun 主题 PART1 | 优雅美观
- HEXO 系列教程 | 配置云游君 Yun 主题 PART2 | 优雅美观
安装HEXO:
- HEXO系列教程 | 使用GitHub部署静态博客HEXO | 小白向教程