hexo-reference-plus

hexo-reference-plus

English | 简体中文

GIF preview (3mb)

A hexo plugin to support reference and footnotes marked by markdown in your hexo blog

• auto serial number

• tooltip with tippy.js

• easy to use grammar

• configuration in front-matter for minimize

Inspried by hexo-reference.

Install

yarn add hexo-reference-plus

or

npm install hexo-reference-plus

Usage

All you need to do is Three steps: First, set refplus: true in your hexo markdown file's front-matter, like

---
title: hexo-reference-plus
date: 2021-09-24 15:49:08
refplus: true
---

Second, you mark the references in the end, and assign each reference an alias(generally recommend do not contain serial number) like:

{% references %}
[mcf-2021]  Max C. Foo.  A way to write an article.[J] Journal of Kelaideng University Samwin School. 2021.3 300-321.
{% endreferences %}

Third mark the alias in the area you want, like:

So here is the way what Max C. Foo(2021){% ref mcf01 %} do.

that's it.

thoughts

some thoughts

In past the days, I always wrote posts in hexo quote some references by the markdown links grammar. But it's not an elegant way to do that: you need to manage the serial numbers and links to this or that, or any other things else.

Maybe are there some plugins which can help me optimize this process? In fact, I found hexo-reference above, but it's not all designed for me exactly. Also, there is still a serial numbers management problem. so I develop this plugin.