hexo-helper-live2d @Odeinjul Writing 3.1.0

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

介绍

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

展示

安装

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

npm install --save hexo-helper-live2d

或者使用 yarn 安装：

yarn add hexo-helper-live2d

更多模型

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

a. 使用 npm 模块（推荐）

使用现有的

我们有许多现有的模型，来看看 (opens new window)

点我如果你不想跳转

• 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.yml 的 model.use 中。 例如：

  model:
    use: live2d-widget-model-z16

发布你自己的模型包（dalao！）

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

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

示例

live2d-widget-model-wanko (opens new window)

• 在 npm (opens new window) 注册一个账号。

• 使用 npm publish 来发布。

提醒

关于创建、发布 npm 包，可以查看 手把手教你创建你的第一个 NPM 包 (opens new window)。

b. live2d_models 子目录名称

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

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

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

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

示例

你的模型叫 mymiku 。

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

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

现在，在这里应当有一个 .model.json 文件 （例如 mymiku.model.json ）在 /live2d_models/mymiku/ 中。

将 mymiku 输入到位于 _config.yml 的 model.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-live2d (opens new window)