hexo-helper-live2d插件食用指北

忠告:使用 live2d 插件的话会使网页加载速度变慢,请酌情使用。

介绍

hexo-helper-liv2d 是一个在您博客上添加 live2d 模型(看板娘! )的插件,可以十分方便地在网页上展示 live2d 模型。

安装

安装 hexo-helper-live2d 插件十分简单,只需要在博客目录执行:

npm install --save hexo-helper-live2d

或者使用 yarn 安装:

yarn add hexo-helper-live2d

更多模型

有许多方法来使用不同的模型:

a. 使用 npm 模块(推荐)

使用现有的

我们有许多现有的模型,来看看

点我如果你不想跳转
  • live2d-widget-model-chitose
  • live2d-widget-model-epsilon2_1
  • live2d-widget-model-gf
  • live2d-widget-model-haru/01 (use npm install --save live2d-widget-model-haru)
  • live2d-widget-model-haru/02 (use npm install --save live2d-widget-model-haru)
  • live2d-widget-model-haruto
  • live2d-widget-model-hibiki
  • live2d-widget-model-hijiki
  • live2d-widget-model-izumi
  • live2d-widget-model-koharu
  • live2d-widget-model-miku
  • live2d-widget-model-ni-j
  • live2d-widget-model-nico
  • live2d-widget-model-nietzsche
  • live2d-widget-model-nipsilon
  • live2d-widget-model-nito
  • live2d-widget-model-shizuku
  • live2d-widget-model-tororo
  • live2d-widget-model-tsumiki
  • live2d-widget-model-unitychan
  • live2d-widget-model-wanko
  • live2d-widget-model-z16

你需要先使用 npm install 模型的包名 来安装,

然后将包名输入位于 _config.ymlmodel.use 中。
例如:

model:
use: live2d-widget-model-z16

发布你自己的模型包(dalao!)

  • 新建一个目录,在 Node 环境下执行 npm init,我们推荐您使用 live2d-widget-model-xxx 的包名。

  • 在刚刚创建的目录下创建 assets 子目录,把你的模型放进去。

示例:

live2d-widget-model-wanko

  • 使用 npm publish 来发布。

b. live2d_models 子目录名称

  1. 在您博客根目录下创建一个 live2d_models 文件夹。

  2. 在此文件夹内新建一个子文件夹。

  3. 将你的 live2d 模型复制到这个子文件夹中。

  4. 将子文件夹的名称输入 _config.ymlmodel.use 中。

示例

你的模型叫 mymiku

在博客根目录 (应当有 _config.ymlsourcesthemes ) 新建名为 mymiku 的子文件夹。

将模型复制到 /live2d_models/mymiku/ 中。

现在,在这里应当有一个 .model.json 文件 (例如 mymiku.model.json)在 /live2d_models/mymiku/ 中。

mymiku 输入到位于 _config.ymlmodel.use 中。

c. 相对于博客根目录的自定义路径

您可直接输入相对于博客根目录的自定义路径到 model.use 中。

示例: ./wives/wanko

d. 使用CDN

如果你是没有 CDN 会死星人,请直接将 .model.json 的 url 地址输入 model.use.。

配置

配置项需要一些 Yaml 语法的基础知识,可以参见 YAML 语法简介

修改 Hexo 的配置文件(或者主题的配置文件) _config.yml

示例(使用了 npm 模块安装的模型)

live2d:
enable: true
scriptFrom: local
model:
use: live2d-widget-model-wanko
display:
position: right
width: 150
height: 300
mobile:
show: true

当然,上面只是我的一个示例,完整的配置选项在下面(如果不想看的话,可以直接复制我的示例文件)。

# Live2D
## https://github.com/EYHN/hexo-helper-live2d
live2d:
enable: true
# enable: false
scriptFrom: local # 默认
pluginRootPath: live2dw/ # 插件在站点上的根目录(相对路径)
pluginJsPath: lib/ # 脚本文件相对与插件根目录路径
pluginModelPath: assets/ # 模型文件相对与插件根目录路径
# scriptFrom: jsdelivr # jsdelivr CDN
# scriptFrom: unpkg # unpkg CDN
# scriptFrom: https://cdn.jsdelivr.net/npm/live2d-widget@3.x/lib/L2Dwidget.min.js # 你的自定义 url
tagMode: false # 标签模式, 是否仅替换 live2d tag标签而非插入到所有页面中
debug: false # 调试, 是否在控制台输出日志
model:
use: live2d-widget-model-wanko # npm-module package name
# use: wanko # 博客根目录/live2d_models/ 下的目录名
# use: ./wives/wanko # 相对于博客根目录的路径
# use: https://cdn.jsdelivr.net/npm/live2d-widget-model-wanko@1.0.5/assets/wanko.model.json # 你的自定义 url
display: # 模型展示的位置设置
position: right # 方位
width: 150 # 宽度
height: 300 # 高度
mobile:
show: true # 在移动设备上是否开启live2d

使用

当你在配置好后,live2d 就已经开始运行了。


各模型包示例待完善

官方文档

hexo-helper-liv2d

Author: Odeinjul
Link: http://odeinjul.ooo/hexo-helper-live2d.html
Copyright Notice: All articles in this blog are licensed under CC BY-NC-SA 4.0 unless stating additionally.