实现步骤 {#实现步骤}
第一步:修改项目根目录下的 _config.yml
文件参数 post_asset_folder
值为 true
。
|-------------|----------------------------------------------|
| 1 2
| # 开始使用本地静态资源 post_asset_folder: true
|
第二步:安装插件 hexo-asset-image
。
|-------------|-------------------------------------------------------------------------------------------|
| 1 2
| # 在项目根目录下执行 npm install https://github.com/xcodebuild/hexo-asset-image.git --save
|
完成上述配置后,在使用命令 hexo new post
新建文章时,将会在 source/_posts
目录下创建一个与文章同名的目录。
|-----------|------------------------------|
| 1
| hexo new post "测试文章"
|
复制
|---------------------|--------------------------------------------------------------------------------------------------------------------------|
| 1 2 3 4 5 6
| |____scaffolds |____source | |_____posts | | |____测试文章.md | | |____测试文章 # 与文章同名的目录,用于保存在文章中引入的本地图片资源 |____themes
|
复制
如上,新建"测试文章.md"时,将会在 _posts
目录下创建同名文件夹"测试文章",在"测试文章.md"文件中需要引入的图片文件只要放在目录"测试文章"下即可。 图片引用方式:
|-------------|--------------------------------------------------------|
| 1 2
| # 引用图片的时候一定要带上目录名称作为路径 ![ 本地图片](测试文章/本地图片.jpg)
|
复制
使用该方式引用的图片既可以在本地预览,正式发布之后也能正常显示。
原理说明 {#原理说明}
显然,在hexo中引入图片的方式稍微有点繁琐,即:必须在 _post
目录下新建一个与文章同名的目录,然后将需要引用的图片文件都放在该目录中。 还好使用插件 hexo-asset-image
能够帮助我们自动创建图片目录(每次都会自动创建,如果在文章中不需要引用图片资源,可以手动将该目录删除)。
那么,为什么需要将文章引用的图片放置在与文章同名的目录呢? 原因是:在执行 hexo g
命令的时候会将文章转换为一个 index.html
文件,该文件路径为 public/年/月/日/文章名称/index.html
,同时也会将文章中引用的图片文件拷贝到与 index.html
文件相同的目录中。 另外,转换后的 index.html
文件保存路径中有一个 年/月/日
,这是在项目配置文件 _config.yml
的 permalink
参数中配置的,默认值为:
|-----------|----------------------------------------------|
| 1
| permalink: :year/:month/:day/:title/
|
本文转载博主「编程随笔」文章:
原文链接: 在Hexo中引入本地图片的实现-腾讯云开发者社区-腾讯云 (tencent.com)