I'll take a quiet life. A handshake of carbon monoxide.

0%

为Hexo博客添加文章链接:hexo-tag-post-link

原创文章,转载请标明出处:Soul Orbit
本文链接地址:为Hexo博客添加文章链接:hexo-tag-post-link

文章链接是写博客时一个非常常用的东西,因为如果每次写博客都需要在文章前后加上一个几乎格式一模一样的东西,还是很烦人的,特别如果你突然决定改变文章的永久链接,那么就更加烦人了,因为默认在Hexo里面,我们需要一篇文章一篇文章的把所有的文章链接改了(虽然这种情况我们需要尽量避免),所以这里我写了一个小插件来帮我们简化这个步骤————hexo-tag-post-link。

项目地址:https://github.com/r12f/hexo-tag-post-link

1. 安装

和其他的hexo插件一样,hexo-tag-post-link安装起来十分简单,只需要在博客目录下执行如下命令即可:

1
npm install hexo-tag-post-link --save

2. 使用方法

2.1. 插入标签

hexo-tag-post-link使用起来非常的直观,我们需要做的主要就是在博客里面你喜欢的位置加入一个标签,格式如下:

1
{% post_link <template_name> %}

这里template_name是我们指定的模板名字,比如,如果我们的模板名字叫做header,那么我们只需要插入如下标签:

1
{% post_link header %}

2.2. 配置模板

接下来,我们只需要把模板配置好就可以了。

  1. 首先我们需要在source目录下创建一个_data目录,如果没有的话。source/_data这个目录是Hexo的数据目录,用来存放一些公用的全局数据,所以的模板文件也放在这里。

  2. 现在在_data目录下创建一个名为post_link.yml的文件,这个文件就是我们的配置文件了。

  3. 现在我们可以来添加模板了!模板的格式非常简单,如下:

    1
    name: format

    比如我的博客使用的配置如下,而最后的效果就如本文最上方显示的那样。

    1
    header: <b>原创文章,转载请标明出处:</b><a href="<%= site_url %>" target="_blank"><%= site_title %></a><br/><b>本文链接地址:</b><a href="<%= post_permalink %>" target="_blank"><%= post_title %></a>

2.2.1. 模板变量

大家可以看到这个模板里面有各种变量,这些变量是由underscore.js的template来支持的,目前支持的变量主要有两种:

  • 网站信息
    • site_title
    • site_subtitle
    • site_description
    • site_author
    • site_url
  • 文章信息
    • post_title
    • post_slug
    • post_created
    • post_created_date
    • post_created_time
    • post_updated
    • post_updated_date
    • post_updated_time
    • post_relative_url
    • post_permalink

2.2.2. 模板变量再求值

underscore.js提供的模板非常强大,它支持在其中执行任意的JavaScript,我们可以用其对模板中的变量进行再求值来输出一些没有支持的内容。

打个比方,比如,我们希望用一个特定的格式输出文章的创建时间,那么我们可以使用如下语法:

1
<% print(post_created.format('YYYY-MM-DD')) %>

3. 结尾

好的,那么对这个插件我们就介绍到这里吧,但愿能对大家有用。
如果有任何其他问题,欢迎大家去github上给我开bug,甚至发pullrequest给我,多谢大家!