littlebot
Published on 2025-04-14 / 1 Visits
0

【源码】基于Hexo框架的Typora图片路径兼容插件

项目简介

本项目是一个基于Hexo框架的插件,主要用于解决Hexo博客中插入Typora图片时路径不兼容的问题。借助该插件,用户能够在Hexo博客里轻松插入并管理相对路径的图片,保证图片在渲染后能正确显示。

项目的主要特性和功能

  1. 解决Hexo插入图片路径问题:通过调整图片路径,使图片在Hexo渲染后能正常显示。
  2. 适配Typora图片插入方式:与Typora的图片插入方式兼容,让Typora中插入的图片可无缝迁移到Hexo博客。
  3. 简化图片管理:采用相对路径管理图片,便于用户在不同环境迁移和部署博客。

安装使用步骤

前提条件

需确保已经安装并配置好Hexo和npm环境。

安装步骤

  1. 更新Hexo站点配置:打开Hexo站点的配置文件 _config.yml,将 post_asset_folder 选项设置为 trueyaml post_asset_folder: true
  2. 安装插件:在Hexo站点目录下,使用npm安装 hexo-typora-asset 插件。 bash npm install hexo-typora-asset --registry https://registry.npmjs.org --save
  3. 配置Typora图片路径:在Typora中,更新插入图片的存储路径设置,确保图片存到指定文件夹。
  4. 重新渲染网站:在终端执行以下命令,清理旧渲染文件并生成新文件。 bash hexo clean hexo g
  5. 启动本地服务器:使用以下命令启动本地服务器查看渲染效果。 bash hexo s

常见问题及解决方案

问题:插入的图片不显示 解决方案: 1. 确保 post_asset_folder 设置为 true。 2. 检查图片是否正确插入到指定文件夹。 3. 重新渲染网站,保证新渲染文件包含插入图片。 4. 检查浏览器开发者工具中的图片引用路径,确保路径正确。 5. 若问题仍存在,尝试重新安装插件或检查插件版本是否与Hexo兼容。

下载地址

点击下载 【提取码: 4003】【解压密码: www.makuang.net】