项目简介
本项目是一个基于Hexo框架的插件,主要用于解决Hexo博客中插入Typora图片时路径不兼容的问题。借助该插件,用户能够在Hexo博客里轻松插入并管理相对路径的图片,保证图片在渲染后能正确显示。
项目的主要特性和功能
- 解决Hexo插入图片路径问题:通过调整图片路径,使图片在Hexo渲染后能正常显示。
- 适配Typora图片插入方式:与Typora的图片插入方式兼容,让Typora中插入的图片可无缝迁移到Hexo博客。
- 简化图片管理:采用相对路径管理图片,便于用户在不同环境迁移和部署博客。
安装使用步骤
前提条件
需确保已经安装并配置好Hexo和npm环境。
安装步骤
- 更新Hexo站点配置:打开Hexo站点的配置文件
_config.yml
,将post_asset_folder
选项设置为true
。yaml post_asset_folder: true
- 安装插件:在Hexo站点目录下,使用npm安装
hexo-typora-asset
插件。bash npm install hexo-typora-asset --registry https://registry.npmjs.org --save
- 配置Typora图片路径:在Typora中,更新插入图片的存储路径设置,确保图片存到指定文件夹。
- 重新渲染网站:在终端执行以下命令,清理旧渲染文件并生成新文件。
bash hexo clean hexo g
- 启动本地服务器:使用以下命令启动本地服务器查看渲染效果。
bash hexo s
常见问题及解决方案
问题:插入的图片不显示
解决方案:
1. 确保 post_asset_folder
设置为 true
。
2. 检查图片是否正确插入到指定文件夹。
3. 重新渲染网站,保证新渲染文件包含插入图片。
4. 检查浏览器开发者工具中的图片引用路径,确保路径正确。
5. 若问题仍存在,尝试重新安装插件或检查插件版本是否与Hexo兼容。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】