4 显示图片

Hexo 支持多种显示图片的方法,比如图床,上传图片等,这里介绍最简单的方法:

4.1 安装插件

1
2
$ npm install hexo-asset-image
$ npm install hexo-renderer-marked

4.2 配置文件

保持 _config.yml 配置文件 中 post_asset_folder: false 不变,加入 marked 设置:

1
2
3
4
post_asset_folder: false
marked:
prependRoot: true
postAsset: true
  • 我在 Obsidian 中的图片都放在 attachments/ 目录下,将此目录复制到 Hexo 项目的 source 目录中,即:source/attachments/xx.png
  • hexo g 重新生成后,图片正常显示
  • 注意图片较少时,建议使用该方法,图片很多时,github 项目也变得很“重”,建议使用图床。

5 更换主题

建议设置一个常用的主题,比如 next,遇到问题也好查资料。

官网主题见:https://hexo.io/themes/

  • 安装主题
1
2
npm install hexo-theme-next # 安装在node_modules/ 目录下
cp node_modules/hexo-theme-next/_config.yml _config.next.yml # 复制主题配置文件
  • 修改配置:在 _config.yml 中,修改:theme: next
  • 重新生成后,即可看到新主题

6 调试

  • 查看软件版本
1
hexo -v
  • 查看详细 debug 信息
1
hexo g --debug # 加 --debug 参数

7 忽略一些文章

8 整体配置

修改 _config.yml,修改后注意先清缓存再生成,否则设置可能不生效。

1
2
3
4
skip_render:
- '_posts/tools/*' # 目录下文件
- 'tools/**' # 目录及子目录下文件
- '_posts/**/*索引_*' # 跳过所有目录下包含 索引_ 关键字的文件

9 在 markdown 中配置

在.md 的文件头中设置 published 为 false

1
published: false

10 参考