hexo-asset-link

KO | EN

gitlite — search

#python #hacktoberfest #llm #go #machine-learning #rust #linux #docker #macos #java #cli #awesome-list #ios #openai

hexo-asset-link

(★ 29)

A Hexo plugin to convert Markdown style asset links to HTML style ones

hexo-asset-link Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# hexo-asset-link [![NPM version](https://badge.fury.io/js/hexo-asset-link.svg)](https://www.npmjs.com/package/hexo-asset-link)

Convert Markdown style asset links to HTML style ones.

## Install

In Hexo blog instance directory:

```shell
$ npm i -s hexo-asset-link
```

**or** if you prefer yarn:

```shell
$ yarn add hexo-asset-link
```

## Config

**Find** (not *add*) and enable [`Post Asset Folders`](https://hexo.io/docs/asset-folders#Post-Asset-Folder) feature in `_config.yml`:

```yml
# Writing
...
post_asset_folder: true
...
```

## Usage

For example, if you have these files in `source/_post/`:

```
+-- _posts/
|   +-- 2019-02-14-Test-Post.md
|   +-- 2019-02-14-Test-Post/
|       +-- Test-Image.png
|       +-- Test-Other-File.pdf
```

Then in `2019-02-14-Test-Post.md`:

### Images

```markdown
![Alt Text](https://raw.githubusercontent.com/liolok/hexo-asset-link/master/2019-02-14-Test-Post/Test-Image.png "Title Text")
![Alt Text](https://raw.githubusercontent.com/liolok/hexo-asset-link/master/2019-02-14-Test-Post/Test-Image.png "Title Text")
```

### Other Files

```markdown
[Text](./2019-02-14-Test-Post/Test-Other-File.pdf)
[Text](2019-02-14-Test-Post/Test-Other-File.pdf)
```

After this we'll get the right asset path result in:

- Blog home page of `hexo server` preview;
- Blog post page of `hexo server` preview;
- Blog home page of online website;
- Blog post page of online website;
- Markdown preview of editors like VS Code.

Now shall we just have fun writing!

## Reference

- [Filter | Hexo](https://hexo.io/api/filter "Filter | Hexo")
- [Posts | Hexo](https://hexo.io/api/posts "Posts | Hexo")
- [`new URL`](https://nodejs.org/docs/latest-v18.x/api/url.html#new-urlinput-base)
- [`url.pathname`](https://nodejs.org/docs/latest-v18.x/api/url.html#urlpathname)
- [RegExp - JavaScript | MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp "RegExp - JavaScript | MDN")

hexo-asset-link

hexo-asset-link Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

hexo-asset-link

hexo-asset-link Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README