登录 注册

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

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

目的

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

具体需求

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

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

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

  • 思源笔记

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

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

    26297 引用 • 109331 回帖
  • Q&A

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

    10113 引用 • 45931 回帖 • 64 关注
9 回帖
4
3
299 103 9 73 1 113

相关帖子

被采纳的回答
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
回帖
265
 帖子
30
 积分
43599

近期热议

推荐标签 标签

  • 快应用

    快应用 是基于手机硬件平台的新型应用形态；标准是由主流手机厂商组成的快应用联盟联合制定；快应用标准的诞生将在研发接口、能力接入、开发者服务等层面建设标准平台；以平台化的生态模式对个人开发者和企业开发者全品类开放。

    15 引用 • 127 回帖 • 1 关注
  • Love2D

    Love2D 是一个开源的， 跨平台的 2D 游戏引擎。使用纯 Lua 脚本来进行游戏开发。目前支持的平台有 Windows, Mac OS X, Linux, Android 和 iOS。

    14 引用 • 53 回帖 • 564 关注
  • Office

    Office 现已更名为 Microsoft 365. Microsoft 365 将高级 Office 应用（如 Word、Excel 和 PowerPoint）与 1 TB 的 OneDrive 云存储空间、高级安全性等结合在一起，可帮助你在任何设备上完成操作。

    5 引用 • 34 回帖
  • AngularJS

    AngularJS 诞生于 2009 年，由 Misko Hevery 等人创建，后为 Google 所收购。是一款优秀的前端 JS 框架，已经被用于 Google 的多款产品当中。AngularJS 有着诸多特性，最为核心的是：MVC、模块化、自动化双向数据绑定、语义化标签、依赖注入等。2.0 版本后已经改名为 Angular。

    12 引用 • 50 回帖 • 522 关注
  • Gitea

    Gitea 是一个开源社区驱动的轻量级代码托管解决方案，后端采用 Go 编写，采用 MIT 许可证。

    5 引用 • 16 回帖 • 1 关注
  • Visio
    1 引用 • 2 回帖 • 1 关注
  • Openfire

    Openfire 是开源的、基于可拓展通讯和表示协议 (XMPP)、采用 Java 编程语言开发的实时协作服务器。Openfire 的效率很高，单台服务器可支持上万并发用户。

    6 引用 • 7 回帖 • 120 关注
  • Dubbo

    Dubbo 是一个分布式服务框架，致力于提供高性能和透明化的 RPC 远程服务调用方案，是 [阿里巴巴] SOA 服务化治理方案的核心框架，每天为 2,000+ 个服务提供 3,000,000,000+ 次访问量支持，并被广泛应用于阿里巴巴集团的各成员站点。

    60 引用 • 82 回帖 • 616 关注
  • NetBeans

    NetBeans 是一个始于 1997 年的 Xelfi 计划，本身是捷克布拉格查理大学的数学及物理学院的学生计划。此计划延伸而成立了一家公司进而发展这个商用版本的 NetBeans IDE，直到 1999 年 Sun 买下此公司。Sun 于次年（2000 年）六月将 NetBeans IDE 开源，直到现在 NetBeans 的社群依然持续增长。

    78 引用 • 102 回帖 • 713 关注
  • BND

    BND（Baidu Netdisk Downloader）是一款图形界面的百度网盘不限速下载器，支持 Windows、Linux 和 Mac，详细介绍请看这里。

    107 引用 • 1281 回帖 • 37 关注
  • CAP

    CAP 指的是在一个分布式系统中， Consistency（一致性）、 Availability（可用性）、Partition tolerance（分区容错性），三者不可兼得。

    12 引用 • 5 回帖 • 631 关注
  • Thymeleaf

    Thymeleaf 是一款用于渲染 XML/XHTML/HTML5 内容的模板引擎。类似 Velocity、 FreeMarker 等，它也可以轻易的与 Spring 等 Web 框架进行集成作为 Web 应用的模板引擎。与其它模板引擎相比，Thymeleaf 最大的特点是能够直接在浏览器中打开并正确显示模板页面，而不需要启动整个 Web 应用。

    11 引用 • 19 回帖 • 394 关注
  • Typecho

    Typecho 是一款博客程序，它在 GPLv2 许可证下发行，基于 PHP 构建，可以运行在各种平台上，支持多种数据库（MySQL、PostgreSQL、SQLite）。

    12 引用 • 67 回帖 • 446 关注
  • Shell

    Shell 脚本与 Windows/Dos 下的批处理相似，也就是用各类命令预先放入到一个文件中，方便一次性执行的一个程序文件，主要是方便管理员进行设置或者管理用的。但是它比 Windows 下的批处理更强大，比用其他编程程序编辑的程序效率更高，因为它使用了 Linux/Unix 下的命令。

    125 引用 • 74 回帖 • 1 关注
  • GAE

    Google App Engine（GAE）是 Google 管理的数据中心中用于 WEB 应用程序的开发和托管的平台。2008 年 4 月 发布第一个测试版本。目前支持 Python、Java 和 Go 开发部署。全球已有数十万的开发者在其上开发了众多的应用。

    14 引用 • 42 回帖 • 824 关注
  • 微服务

    微服务架构是一种架构模式，它提倡将单一应用划分成一组小的服务。服务之间互相协调，互相配合，为用户提供最终价值。每个服务运行在独立的进程中。服务于服务之间才用轻量级的通信机制互相沟通。每个服务都围绕着具体业务构建，能够被独立的部署。

    96 引用 • 155 回帖
  • 人工智能

    人工智能（Artificial Intelligence）是研究、开发用于模拟、延伸和扩展人的智能的理论、方法、技术及应用系统的一门技术科学。

    115 引用 • 319 回帖
  • 链滴

    链滴是一个记录生活的地方。

    记录生活，连接点滴

    182 引用 • 3882 回帖
  • Oracle

    Oracle（甲骨文）公司，全称甲骨文股份有限公司（甲骨文软件系统有限公司），是全球最大的企业级软件公司，总部位于美国加利福尼亚州的红木滩。1989 年正式进入中国市场。2013 年，甲骨文已超越 IBM，成为继 Microsoft 后全球第二大软件公司。

    107 引用 • 127 回帖 • 344 关注
  • LaTeX

    LaTeX（音译“拉泰赫”）是一种基于 ΤΕΧ 的排版系统，由美国计算机学家莱斯利·兰伯特（Leslie Lamport）在 20 世纪 80 年代初期开发，利用这种格式，即使使用者没有排版和程序设计的知识也可以充分发挥由 TeX 所提供的强大功能，能在几天，甚至几小时内生成很多具有书籍质量的印刷品。对于生成复杂表格和数学公式，这一点表现得尤为突出。因此它非常适用于生成高印刷质量的科技和数学类文档。

    12 引用 • 59 回帖
  • CentOS

    CentOS（Community Enterprise Operating System）是 Linux 发行版之一，它是来自于 Red Hat Enterprise Linux 依照开放源代码规定释出的源代码所编译而成。由于出自同样的源代码，因此有些要求高度稳定的服务器以 CentOS 替代商业版的 Red Hat Enterprise Linux 使用。两者的不同在于 CentOS 并不包含封闭源代码软件。

    240 引用 • 224 回帖
  • 心情

    心是产生任何想法的源泉，心本体会陷入到对自己本体不能理解的状态中，因为心能产生任何想法，不能分出对错，不能分出自己。

    59 引用 • 369 回帖
  • Follow
    4 引用 • 12 回帖 • 4 关注
  • Vue.js

    Vue.js（读音 /vju ː/，类似于 view）是一个构建数据驱动的 Web 界面库。Vue.js 的目标是通过尽可能简单的 API 实现响应的数据绑定和组合的视图组件。

    268 引用 • 666 回帖 • 2 关注
  • OpenResty

    OpenResty 是一个基于 NGINX 与 Lua 的高性能 Web 平台，其内部集成了大量精良的 Lua 库、第三方模块以及大多数的依赖项。用于方便地搭建能够处理超高并发、扩展性极高的动态 Web 应用、Web 服务和动态网关。

    17 引用 • 53 关注
  • ActiveMQ

    ActiveMQ 是 Apache 旗下的一款开源消息总线系统，它完整实现了 JMS 规范，是一个企业级的消息中间件。

    19 引用 • 13 回帖 • 684 关注
  • Hprose

    Hprose 是一款先进的轻量级、跨语言、跨平台、无侵入式、高性能动态远程对象调用引擎库。它不仅简单易用，而且功能强大。你无需专门学习，只需看上几眼，就能用它轻松构建分布式应用系统。

    9 引用 • 17 回帖 • 642 关注

最新标签