HEXO的开发文档

HEXO的官网是：Hexo.io
可以在网站调出开发文档，知道某些参数的具体作用
本页仅提供参考以及备忘，实际需要自己添加参数

1、最主要的文章撰写

目前我常用文章头目录的如下所示，以后如果加入什么新功能会同步上

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
---
title: //这里写的是标题
cover: ""  //这里可以指定文章封面用什么图片，比如我用的是调用必应的每日壁纸api：https://bingw.jasonzeng.dev
其实这里的api不是官方的，但是暂时可用，先用下去，不能的时候再修改。这里提示下：https://bingw.jasonzeng.dex 调用的是今日壁纸  url后面+/?index=random 代表随机壁纸|+/?date=20200808 代表指定日期，但是2020 3月以前的调取不到
date: 2023-08-10 23:00:00 //这里写的是第一次编辑该文章的时间
updated: 2023-08-10 23:00:00 //这里写的是更新时间
swiper_index: //这里填写自然数，这个的实现的功能是我博客首页那个轮回播放，会按顺序播放文章
highlight_shrink: //代码高亮收缩
tags:
- xxxx //标签
categories: //类型
toc: true //这是开启文章目录的开关，true表示开启，false关闭
password: 。。。  //密码随意，自己记住就行
abstract: 你来到了无人的荒野上，请输入密码进入下一个世界  //摘要
message: 诶，这是需要什么呢？( •̀ ω •́ )y   //提示框选项
wrong_pass_message: 非法爆破是不好的哦╰(艹皿艹 )   //wrong信息提示
wrong_hash_message: 不能被校验, 不过还是能看看解密后的内容。  //防止f12调用
hidden: true //开启隐藏文章，只可以通过链接调用，hexo hidden:list可以看到隐藏文章列表
description: //添加描述
---

下面的是有关文章内，段落与代码部分框架的展示

1
2
3
//blockquote  endblockquote   这是文本框的调用，往这两个尖括号里面加东西就行了
//codeblock  endcodeblock     这是调用代码展示框的调用，往这两个尖括号加代码就行
//hideToggle 点击阅读, #FF7242, #fff  endhideToggle 这是点击展开框，hideToggle后面先文字，后颜色，再文本颜色

2、常用功能解释

这个是网易云音乐插件aplayer的调用

1
//meting "这里填入网易云音乐的id就行" "netease" "song"  上面是调用aplayer，播放音乐

这个是调用外部源的bilibili，实现视频播放

1
2
3
4
5
6
7
8
9
10
11
<div align=center class="aspect-ratio">
   <iframe src="这里填哔哩哔哩提供的外嵌地址或者是其他的外嵌地址" 
   scrolling="no" 
   border="0" 
   frameborder="no" 
   framespacing="0" 
   high_quality=1
   danmaku=1 
   allowfullscreen="true"> 
   </iframe>
</div>

页脚部分js代码，不公开展示，需要私信我才能复制

1
2
 旅行者一号当前距离地球${t}千米，约为${a}个天文单位🚀再看看那个光点，它就在这里，这是家园，这是我们 —— 你所爱的每一个人，你认识的每一个人
，你听说过的每一个人，曾经有过的每一个人，都在上面度过他们的一生🌟

3、关于gallery的展示，可以看我的Game的网页

就如网页上面显示的那样，显示一个个图文框，可以跳转到网页，利用的是下面的源码
galleryGroup name description link img-url

name description link img-url
圖庫名字 圖庫描述 连接到对应相册的地址 图库封面的地址

以下是示例，记得是尖括号加百分号那种格式，下面可能显示不出来

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<div class="gallery-group-main">
  
<figure class="gallery-group">
<img class="gallery-group-img no-lightbox" src='https://bingw.jasonzeng.dev/?index=118' alt="Group Image Gallery">
<figcaption>
<div class="gallery-group-name">跳房子</div>
<p>一个点击跳跃房子逃离激光的小游戏</p>
<a href='https://haiyong.site/moyu/tiaofangzi.html'></a>
</figcaption>
</figure>

  
<figure class="gallery-group">
<img class="gallery-group-img no-lightbox" src='https://bingw.jasonzeng.dev/?index=128' alt="Group Image Gallery">
<figcaption>
<div class="gallery-group-name">植物大战僵尸</div>
<p>网页版</p>
<a href='https://haiyong.site/moyu/pvz/'></a>
</figcaption>
</figure>

</div>

4、在网页加入表格的方法，利用Markdown语法

1
2
3
4
5
6

| 标题 | //这里是标题栏
| :------: | //这里表示居中，英文冒号代表是哪边的居中
| 文字描述 | //这里写文字
//注意要注意英文字符和空格缩进

5、防止源码在代码展示框中运行的方法是

{% raw %}在这里面加入code就行，比如上面的第三点就是没加raw的展示，第四点就是能展示出表格的源码{% endraw %}

6、文章内文字部分的高亮展示

{% label text color %}

参数 解释
text 填入你想要改变的文字
color 【可选】背景颜色，默认为 default default/blue/pink/red/purple/orange/green

这里展示下运行的源码和结果

1
2
3
4

臣亮言：{% label 先帝 %}创业未半，而{% label 中道崩殂 blue %}。今天下三分，{% label 益州疲敝 pink %}，此诚{% label 危急存亡之秋 red %}也！然侍衞之臣，不懈于内；{% label 忠志之士 purple %}，忘身于外者，盖追先帝之殊遇，欲报之于陛下也。诚宜开张圣听，以光先帝遗德，恢弘志士之气；不宜妄自菲薄，引喻失义，以塞忠谏之路也。
宫中、府中，俱为一体；陟罚臧否，不宜异同。若有{% label 作奸 orange %}、{% label 犯科 green %}，及为忠善者，宜付有司，论其刑赏，以昭陛下平明之治；不宜偏私，使内外异法也。


臣亮言：先帝 创业未半，而中道崩殂 。今天下三分，益州疲敝 ，此诚危急存亡之秋 也！然侍衞之臣，不懈于内；忠志之士 ，忘身于外者，盖追先帝之殊遇，欲报之于陛下也。诚宜开张圣听，以光先帝遗德，恢弘志士之气；不宜妄自菲薄，引喻失义，以塞忠谏之路也。
宫中、府中，俱为一体；陟罚臧否，不宜异同。若有作奸 、犯科 ，及为忠善者，宜付有司，论其刑赏，以昭陛下平明之治；不宜偏私，使内外异法也。

7、Markdown基本语法

Markdown 是一种标记语言，语法简单，易阅读易编写，可以让用户完全脱离鼠标写出样式丰富的文档，广受程序员喜爱，目前许多网站都已经支持通过 Markdown 语法来写文章或者发表评论。

元素 Markdown基本语法 预览演示
标题 # 大标题 ## 二级标题 ### 次级标题，以此类推 # 大标题 ## 二级标题 ### 次级标题
加粗 **需要的文字加粗的文字** 需要的文字加粗的文字
引用文字 > 引用文字 > 引用文字
有序列表 1.第一项 2.第二项 3.第三项，以此类推 1.第一项 2.第二项 3.第三项
无序列表 - 第一项 -第二项，以此类推 - 第一项 -第二项
链接 [链接/这里填超链接的文字](这里键入超链接的地址) 链接/这里填超链接的文字
水平线 ---，就三条横线就行 —-

8、在一个小标题下，显示不同标签页

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

  {% tabs Tab标签列表 %}
    <!-- tab 标签页1 -->
    标签页1文本内容
  <!-- endtab -->
  <!-- tab 标签页2 -->
    标签页2文本内容
  <!-- endtab -->
  <!-- tab 标签页3 -->
    标签页3文本内容
  <!-- endtab -->
  {% endtabs %}
  或者是
  {% tabs test4 %}
  <!-- tab 第一个Tab -->
  **tab名字为第一个Tab**
  <!-- endtab -->

  <!-- tab @fab fa-apple-pay -->
  **只有图标 没有Tab名字**
  <!-- endtab -->

  <!-- tab 炸弹@fas fa-bomb -->
  **名字+icon**
  <!-- endtab -->
{% endtabs %}

Demo展示

标签页1文本内容

标签页2文本内容

标签页3文本内容

tab名字为第一个Tab

只有图标 没有Tab名字

名字+icon

9、button按钮

通过 button 标签可以快速添加带有主题样式的按钮，语法如下：
{% button /path/to/url/, text, icon [class], title %}

文本 文本 & 标题 文本 & 图标 文本 & 大图标 (固定宽度)

10、gallery相册

这个可以根据需要加入到对应的md

1
2
3
4

{% gallery url,[link],[lazyload],[rowHeight],[limit] %}
{% endgallery %}

Demo

[{"url":"https://bingw.jasonzeng.dev/?index=random","alt":""}]

11、上传图床

这个是无限制容量高速访问的途径

1
2
3
git clone git@github.com:xieleihan/pic_bed.git
//将远程文件拉到本地让其可以运行
//这是利用到了GitHub无限容量的特点

1
2
3
4
5
# 将更改提交
git add .
git commit -m "更新图片"
# 推送至github仓库
git push

12、pdf使用

1
2
原本是打算用官方的插件 pdf来实现，苦于没有找到一个合适的cdn，最后决定用OneDrive实现，以下代码仅做备忘
{% pdf https://drive.google.com/file/d/1dRzj8C476KXrqDAZjHsXnRjb0O8K88nf/view?usp=drive_link %}

13、随机图片生成按钮

1
2
3
{% hideBlock 一张图片 %}
{% inlineImg https://source.unsplash.com/random 600px %} //里面已经填入了随机网站，可以自己更改其他网站，实现点击按钮展示图片
{% endhideBlock %}

感谢

最后，文章的结尾，感谢所有的hexo的插件源码等社区的开发人员，正因有你们，才有今天开源的繁荣。谢谢你们的付出，本博客的所有内容除了文字描述外，其他一律个人自由使用，无需征求授权。如果某些源码侵犯到开发者的权利，请联系我，我会下架有关的内容，并予以道歉。
那么，个人博客正式上线，谢谢每一个在苦难日子中，还在寻找光的我，时光知味，岁月沉香，纸短意长，谨致这一程奔赴的跌跌撞撞。