登录 注册

请教有没有转换块类型的公开 API?

本贴最后更新于 297 天前，其中的信息可能已经时移世易

目的

导入内容后再次进行自定义格式化

具体需求

  1. 通过 api 对特定块 id 执行合并、取消超级块的操作
  2. 转换某个块类型为其他块

我想在思源中对已导入和即将导入的 obsidian md 文件进行二次格式化，以满足特定需要：在思源中对 obsidian 风味的 md 语法以及插件的私有语法的还原。

例如 callout，约等于指定 css 的超级块。导入思源后是引用块，我希望通过 api 转换引用块为段落块，然后合并为超级块。

  • 思源笔记

    思源笔记是一款隐私优先的个人知识管理系统，支持完全离线使用，同时也支持端到端加密同步。

    融合块、大纲和双向链接，重构你的思维。

    26631 引用 • 110881 回帖
  • Q&A

    提问之前请先看《提问的智慧》，好的问题比好的答案更有价值。

    10270 引用 • 46681 回帖 • 62 关注
9 回帖
4
3
320 103 9 78 1 1 128

相关帖子

被采纳的回答
9 回帖
请教有没有转换块类型的公开 API?

欢迎来到这里！

我们正在构建一个小众社区，大家在这里相互信任，以平等 • 自由 • 奔放的价值观进行分享交流。最终，希望大家能够找到与自己志同道合的伙伴，共同成长。

注册 关于
请输入回帖内容 ...
  • JeffreyChen • • 1
    付费者 支持者 捐赠者

    我觉得可以用这个：

    image.png

    https://github.com/siyuan-note/siyuan/blob/master/API_zh_CN.md#%E6%9B%B4%E6%96%B0%E5%9D%97

  • wilsons • • 1
    付费者 捐赠者

    没有一个 api 可以实现简单的参数传递就能实现一个块转换为另一个块的，因为每种块的格式不同。

    需要多个 api 去配合实现，可以通过开发者工具里的网络进行抓包，然后进行想要的操作，看看思源是通过哪些 api 去实现的，然后模仿即可。

    1. 通过 api 对特定块 id 执行合并、取消超级块的操作

    根据网络抓包可知，合并为超级块，则是插入一个超级块，然后删除原来的块来实现的，实际上是一个插入块 api，多个删除块 api；取消超级块则是移动超级块子块，然后删除超级块实现的，实际上是移动多个块 api 和删除一个块 api 来实现的。

    1. 转换某个块类型为其他块

    如楼上所说是通过 updateBlock 来实现的，但要自己组装不同类型的块 dom 数据或者用 Markdown 调用 lute 转换为块 dom。建议先手动输入一个目标块，然后复制目标块 dom，然后填入相应的数据后调用更新块 api 更新即可。

    总之，没有简单的实现方式，需要多个 api 组合实现。

    1 回复
  • ACai •
    订阅者 付费者 支持者 作者

    感谢楼上两位大佬的热心回答，我去试试！！

  • liuyz0112 •
    付费者

    请问有什么办法获取全文各个 h3 块及其后面的非标题块的办法吗

    1 回复
  • wilsons •
    付费者 捐赠者

    我想，你是想获取 h3 及其下面可以被 h3 折叠起来的元素吧？如果这样的话，只需要向下遍历 h3 同级的兄弟结点，直到遇到 h1 或 h2 为止。

    如果你想要的是 h3 后面的非标题块的元素，那就向下遍历 h3 同级的兄弟结点，直到遇到标题块为止。

    1 回复
  • liuyz0112 •
    付费者

    感谢解惑，但是现在主要是如何找到这些块让我烦恼了，我去看了下 api 文档，没找到如何遍历的方法，是要通过 sql 吗。

    select * from blocks
where root_id = "{rootID}" and subtype = 'h3';
​

    查找 h3 块我知道可以用 sql 的方法，但是如何查找 h3 下面的块我就不知道了，我没有找到如何查找子块的方法。h3 查询到的信息里面，我只找到了 parent_id。

    {
  "alias": "",
  "box": "20240709122503-izci9q0",
  "content": "税收法律关系",
  "created": "20241109134252",
  "fcontent": "",
  "hash": "a9de36a",
  "hpath": "/税法/1 税法总则",
  "ial": "{: custom-riff-decks=\"20230218211946-2kw8jgx\" id=\"20241109134252-kxwej5j\" updated=\"20241110000111\"}",
  "id": "20241109134252-kxwej5j",
  "length": 6,
  "markdown": "### <<assets/税法+上册OCR-20241109141248-pd3t00z.pdf/20241109141355-lcdh8bv \"税收法律关系\">>",
  "memo": "",
  "name": "",
  "parent_id": "20241110000110-vt2vkli",
  "path": "/20241109000531-7qk5vun/20241109003338-82wzm2b.sy",
  "root_id": "20241109003338-82wzm2b",
  "sort": 5,
  "subtype": "h3",
  "tag": "",
  "type": "h",
  "updated": "20241110000111"
}
​
    1 回复
  • wilsons •
    付费者 捐赠者

    怎样实现要看你具体需求。

    我这里说的是通过 dom 遍历的方法。

    不过如果要用思源 api 可以通过/api/block/getChildBlocks 获取，请求参数：{id:'块 id'}，不过获取结果是 markdown 格式，如果转换为 dom 可以使用 Lute 转换。

    如果 SQL 查询，一般获取子块通过 path like '% 块 id%'，不过这里从 dom 上看 h3 下的元素和 h3，是兄弟结点，并不是 h3 的子块，所以这里用 path 不行。至于 api 为什么可以，可能是代码中做了特殊查询吧。

    root_id 是块所在文档的 id，不能用 root_id。

    更多 api 可以查看这个路由 https://github.com/siyuan-note/siyuan/blob/master/kernel/api/router.go ，怎么使用可以在 github 中搜索使用示例。

    1 回复
  • liuyz0112 •
    付费者

    再次感谢大佬，目前我的想法是

    • 通过 sql 获取当前文档所有 H3 块的 blockID
    • 根据 h3 的 blockID 使用 getChildBlocks 获取其子项的 blockID
    • 在 h3 前插入一个超级块
    • 通过子块 ID 和 h3 的 ID，使用 moveBlock 将其全部移入到超级块内

    目前卡在了插入超级块的地方，insertBlock 看文档没有超级块的说明，api 路由看不懂（原谅我，比较小白 😭 ），请问有什么方法可以做到吗，可以加我 QQ1269367656，奶茶感谢

    1 回复
  • wilsons •
    付费者 捐赠者

    QQ 已加。

    看不懂没关系，既然有接口肯定得被使用，1 可以在 github 搜索使用的例子，2 可以通过控制台-> 网络抓包查看。

    如下图，通过抓包可知，超级块就是一个普通的块，只不过数据类型是 NodeSuperBlock 而已。

    创建方法可以参考：https://github.com/siyuan-note/siyuan/blob/487c48427ae8e3b840d209047cc316273c7a3931/app/src/block/util.ts#L68

    去掉参数类型，把常量 Constants.ZWSP 换成 \u200b 即可。

    image.png

请输入回帖内容 ...
ACai
回帖
274
 帖子
32
 积分
43724

近期热议

推荐标签 标签

  • DevOps

    DevOps（Development 和 Operations 的组合词）是一组过程、方法与系统的统称，用于促进开发（应用程序/软件工程）、技术运营和质量保障（QA）部门之间的沟通、协作与整合。

    59 引用 • 25 回帖 • 1 关注
  • 服务

    提供一个服务绝不仅仅是简单的把硬件和软件累加在一起，它包括了服务的可靠性、服务的标准化、以及对服务的监控、维护、技术支持等。

    41 引用 • 24 回帖 • 1 关注
  • Swift

    Swift 是苹果于 2014 年 WWDC（苹果开发者大会）发布的开发语言，可与 Objective-C 共同运行于 Mac OS 和 iOS 平台，用于搭建基于苹果平台的应用程序。

    34 引用 • 37 回帖 • 558 关注
  • Telegram

    Telegram 是一个非盈利性、基于云端的即时消息服务。它提供了支持各大操作系统平台的开源的客户端，也提供了很多强大的 APIs 给开发者创建自己的客户端和机器人。

    5 引用 • 35 回帖
  • 导航

    各种网址链接、内容导航。

    45 引用 • 177 回帖
  • JWT

    JWT（JSON Web Token）是一种用于双方之间传递信息的简洁的、安全的表述性声明规范。JWT 作为一个开放的标准（RFC 7519），定义了一种简洁的，自包含的方法用于通信双方之间以 JSON 的形式安全的传递信息。

    20 引用 • 15 回帖 • 27 关注
  • 反馈

    Communication channel for makers and users.

    120 引用 • 906 回帖 • 280 关注
  • C++

    C++ 是在 C 语言的基础上开发的一种通用编程语言，应用广泛。C++ 支持多种编程范式，面向对象编程、泛型编程和过程化编程。

    108 引用 • 153 回帖
  • Access
    1 引用 • 3 回帖 • 2 关注
  • 游戏

    沉迷游戏伤身，强撸灰飞烟灭。

    188 引用 • 832 回帖 • 1 关注
  • 以太坊

    以太坊（Ethereum）并不是一个机构，而是一款能够在区块链上实现智能合约、开源的底层系统。以太坊是一个平台和一种编程语言 Solidity，使开发人员能够建立和发布下一代去中心化应用。 以太坊可以用来编程、分散、担保和交易任何事物：投票、域名、金融交易所、众筹、公司管理、合同和知识产权等等。

    34 引用 • 367 回帖
  • Vim

    Vim 是类 UNIX 系统文本编辑器 Vi 的加强版本，加入了更多特性来帮助编辑源代码。Vim 的部分增强功能包括文件比较（vimdiff）、语法高亮、全面的帮助系统、本地脚本（Vimscript）和便于选择的可视化模式。

    29 引用 • 66 回帖 • 2 关注
  • Wide

    Wide 是一款基于 Web 的 Go 语言 IDE。通过浏览器就可以进行 Go 开发，并有代码自动完成、查看表达式、编译反馈、Lint、实时结果输出等功能。

    欢迎访问我们运维的实例： https://wide.b3log.org

    30 引用 • 218 回帖 • 641 关注
  • 服务器

    服务器，也称伺服器，是提供计算服务的设备。由于服务器需要响应服务请求，并进行处理，因此一般来说服务器应具备承担服务并且保障服务的能力。

    125 引用 • 585 回帖 • 2 关注
  • React

    React 是 Facebook 开源的一个用于构建 UI 的 JavaScript 库。

    192 引用 • 291 回帖 • 368 关注
  • 大数据

    大数据（big data）是指无法在一定时间范围内用常规软件工具进行捕捉、管理和处理的数据集合，是需要新处理模式才能具有更强的决策力、洞察发现力和流程优化能力的海量、高增长率和多样化的信息资产。

    89 引用 • 113 回帖 • 1 关注
  • TensorFlow

    TensorFlow 是一个采用数据流图（data flow graphs），用于数值计算的开源软件库。节点（Nodes）在图中表示数学操作，图中的线（edges）则表示在节点间相互联系的多维数据数组，即张量（tensor）。

    20 引用 • 19 回帖 • 2 关注
  • RYMCU

    RYMCU 致力于打造一个即严谨又活泼、专业又不失有趣，为数百万人服务的开源嵌入式知识学习交流平台。

    4 引用 • 6 回帖 • 64 关注
  • Solidity

    Solidity 是一种智能合约高级语言，运行在 [以太坊] 虚拟机（EVM）之上。它的语法接近于 JavaScript，是一种面向对象的语言。

    3 引用 • 18 回帖 • 448 关注
  • ZeroNet

    ZeroNet 是一个基于比特币加密技术和 BT 网络技术的去中心化的、开放开源的网络和交流系统。

    1 引用 • 21 回帖 • 650 关注
  • Firefox

    Mozilla Firefox 中文俗称“火狐”（正式缩写为 Fx 或 fx，非正式缩写为 FF），是一个开源的网页浏览器，使用 Gecko 排版引擎，支持多种操作系统，如 Windows、OSX 及 Linux 等。

    7 引用 • 30 回帖 • 365 关注
  • 旅游

    希望你我能在旅途中找到人生的下一站。

    101 引用 • 905 回帖
  • BookxNote

    BookxNote 是一款全新的电子书学习工具，助力您的学习与思考，让您的大脑更高效的记忆。

    笔记整理交给我，一心只读圣贤书。

    1 引用 • 1 回帖
  • Excel
    31 引用 • 28 回帖
  • jsDelivr

    jsDelivr 是一个开源的 CDN 服务，可为 npm 包、GitHub 仓库提供免费、快速并且可靠的全球 CDN 加速服务。

    5 引用 • 31 回帖 • 109 关注
  • golang

    Go 语言是 Google 推出的一种全新的编程语言，可以在不损失应用程序性能的情况下降低代码的复杂性。谷歌首席软件工程师罗布派克（Rob Pike）说：我们之所以开发 Go，是因为过去 10 多年间软件开发的难度令人沮丧。Go 是谷歌 2009 发布的第二款编程语言。

    500 引用 • 1396 回帖 • 254 关注
  • SQLServer

    SQL Server 是由 [微软] 开发和推广的关系数据库管理系统（DBMS），它最初是由 微软、Sybase 和 Ashton-Tate 三家公司共同开发的，并于 1988 年推出了第一个 OS/2 版本。

    21 引用 • 31 回帖 • 3 关注

最新标签