hexo-asset-file-carp
v0.4.0
Published
让 hexo 适应 Typora 的图片引入编写习惯,而非调整习惯使用 hexo 的规则。
Downloads
7
Maintainers
Readme
hexo-asset-file-carp
针对文章和资源文件夹的相对位置来处理资源文件夹。Hexo 只提供了几个固定的 asset 文件夹设置,与平常编写习惯不同,所有要让 hexo 适应 Typora 的图片引入编写习惯,而非调整习惯去使用 hexo。
使用须知
资源文件夹解决方案:
一、默认你的资源文件夹{asset_dir}在文章的同目录下,使用相对路径,例如
└── source └── _posts └── hexo ├── assets │ └── filename.jpg └── hexo.md
二、在编译后,默认将资源文件夹放到对应文章的相对路径下,例如:
└── public └── 2023 └── 9 └── 5 └── hexo ├── assets │ └── filename.jpg └── index.html
三、对于像视频、音频等引用路径,hexo默认是不修改的,只要你的文件在资源文件夹中,就会随着资源文件夹一起复制过去,默认放到相对于生成后的文章文件的相对路径。
四、对于本地的绝对路径文件、网络文件不处理,仅处理在
_config.yml
中定义的asset_dir
五、对于上级目录的资源文件使用相对路径引用,如
../<filename>.jpg
,不做二次处理,仅处理./
,如果你这样./../<filename>.jpg
编写,处理之后,文件不显示,自负。
使用
在 hexo 项目的根目录下执行:
npm install hexo-asset-file-carp --save
配置
修改 _config.yml
:
post_asset_folder: true
asset_dir: ./assets
post_asset_folder
是 Hexo 官方提供的一项配置,当它的值为 true
,会在新建文章时,在同目录下创建一个与文章名一致的资源文件夹。
asset_dir
则是我自定义的一项配置,根据 Typora 的配置规则来,你可以设置 ./assets
、 ./${filename}.assets
、 ./${filename}
或者其它的,${filename}
会被解析成文章的文件名,而不是在 Front-matter 中设置的 title
。不建议设置成 ./
,我没有做过滤,会把文章目录下的所有文件夹一起复制过去,包括文章 .md
文件。