VuePress图片资源中文路径问题

现象描述

  • 图片资源以英文字符为路径
  • 相对路径以./或者../开始的正确路径

同时符合以上两条,就没问题

  • 图片资源路径如果不是英文
  • 图片资源是相对(短)路径(不以./ ../开始 )

只要有以上任何一条,编译将失败

问题分析

  • Vuepress 本身使用的是webpack
  • 图片引用使用的应该是url-loader/file-loader
  • *.md文件的编译使用的是markdown-it

如果图片资源的引用是使用url-loader,那么短路径访问的就不再是相对路径,而是node_modules目录下资源。所以,在VuePress中的路径资源必须是以./or../开始
markdown-it会对路径做一个encode操作,具体转换由mdurl执行,参考:https://github.com/markdown-it/markdown-it/blob/575cfeab8acd2d59d637e856d3a205c6e81419cb/lib/index.js#L47

解决方案

  • 将短路经之前填补./
  • 将资源 url 执行一次mdurl.decode

markdown-it-disable-url-encode: https://github.com/nanyuantingfeng/markdown-it-disable-url-encode

(1)安装 markdown-it-disable-url-encode

yarn add markdown-it-disable-url-encode

(2)将其注入VuePress配置文件中

vim docs/.vuepress/config.js
module.exports = {
  // .....
  markdown: {
    // ......
    extendMarkdown: md => {
      md.use(require("markdown-it-disable-url-encode"));
    }
  }
};

版权声明:
作者:Joe.Ye
链接:https://www.appblog.cn/index.php/2023/03/25/vuepress-image-resource-chinese-path-problem/
来源:APP全栈技术分享
文章版权归作者所有,未经允许请勿转载。

THE END
分享
二维码
打赏
海报
VuePress图片资源中文路径问题
现象描述 图片资源以英文字符为路径 相对路径以./或者../开始的正确路径 同时符合以上两条,就没问题 图片资源路径如果不是英文 图片资源是相对(短)路径(……
<<上一篇
下一篇>>
文章目录
关闭
目 录