Hello World

翻译：qtqt_Eric_Chiu

这是Hexo自带的文章示范，记录了一些常用指令。翻译过程中结合本人实际使用有删改与增补。
本文后半部分为本博客使用的一些插件的使用文档。

欢迎来到 Hexo！这是你新鲜出炉的首篇推文。在这之前，请先阅读文档以获得更多资讯。如果你在使用Hexo的过程中有任何困难，你可以在疑难解答寻找解决方案或在GitHub向我寻求帮助。

快速开始

创建一篇新的推文

1
2

$ hexo new [post(推文)|page(网页)|draft(草稿)|(scaffolds文件夹里的任何模板)] "我的新推文"
$ hexo publish [布局] <文件名> *发表草稿

更多请参阅: 写作

本地运行服务

1

$ hexo server|s --debug

更多请参阅：服务器

生成静态文件 | 部署到远程站点

1

$ hexo generate|g --deploy|d

更多请参阅：生成 | 更多请参阅：部署

速通

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

安装Node.js https://registry.npmmirror.com/binary.html?path=git-for-windows/
安装Git https://nodejs.org/en/download/
打开指定文件夹 shift+右键在此处打开Powershell/cmd
安装Hexo $ npm install -g hexo-cli
新建站点 $ hexo init <文件夹名称>
进入站点 $ cd <folder>
安装Hexo $ npm install
配置 _config.yml
安装部署器 $ npm install hexo-deployer-git --save
修改配置：
  deploy:
  type: git
  repo: <repository url> #https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
  branch: [branch]
  message: [message]
$ hexo clean && hexo deploy
故障排除：
  <SSL certificate problem: unable to get local issuer certificate>解决：
    git config --global http.sslVerify false
RSS提供 $npm install hexo-generator-feed --save

hexo-tag-steamgame@HCLonely

在Hexo博客中嵌入steam游戏。

安装

1

$ npm install hexo-tag-steamgame --save

使用方法

• 嵌入单个游戏

1

{% steamgame appid description %}

• 批量嵌入游戏

1
2
3
4
5
6
7
8

{% steamgames %}
appid
appid
appid
appid
appid
appid
{% endsteamgames %}

参数

1
2

appid: Steam 游戏 id.
description(可选): 用于替换默认游戏简介。

License: MIT

hexo-bilibili-bangumi@HCLonely

介绍

为 Hexo 添加哔哩哔哩/Bangumi追番/追剧页面，参考自hexo-douban.

安装

1

$ npm install hexo-bilibili-bangumi --save

配置

将下面的配置写入站点的配置文件 _config.yml 里(不是主题的配置文件).

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

bangumi: # 追番设置
  enable: true
  source: bgm
  bgmInfoSource: 'bgmSub'
  path:  #页面路径，默认bangumis/index.html
  vmid: qtqt
  title: '番剧'
  quote: '通过<a href="https://bgm.tv/">bgm.tv</a>整理 | 基于<a href="https://github.com/HCLonely/hexo-bilibili-bangumi">hexo-bilibili-bangumi</a>构建 '
  show: 1 #初始显示页面：`0: 想看`, `1: 在看`, `2: 看过`，默认为`1`
  lazyload: true
  srcValue: '__image__' #lazyload开启时无效
  lazyloadAttrName: 'data-src=__image__' #lazyload开启时无效
  loading: #图片加载完成前的 loading 图片，需启用图片懒加载
  showMyComment: true
  pagination: false #分页优化，只将第一页的数据渲染到`html`文件中，其余数据将通过异步请求加载，避免番剧过多时html文件过大导致页面加载缓慢，建议番剧较多时使用，默认`false`
  metaColor: #metaColor: meta 部分(简介上方)字体颜色
  color: #color: 简介字体颜色
  webp: false #webp: 番剧封面使用webp格式(此格式在safari浏览器下不显示，但是图片大小可以缩小 100 倍左右，仅支持哔哩哔哩源), 默认true
  progress: true #获取番剧数据时是否显示进度条，默认true
  extraOrder: #手动添加的番剧/追剧数据是否优先显示，`1`为优先，其它为不优先
  proxy: #代理设置，仅在使用支持bgm源追番时生效。默认留空
    host: ''
    port: ''
  extra_options: #此配置会扩展到Hexopage变量中
    key: value

• source: 数据源，bgm仅支持追番，追剧仅支持哔哩哔哩源。bili: 哔哩哔哩源, bgm: Bangumi源
• bgmInfoApi: 获取Bangumi番剧信息时使用的Api，仅使用Bangumi源时此选项生效。bgmApi: Bangumi Api, bgmSub: Bangumi-Subject
• vmid: 哔哩哔哩的 vmid(uid)如何获取？或Bangumi的用户id如何获取？
• quote: 写在页面开头的一段话，支持 html 语法，可留空。
• lazyload: 是否启用图片懒加载，如果与主题的懒加载冲突请关闭，默认true
• srcValue: 设置封面图的默认src值, __image__为封面链接, __loading__为loading图片链接, lazyload选项为false时此选项生效
• lazyloadAttrName: 设置封面图的属性与属性值, 例lazyloadAttrName: 'data-src=__image__'代表为img元素添加data-src属性, 其值为图片链接, lazyload选项为false时此选项生效
• loading: 图片加载完成前的 loading 图片，需启用图片懒加载

使用

1. 在hexo generate或hexo deploy之前使用hexo bangumi -u命令更新追番数据，使用hexo cinema -u命令更新追剧数据！
2. 删除数据命令:hexo bangumi -d/hexo cinema -d

获取 Bangumi id

登录Bangumi后打开控制台(Ctrl+Shift+J)，输入CHOBITS_UID回车，下面会输出id

手动添加番剧/追剧数据

在 sources/_data/ 目录下新建文件，命名为 extra_bangumis.json(追番数据)或extra_cinemas.json(追剧数据) ，并添加以如下内容:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

{
  "watchedExtra": [
    {
      "title": "缘之空",
      "type": "番剧",
      "area": "日本",
      "cover": "https://cdn.jsdelivr.net/gh/mmdjiji/bangumis@main/Yosuga-no-Sora/cover.jpg",
      "totalCount": "全12话",
      "id": 0,
      "follow": "不可用",
      "view": "不可用",
      "danmaku": "不可用",
      "coin": "不可用",
      "score": "不可用",
      "des": "远离都市的田园小镇，奥木染。春日野悠带着妹妹穹，来到了这座城镇。坐落在这里的是，儿时暑假经常造访的充满回忆的已故祖父的家。双亲因意外事故而丧生，变得无依无靠..."
    }
  ]
}

title 是番剧的标题，cover 是封面图链接， des 是简介，上述字段均根据需要修改。

另外除了 watchedExtra 数组，还可以在后面添加新的数组，可用数组名如下:

需要注意，在两个数组之间需要用 , 分隔。

Lisense: Apache Licence 2.0

hexo-tag-aplayer@MoePlayer

APlayer 播放器的 Hexo 标签插件（现已支持 MetingJS）。

docs by Nexmoe’s Theme link

安装

在你的 Hexo 程序根目录（与_config.yml同目录）下

1

npm install --save hexo-tag-aplayer

打开 Meting

引入 MetingJS 后，播放器将支持对于 QQ音乐、网易云音乐、虾米、酷狗、百度等平台的音乐播放。

在 Hexo 配置文件 _config.yml 中设置：

1
2

aplayer:
  meting: true

使用

接着就可以通过 {% meting ...%} 在文章中使用 MetingJS 播放器了：

1
2
3
4
5

<!-- 简单示例 (id, server, type)  -->
{% meting "60198" "netease" "playlist" %}

<!-- 进阶示例 -->
{% meting "60198" "netease" "playlist" "autoplay" "mutex:false" "listmaxheight:340px" "preload:none" "theme:#ad7a86"%}

参数

有关 {% meting %} 的选项列表如下:

LICENSE: MIT

hexo-admonition@lxl80

支持的类型

提示类型 type 将用作 CSS 类名称，暂支持如下类型：

• note
• info, todo
• warning, attention, caution
• error, failure, missing, fail

设置/隐藏标题

标题 title 是可选的，当未设置时，将以 type 作为默认值:

1
2

!!! warning
    这是一条采用默认标题的警告信息。

效果如下：

如果不想显示标题，可以将 title 设置为 ""：

1
2

!!! Warning ""
    这是一条不带标题的警告信息。

效果如下：

嵌套 markdown 标记

在 hexo-admonition 内部，还可以嵌套标准 Markdown 标签，例如：

1
2
3

!!! note "嵌套链接及引用块"
    欢迎访问我的博客链接：[悟尘纪](https://www.lixl.cn)
    >这里嵌套一行引用信息。

效果如下:

样式配置

将如下样式放入 hexo 主题的自定义样式文件中（如：my.css），并按自己喜好修改：

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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

.admonition {
  margin: 1.5625em 0;
  padding: .6rem;
  overflow: hidden;
  font-size: .64rem;
  page-break-inside: avoid;
  border-left: .3rem solid #42b983;
  border-radius: .3rem;
  box-shadow: 0 0.1rem 0.4rem rgba(0,0,0,.05), 0 0 0.05rem rgba(0,0,0,.1);
  background-color: #fafafa;
}
p.admonition-title {
  position: relative;
  margin: -.6rem -.6rem .8em -.6rem !important;
  padding: .4rem .6rem .4rem 2.5rem;
  font-weight: 700;
  background-color:rgba(66, 185, 131, .1);
}
.admonition-title::before {
  position: absolute;
  top: .9rem;
  left: 1rem;
  width: 12px;
  height: 12px;
  background-color: #42b983;
  border-radius: 50%;
  content: ' ';
}
.info>.admonition-title, .todo>.admonition-title {
  background-color: rgba(0,184,212,.1);
}
.warning>.admonition-title, .attention>.admonition-title, .caution>.admonition-title {
  background-color: rgba(255,145,0,.1);
}
.failure>.admonition-title, .missing>.admonition-title, .fail>.admonition-title, .error>.admonition-title {
  background-color: rgba(255,82,82,.1);
}
.admonition.info, .admonition.todo {
  border-color: #00b8d4;
}
.admonition.warning, .admonition.attention, .admonition.caution {
  border-color: #ff9100;
}
.admonition.failure, .admonition.missing, .admonition.fail, .admonition.error {
  border-color: #ff5252;
}
.info>.admonition-title::before, .todo>.admonition-title::before {
  background-color: #00b8d4;
  border-radius: 50%;
}
.warning>.admonition-title::before, .attention>.admonition-title::before, .caution>.admonition-title::before {
  background-color: #ff9100;
  border-radius: 50%;
}
.failure>.admonition-title::before,.missing>.admonition-title::before,.fail>.admonition-title::before,.error>.admonition-title::before{
  background-color: #ff5252;;
  border-radius: 50%;
}
.admonition>:last-child {
  margin-bottom: 0 !important;
}

LICENSE: MIT

EYHN@hexo-tag-cplayer

一个 Hexo 插件，帮助使用 cPlayer

English README

如何使用

1

npm install hexo-tag-cplayer --save

添加像这样的代码到你的文章中。cplayer 将会生成在那里。

1
2
3

{% cplayer [autoplay] [yaml|cson|json] %}
# type your config here
{% endcplayer %}

设置范例

YAML:

1
2
3
4
5
6
7

{% cplayer autoplay %}
- name: チルドレンレコード # 名字
  artist: 96猫,伊東歌詞太郎 # 艺术家
  poster: https://cplayer.js.org/801422833716a4f0f96ff6dff1f77dfe.jpg # 音乐海报
  src: https://cplayer.js.org/8af423669c27d265bb129d04a927044f.mp3 # 音乐资源链接
- 27955597 # 网易云音乐 ID
{% endcplayer %}

上面的配置会添加2首歌。 “チルドレンレコード” 和 “Crazy For You”（从网易云音乐）

wshunli@hexo-tag-mplayer

翻译：qtqt_Eric_Chiu

使用标签即可在Hexo中展示cPlayer。

安装

1

$ npm install hexo-tag-mplayer --save

快速开始

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

{% mplayer %}
    playlist: [
        {
            name: 'Song name...',
            artist: 'Singer name...',
            src: 'Song resource link...',
            poster: 'Song Cover link...',
            lyric: 'Lyrics...',
            Sublyric: 'Deputy lyrics, generally for translation...'
        },
        {
            ...
        },
        ...
    ],
    autoplay: true,
    volume: 0.75,
    playmode: "listloop",
    big: true,
    dark: false
{% endmplayer %}

获取更多信息，请点击这里访问hexo-tag-mplayer Demo。 （译注：已失效）

选项

获取更多信息，请点击这里访问CPlayer Demo。

鸣谢

感谢cPlayer&受hexo-tag-cplayer启发而来。

License