黄集攀/hjp

hjp-bilink使用介绍

• 
• 本插件实现在anki上简易的手动双向绑定.
• 依赖的第三方插件代码 1423933177 ,他提供了核心的卡片单向链接功能.
• 本插件将单向链接自动化实现链过去的同时又链回来,并且提供两种链接算法.
• 新增功能(已经实现),可以按两种方式取消卡片之间的链接.(未实现)链接的样式自定义修改
• 讨论QQ群:891730352
• 插件版本:0.2.1
• 插件地址

• 提醒:

  • 本插件只适用于windows和桌面linux系统,不适用于mac系统,安卓手机,iphone,ipad等移动端

插件的安装

hjp-bilink的安装

下载克隆这个插件仓库到本地,把文件夹hjp-bilink复制到anki的插件文件夹下,这个位置windows上一般是C:\Users\Administrator\AppData\Roaming\Anki2\addons21如果不知道插件文件夹在哪里,打开anki的工具>附加组件>查看文件也可以打开

依赖插件link Cards的安装

到工具>附加组件>获取插件输入1423933177 即可安装依赖插件装完以后记得重启anki

使用教程

目前这个工具用起来还是有一点繁琐的,将来会加入对话框功能,简化操作.

1. 打开browser

   • 就是在主界面点击浏览/browse弹出的那个窗口
   • 

2. 选取卡片记录插入input.json

   • 在browser窗口中选中几条你要双链的记录，在任何一条被选中的记录上点击鼠标右键，弹出上下文菜单，其中有
     • hjpCopyCidAlltoInputJson，
     • hjpAsGroupCopytoInputJson两个选项
   • 
   • 根据模式不同,选择不同的选项

     1. 当你需要使用

        1 linkall完全链接模式,

        2 unlinkNode按结点取消链接模式 ,

        3 unlinkPath按路径取消链接模式 时

        • 选择hjpCopyCidAlltoInputJson,就能把你选的这几条记录的card_id插入到input.json中
        • 你可以反复执行这个过程,把所有需要的卡片ID都录入到input.json中

     2. 当你需要使用 linkGroupToGroup 按组链接模式 时

        • 选择hjpAsGroupCopytoInputJson,把所有选中的记录作为一个组录入到input.json中,
        • 注意 组链接至少需要两个组才能正常工作
        • 你执行hjpAsGroupCopytoInputJson就是把选中的卡片编一个组插入到input.json中,所以想要实现链接到其他组,还得插入另一个编组.

3. (如果需要)打开input.json编辑卡片ID和描述desc,

   • 
   • 在你把想双链的卡的id都插入到这个input.json中后,你可以点击菜单栏上的hjp_link>show打开input.json
   • input.json里面都是你在第二步操作中输入的card_id还有程序默认提取的描述desc,你这时候可以修改默认的描述内容,你也可以不追加解释,走下一步操作.
   • 

4. 建立双向连接

   • 
   • 选择hjp_link>linkDefault就会根据预先在config.json>linkMode中配置好的链接算法,自动建立双向连接
   • 不过,如果你想使用其他模式,也可以直接点击其他模式,因为我们会经常切换加链接的方式,所以我把这些模式单列了出来:
     • 选择hjp_link>linkAll调用完全图算法链接每个记录，将input.json>IdDescPairs中的每一张卡双向连接到每一张卡,比如输入ABC,那么A中有BC,B中有AC,C中有BA的ID链接.
     • 选择hjp_link>linkGroupToGroup调用组链接算法链接各个组的记录.在input.json>IdDescGroups中会分成几个组,前一个组的每一张卡双向连接到后一个组的每一张卡.比如ABC是一个组，DEF是一个组，那么组间链接就是第一组：A到DEF,B到DEF,C到DEF，第二组：D到ABC，E到ABC,F到ABC。
     • 选择hjp_link>unlinkNode调用取消结点链接算法,相当于将input.json>IdDescPairs中列出的每个节点孤立，比如input.json>IdDescPairs中有节点A，那么程序会查询A卡片，并发现A连接到BCD，那么就会解除到BCD的链接，并且反向解除BCD到A的链接。
     • 选择hjp_link>unlinkPath调用取消路径链接算法,相当于将input.json>IdDescPairs中的彼此相连的节点按顺序解除绑定，比如输入input.json>IdDescPairs中的ABCD是彼此有链接的节点，那么程序就会从A节点开始，从A到B解除链接，B到C解除链接以此类推，但是不会解除A到其他结点的链接,比如A连接到BCD,但是你输入input.json>IdDescPairs的顺序是ABCD,那么A只会解除从A到B的链接,A到CD的链接保持不动。

5. (如果需要)清除json中的记录

   • 选择hjp_link->clear就能删掉之前的全部记录.
   • 如果不熟悉json的语法,千万别自己删json的结构,最好用clear清除记录,不容易破坏json结构,否则会频繁报错.
   • 如果你熟悉json的语法,以上操作也可以打开input.json手工完成录入.
   • 

配置指导

配置文件名为config.json,可以在ANKI插件页面做修改,也可以通过hjp_link->config打开,可修改的值有

1. linkMode (重点必看)

   • linkMode影响默认的链接多张卡片的算法,就是你点击hjp_link>linkDefault时会调用的算法,值为0或1,2,3,默认为0.
   • 0表示完全链接linkAll
   • 1表示按组链接linkGroupToGroup
   • 2表示按结点取消链接unlinknode
   • 3表示按路径取消链接unlinkpath

2. cidPrefix

   • 表示每个卡ID的默认前缀,用于让依赖的link插件识别这是可点的链接，默认是依赖插件的默认配置即cidd,可以清空,请注意标识符在txt中的含义必须是唯一确定的,不能在插入的正文中使用标识符.

3. appendNoteFieldPosition

   • 这个属性控制双链的标记插入到anki卡片的第几个字段,取值从0开始,所以第一个字段为0,默认为0,第一个字段通常是问题描述,也就是卡片的正面,那么双链就会插入到正面的末尾.

4. readDescFieldPosition

   • 这个属性控制程序默认从卡片的第几个字段提取卡片描述的字符，数据类型为number,默认为0,也就是提取问题描述中的前面10个非标点类字符.

5. regexForDescContent

   • 这个属性控制程序从卡片提取描述字符的方法，默认为0的话，会调用DEFAULT>regexForDescContent中的正则表达式来提取描述字符.如果你想按自己的正则表达式提取描述字符,可以改外层的regexForDescContent的值.

动画指导

• 单向链接的使用
• 
• 双向链接的设置
• 

未来计划

近期

• 提供链接的html元素的样式修改接口
• 实现input.json文件中card_id的唯一化.
• 实现各种方案转为tag(deck路径转tag,卡片内容转tag)
• 实现答题日志系统(点击显示答案后的任意一个按钮都会弹出是否记录日志的问号,选择是就会记录当前的文本到指定的位置.)

长期

• 实现UI界面(抛弃丑陋的txt文本编辑,减少用户犯错几率)
• 利用sqlite3,实现链接信息的外部存储,方便维护,比如链接的同步更新,实时加载(可选)

已完成

• 代码转移到gitee
• 实现unlink功能(若选中的卡片存在link关系,则删除这个link)
• 为了方便操作,将来会将卡片ID存储的txt文本改为json数据({id:,desc:})

更新记录

0.2.1

• 修复了一个愚蠢的错误

0.2

• 新增unlink取消链接，算法也是两种
• txt文本改为JSON数据,增加了易用性

0.1.1

• 修复了一些bug,比如重复插入卡片id

0.1

• 为了方便切换不同的链接模式,现在把两个模式直接拿到菜单中可点击了.
• 实现可修改前缀,网络化发布