BBtalk 中文文档

# 📃前言

什么是BBtalk？

BBtalk 利用手机微信发布碎片化思想同步至博客，基于 Leancloud。

# 🎁特性

  • 支持微信端文字及图片消息发送

当前为初步版本，后续功能请见开发计划

# 🚀快速使用

# 在 Hexo Volantis 主题使用

Volantis 目前支持 BBtalk ，请查看hexo-theme-volantis/_config.yml (opens new window)

  # BBtalk https://bb.js.org
  bbtalk:
    js: https://cdn.jsdelivr.net/npm/bbtalk@0.1.5/dist/bbtalk.min.js # BBtalk.js
    appId: xxxxxx # your appID
    appKey: xxxxx # your appKEY
    serverURLs: https://xxxxxx # Request Api 域名

# 🎨开始使用

# Leancloud 创建存储空间

提示

🌍 建议使用国际版的 LeanCloud

因为国际版的 LeanCloud 不需要绑定备案域名，所以推荐使用国际版。

  1. 前往 LeanCloud 国际版 (opens new window)，注册账号。
  2. 注册完成之后根据 LeanCloud 的提示绑定手机号和邮箱。
  3. 绑定完成之后点击创建应用，应用名称随意，接着在存储→结构化数据中创建 class，命名为 content。
  4. 点击刚刚创建的content Class，点击添加列并创建名称为content的列。
  5. 在菜单栏中找到设置→ 应用 keys，记下来 AppID 、 MasterKey 和Request 域名（api） ，各个数据一般为以下形式：
    AppID: Y5IDwC47czJFXXXXXXSlU44Y-MdYXbMMI
MasterKey: qgrJ3nRwXXXXXXwwnVfj0uaQ
Request 域名: https://AppID前八位.api.lncldglobal.com

# 关注微信公众号

黑石哔哔

按照公众号的提示的命令进行绑定：

//leancloud:您的AppID,您的MasterKey,https://您的 Request 域名

黑石哔哔已支持绑定至腾讯云cloudbase，通过//tcb:apiKey,apiUrl进行绑定，前端页面正在重构，敬请期待。

# CDN引用

提示

如果您使用的博客主题不支持 BBtalk，并且您不知道如何引入 BBtalk，您可以在 Github 提交适配请求 (opens new window)

<!-- 存放哔哔的容器 -->
<div id="bbtalk"></div>
<!-- 引用 bbtalk -->
<script src="https://cdn.jsdelivr.net/npm/bbtalk@0.1.5/dist/bbtalk.min.js"></script>
<script>
bbtalk.init({
  appId: "Y5IDwC47czJFXXXXXXSlU44Y-MdYXbMMI",
  appKey: "qgrJ3nRwXXXXXXwwnVfj0uaQ",
  serverURLs: 'https://AppID前八位.api.lncldglobal.com'
})
</script>

建议使用 CDN 引入 BBtalk 的用户在链接地址上锁定版本，以免将来 BBtalk 升级时受到非兼容性更新的影响。

# 🔧可选配置项

# el

类型:String

默认值:bbtalk

必要性: false

BBtalk 的初始化挂载器。

# pageSize

类型:Number

默认值:10

必要性:false

每页显示哔哔条数。

# 💡开发计划

BBtalk 现在仍处于开发阶段，这里有一些目前还不支持、但已经在计划中的特性：

  • BBtalk 样式优化及多样化可变配置
  • 支持微信表情转义
  • 支持Markdown
  • 存储基于腾讯CloudBase云数据库（2.0版本）

需更多功能支持，请提出需求 (opens new window)