关于hexo:Hexo部分配置及标签插件使用说明

21次阅读

共计 3305 个字符,预计需要花费 9 分钟才能阅读完成。

参考文档:

标签插件参考:https://hexo.io/plugins/

性能插件参考:https://hexo.io/zh-cn/docs/tag-plugins

资源文件夹参考:https://hexo.io/zh-cn/docs/asset-folders.html

Markdown(md)写作模板:https://www.bas369.com/more/learning_notes/2020/03/14/Markdown%E5%86%99%E4%BD%9C%E6%A8%A1%E6%9D%BF/

1. 标签插件介绍

Hexo 官网的标签插件参考链接:
https://hexo.io/zh-cn/docs/tag-plugins
若官网的参考文档表述不明;
请参考官网的 代码库 联合 浏览器的 F12 调试性能进行测试;
标签插件代码库的装置门路为:\node_modules\hexo\lib\plugins\tag
以下的测试阐明,基于 Hexo 的官网主题进行,未进行基于其余主题的测试;
其余主题可能存在 bug,因为其余主题可能会批改官网默认的标签插件设置;
标签插件的固定格局为:花括号 % 属性 其余参数 % 花括号
属性 指 html 标签 或者 hexo 事后定义的标签;
例如:img、link、asset_img、post_link 等等;

hexo 根目录的局部配置(留神:不是主题目录的配置)阐明:
index_generator:
path: ”
per_page: 10 # 定义每一个分页显示多少篇文章;0 示意首页显示全副文章;
order_by: -date

# Pagination
## Set per_page to 0 to disable pagination
per_page: 10 # 定义文章归档页面,每一个页面显示多少篇文章明细;
pagination_dir: page

2. 文章增加图片

关上我的项目根目录的配置文件 config.yml,留神,不是主题的配置文件;
将配置文件中的 post_asset_folder 选项设为 true 来关上;
这样的话,在执行 hexo new post 文章 ,新建 文章.md 文件的时候;
会同时建设同名的 文章 资源文件夹;
如果没有资源须要从 文章 资源文件夹 援用,
那么能够删除该文件夹,hexo 在执行渲染的时候,不会出错;
而且 文章 资源文件夹在通过 hexo 执行 html 渲染后,文件夹也会被删除;
文件夹的资源会被挪动到与 文章.html 雷同的目录;
所以,在 文章.md 援用文件夹资源的时候,才不须要蕴含门路;

2.1. 办法一:不指定图片的大小;

花括号 %  固定属性 asset_img  寄存在资源文件夹的图片名称及后缀不须要门路  图片说明  % 花括号

留神:各参数之间以 空格 宰割,图片的默认大小为文章的宽度;理论显示图片高度是依照图片宽度等比例缩放;示例:{% asset_img test.jpg 图片介绍 %}  

asset_img 标签插件的 bug 阐明及批改:
在 hexo 中,如果 markdown 文件中 在 asset_img 标签之前的文本中,
应用了 三个反引号的 代码块标识符;
那么在后文中呈现的 asset_img 标签插件就会解析失败;

解决办法:批改 \node_modules\hexo\lib\extend\tag.js 代码,替换上面的语句;// 原代码 
// str = str.replace(/[\s\S]*?<\/code><\/pre>/gm, escapeContent);
// 批改后:str = str.replace(/[\s\S]*?<\/code><\/pre>/gm, escapeContent);  
/* 参考文档如下:https://segmentfault.com/q/1010000012070918  
解决办法是增加一个问号?,将    改为;增加一个?问号,把正则表达式改为非贪心的;批改前:str = str.replace(/(?:)?[\s\S]*?<\/code>(?:<\/pre>)?/gm, escapeContent);  
批改后:str = str.replace(/(?:)?[\s\S]*?<\/code>(?:<\/pre>)?/gm, escapeContent); 
*/

2.2. 办法二:指定图片的大小;

应用 hexo 官网的标签插件;
参考链接:https://hexo.io/zh-cn/docs/tag-plugins#Image

语法:花括号 %  固定属性 img  样式表的类名, 能够是多个以空格分隔也能够留空白  图片残缺的 http 门路, 也能够应用文章的资源文件夹  图片宽度, 不能够写上 px 单位, 默认单位是 px  图片高度不须要单位  '"图片说明文字"  "显示图像失败的代替文本"'  % 花括号

留神:理论显示图片高度是依照宽度等比例缩放;相当于高度参数理论未起作用,然而不能省略;示例:未设置样式表;{% img https://cn.bing.com/th?id=OHR.BurgAltdahn_ZH-CN8281669977_1920x1080.jpg 250 250 '"护眼高清风光壁纸" "护眼高清风光壁纸"' %} 

3. 文章链接 Link 插件应用

语法:花括号 %  固定属性 link  链接显示的文本  链接的 http 网址  true 或者 false 管制是否增加 target="_blank" 属性  鼠标悬浮在链接上显示的 title 属性文本  % 花括号

示例:花括号 % link 百度网址超链接 https://www.baidu.com/ true 百度 % 花括号

渲染后果:百度网址超链接

4. 援用 站内 其余文章链接地址的办法

以下 post_pathpost_link 两个属性办法的区别是:
post_path 返回的是字符串;
post_link 返回的是超链接;

4.1. 办法一:花括号 % post_path filename % 花括号;该办法不罕用;

示例:{% post_path Markdown 写作模板 %}

返回 Markdown 写作模板 文章的站内链接地址字符串如下所示:/2020/03/14/Markdown 写作模板 /

留神:返回的不是超链接;是一串字符;

4.2. 办法二:应用 post_link 属性,举荐应用的办法;

语法阐明:{%  固定属性 post_link  站内指标文章的题目  用来代替指标文章的题目在本页面内显示的文字,同时作为鼠标悬浮的时候显示 title 属性的文字,默认链接文字是文章的题目, 如果蕴含空格的话那么应用英文单引号裹起来,否则的话不须要单引号  true 或者 false,用来管制是否对援用文章的题目和自定义题目里的特殊字符进行本义,默认值为 true 本义  %}

示例:{% post_link Markdown 写作模板 跳转到–Markdown 写作模板–文章 true %}

返回跳转到 Markdown 写作模板 文章的站内超链接,成果如下所示:跳转到 -- Markdown 写作模板 -- 文章 

留神:1. 生成的链接默认不带有 target=”_blank”属性;2. 在应用此标签时能够 疏忽 文章文件所在的 门路 或者 文章的永恒链接信息、如语言、日期;只有存在一个名为 Markdown 写作模板.md 的文章文件即可。

5. 资源的援用

5.1. 资源存储门路字符串的返回;

语法:花括号 %  固定的属性 asset_path  资源文件夹中资源的名称,例如图片名称及后缀不须要门路  % 花括号

示例:{% asset_path test.jpg %} 

返回 test.jpg 图片资源的站内链接地址字符串如下所示:/2020/03/14/Markdown 写作模板 /test.jpg

留神:返回的不是超链接;是一串字符;

5.2. 资源存储门路超链接网址的返回,能够用作附件下载链接生成;

语法:花括号 %  固定的属性 asset_link  资源文件夹中资源的名称,例如图片名称及后缀不须要门路  自定义显示的资源名称替换资源文件名同时作为鼠标悬浮时候显示的 title 属性文字说明,默认显示资源的文件名称  % 花括号

示例:{% asset_link test.jpg test.jpg 图片附件的下载测试 %}

返回本文章援用的 test.jpg 图片资源的残缺 http 超链接地址:test.jpg 图片附件的下载测试

留神:返回的是超链接下载地址。

以上是本人应用 hexo 的简要总结阐明。

正文完
 0