本说明文档为ACGbangumi.js文件的使用说明,具体配置流程可见B站视频。
目前,该脚本在获取动画以及漫画信息时能基本满足大部分使用情景。但游戏信息很有可能会出现本人暂时无法解决的BUG(即代码663行在有效的url下读取出的page是无效的)。后经本人初学API后验证,API也无法解决这个问题【目前该BUG似乎是作品为R18导致网页无法正常访问】。这个BUG如果大家有解决方法欢迎私信或评论区指出,感激不尽!
使用过程中有任何问题都可联系本人,B站月涟_luvian。反馈时最好说明清楚是在查找哪部作品时出现了什么报错信息。报错信息可在Obsidian中同时按下Ctrl+Shift+I打开控制台,最新最靠下的红色信息即为系统报错。
更新日志
v1.0:2024年4月
实现用正则表达式对Bangumi动画的信息一键导入
v2.0:2025年2月
新增用正则表达式对Bangumi漫画、部分游戏信息的一键导入。
新增动画信息的部分字段,新增标签筛选功能、个人评分输入功能。
修复之前版本的已知bug,包括但不限于:标题有标点的动画无法导入、角色名称导入失败。
未来更新计划:更换脚本实现逻辑,将所有正则表达式全部替换为API。随缘更新。
插件Templater
在模板中使用占位符<%+变量名称+%>,其中变量名称可以在文档开头利用---\n(文档属性开头标识符)+ <%*\n + let 变量名称 = 中间语句 \n +-%>\n +文档属性+---进行集中定义。这样定义可以保证生成笔记时只需定义一次便可在模板中多次呈现某个变量的内容。
中间语句:
tp.system.suggester(["标题1","标题2"],["内容1","内容2"])创建新文件时会可以自选状态
可能会遇到的问题:
新版Obsidian的编辑在文档属性的显示上做了优化,有可能在文档属性之前无法添加任何代码。解决方法:Obsidian设置-选项-编辑器-显示-文档属性。将值更改为”源码“。
插件QuickAdd
Obsidian快捷键Alt+p运行命令行,输入QuickAdd
按照模板添加笔记
请按照以下步骤配置:
- 先在插件面板选择Manage Macros,打开Macros管理器。新建一个Macro,名称随意。点击配置
Configure,只需要在User Scripts一栏中选择脚本,即运行信息的获取程序ACGbangumi.js。 - 返回到QuickAdd面板,建立一个Macro,名称随意。这里的名称会是以后运行QuickAdd程序时显示的最常用名称。输入名称、选择Macro类型后点击
Add choice即可。点击小齿轮进行配置,复选框中选择步骤1.中设定的Macro名称,关闭对话框即可保存配置。点击小雷电,确保小雷电颜色为黄色亮起。 - 在QuickAdd面板建立三个Template,名称必须是
Bangumi动画,Bangumi漫画,Bangumi游戏(如想修改,请同步修改脚本文件84行TemplateName的取值,务必保持一致)。(推荐建立一个Multi文件夹,用以收纳这三个模板,名称随意) - 在QuickAdd面板分别对三个Template做配置,点击小齿轮,模板路径
Template Path选择对应的Obsidian模板md文件(动画的Template选择动画的模板,以此类推),事先预定笔记名称File Name Format设定为开启,笔记名称File Name输入框输入{{VALUE:CN}}_动画,{{VALUE:CN}}_漫画,{{VALUE:CN}}_游戏。其余根据需要自行配置。(推荐Open开关设置为开启,即新创建的作品信息笔记会创建好后就打开) - 配置成功啦!已经可以按照模板添加新的读书笔记了。其中模板内可使用的语法:
{{VALUE:+变量+}},具体内容是需要看抓包程序的设定。本质上,获取到的信息保存在对象Info中。模板中的{{VALUE:+变量+}},在程序中是Info.变量。
为便于使用,将程序中抓取到的具体动画的信息变量做列表说明。
公用变量名称
| 变量 | 说明 |
|---|---|
| CN | 中文名 |
| JP | 日语名 |
| fileName | 中文名_日文名 |
| type | 作品类别 |
| rating | 总评分 |
| Poster | 作品海报封面 |
| url | 作品信息页面网址 |
| alias | 别名 |
| tags | 标签(自选后) |
| score | 个人评分(手动输入) |
| summary | 作品简介 |
| character | 1-9,各角色的名字 |
| characterCV | 1-9,对应角色声优名 |
| characterPhoto | 1-9,对应角色缩略图 |
动画特有变量
| 变量 | 说明 |
|---|---|
| website | 官方网站(取第一个) |
| episode | 作品集数 |
| director | 导演 |
| AudioDirector | 音响监督 |
| AnimeChief | 总作画监督 |
| ArtDirector | 美术监督 |
| staff | 脚本 |
| MusicMake | 音乐制作公司 |
| AnimeMake | 动画制作公司 |
| from | 原作 原作期刊 |
| fromWho | 原作作者 |
| fromWhere | 原作期刊 |
| date | 放送年月日 |
| year | 放送年份 |
| month | 放送月份 |
| paraList | 章节列表 |
| OpEd | SP OP ED列表 |
漫画特有变量
| 变量 | 说明 |
|---|---|
| author | 作者 原作 |
| episode | 作品话数 |
| staff | 作画 |
| Publish | 出版社 |
| Journal | 连载杂志 |
| ReleaseDate | 发售日 |
| Start | 开始连载时间 |
| End | 结束连载时间 |
| status | 连载状态 |
游戏特有变量
| 变量 | 说明 |
|---|---|
| platform | 平台 |
| playerNum | 游玩人数 |
| develop | 开发 |
| Publish | 发行 |
| script | 脚本 |
| music | 音乐 |
| art | 原画 |
| director | 导演 |
| producer | 制作人 |
| ReleaseDate | 发行日期 |
| price | 售价 |
| website | 官方网站 |