hexo-asset-file-carp

0.4.0 • Public • Published

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_folderHexo 官方提供的一项配置,当它的值为 true ,会在新建文章时,在同目录下创建一个与文章名一致的资源文件夹。

asset_dir 则是我自定义的一项配置,根据 Typora 的配置规则来,你可以设置 ./assets./${filename}.assets./${filename} 或者其它的,${filename} 会被解析成文章的文件名,而不是在 Front-matter 中设置的 title。不建议设置成 ./ ,我没有做过滤,会把文章目录下的所有文件夹一起复制过去,包括文章 .md 文件。

Dependencies (2)

Dev Dependencies (0)

    Package Sidebar

    Install

    npm i hexo-asset-file-carp

    Weekly Downloads

    0

    Version

    0.4.0

    License

    MIT

    Unpacked Size

    14.6 kB

    Total Files

    4

    Last publish

    Collaborators

    • specialcarp