Title: Roam Research Block
Author: Artur Piszek
Published: <strong>2021 年 1 月 5 日</strong>
Last modified: 2021 年 1 月 27 日

---

搜索插件

**该插件尚未通过WordPress的最新3个主要版本进行测试**。 当与较新版本的WordPress一起
使用时，可能不再受到维护或支持，并且可能会存在兼容性问题。

![](https://ps.w.org/roam-block/assets/icon-256x256.png?rev=2450567)

# Roam Research Block

 作者：[Artur Piszek](https://profiles.wordpress.org/artpi/)

[下载](https://downloads.wordpress.org/plugin/roam-block.0.1.3.zip)

 * [详情](https://cn.wordpress.org/plugins/roam-block/#description)
 * [评价](https://cn.wordpress.org/plugins/roam-block/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/roam-block/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/roam-block/#developers)

 [支持](https://wordpress.org/support/plugin/roam-block/)

## 描述

This block let’s you search and embed [Roam Research](https://roamresearch.com/)
blocks inside WordPress block editor.
 WordPress Block editor and Roam are a match
made in heaven! [Detailed description and a video on this blog.](https://deliber.at/wp-roam-block/)

#### The blocks are embedded

Once you insert a block into your post, it stays connected to the source **Roam 
block**.
 If you upload a new Roam export, all the blocks will update on your site.
For example – if you have a few “evergreen” pages in Roam, you can embed them in
WordPress as your “mind garden” and they will stay updated whenever you upload a
new copy of your Roam graph.

If you delete a block in Roam and update Roam export in WordPress, the blocks you
inserted will use a cached copy created at the time of writing the post for the 
first time.
 So you don’t have to worry about empty pages.

#### WordPress embed functionality

You can also paste links like `https://roamresearch.com/#/app/graph/page/ratars73`
into a WordPress post and they will resolve into an embed of the block

### Development

[All Development and issues in this github repository.](https://github.com/artpi/wp-roam-block)

## 屏幕截图

[⌊Comparison of a block in Roam and the same block embedded in WordPress⌉⌊Comparison
of a block in Roam and the same block embedded in WordPress⌉[

Comparison of a block in Roam and the same block embedded in WordPress

[⌊You upload new version of your Roam graph from block sidebar⌉⌊You upload new version
of your Roam graph from block sidebar⌉[

You upload new version of your Roam graph from block sidebar

[⌊The block has a search window⌉⌊The block has a search window⌉[

The block has a search window

[⌊You can display your content "as a document" or "as a list"⌉⌊You can display your
content "as a document" or "as a list"⌉[

You can display your content “as a document” or “as a list”

## 区块

该插件提供了 1 个区块.

 *   Roam Research Block Embed Roam Blocks or pages in WordPress, just as you would
   in Roam

## 安装

 1. Upload the plugin files to the `/wp-content/plugins/roam-block` directory, or install
    the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the ‘Plugins’ screen in WordPress
 3. Now you can use “Roam Block” in your posts in the block editor
 4. The first time you use the block, you will have to upload your Roam Graph to WordPress.
 5.  * Click ( … ) in the right-top corner of Roam
     * Click Export All
     * Choose `JSON`
     * Unzip the file
     * Insert “Roam Block” into Gutenberg in WordPress
     * Click “Upload” in sidebar
     * Choose the unzipped json
     * Observe magic
 6. Now you can search your Roam graph directly from the “Roam Block” block or paste
    embed URLs.

## 常见问题

### What is Roam Research?

Roam Research is a tool for networked thought – a note-taking tool that is block-
based.
 Since blocks are a conceptual unit of both Gutenberg and Roam – I created
this plugin.

### Do I have to manually upload the roam graph?

Roam does not have an API that could run through WordPress. I have built a project
that can keep your Roam graph in WP automatically updated, but it has to run on 
another machine.
 [Details how to set it up are here.](https://deliber.at/roam/wp-roam-block/)

### How do I upload the graph?

 * Click ( … ) in the right-top corner of Roam
 * Click Export All
 * Choose `JSON`
 * Unzip the file
 * Insert “Roam Block” into Gutenberg in WordPress
 * Click “Upload” in sidebar
 * Choose the unzipped json
 * Observe magic

## 评价

此插件暂无评价。

## 贡献者及开发者

「Roam Research Block」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ Artur Piszek ](https://profiles.wordpress.org/artpi/)

[帮助将「Roam Research Block」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/roam-block)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/roam-block/)，查看[SVN仓库](https://plugins.svn.wordpress.org/roam-block/)，
或通过[RSS](https://plugins.trac.wordpress.org/log/roam-block/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/roam-block/)。

## 更新日志

#### 0.1.0

 * Release

#### 0.1.2

 * Fix WordPress version tag

#### 0.1.3

 * Expose update URL to automatically update Roam Graph via https://deliber.at/roam/
   roam-api/

## 额外信息

 *  版本 **0.1.3**
 *  最后更新：**5 年前**
 *  活跃安装数量 **不到10**
 *  WordPress 版本 ** 5.3.1 或更高版本 **
 *  已测试的最高版本为 **5.3.21**
 *  PHP 版本 ** 7.0.0 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/roam-block/)
 * 标签
 * [block](https://cn.wordpress.org/plugins/tags/block/)
 *  [高级视图](https://cn.wordpress.org/plugins/roam-block/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/roam-block/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/roam-block/reviews/)

## 贡献者

 *   [ Artur Piszek ](https://profiles.wordpress.org/artpi/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/roam-block/)