使用本地程序对接 Vnote

什么是 Vnote ？

如果你不知道 Vnote 是什么，请猛击下方链接了解。

Vnote 主页 Vnote 项目

简介

本页面，我们将介绍如何使用「本地程序」来对接到 Vnote。也就是使用 MaoXian Web Clipper 裁剪网页，并把裁剪结果存到 Vnote 的笔记本中。

请注意，当你使用这个方法时，你应该了解：

• 你裁剪下来的文件，必须以 Markdown 格式存储。
• 你会用 Vnote 来浏览和管理文件，而不是 MaoXian 自带的历史页面。
• 你必须在 Vnote 中新建一个「笔记本（notebook）」来做这个事情。

总体流程

1. 在 Vnote 上新建一个笔记本和一个根目录
2. 下载 「本地程序」，并正确配置。
3. 到 MaoXian 扩展上，做存储相关配置。

Vnote 这边的准备

1. 打开 Vnote，并新建一个笔记本（notebook），如：clippings。

2. 再在这个笔记本下方，创建一个根目录，注意，这里为了方便，我们用 mx-wc 来命名它。

通过上面这两步，我们会得到一个存储路径，比如： /home/user/Documents/Vnote_notebooks/clippings，这个路径下方有一个根目录 mx-wc。

OK, Vnote 这边准备好了。

安装和配置「本地程序」

注意，这一步不涉及安装ruby，「本地程序」的下载，解压，安装，。这些都可以在这里 找到相关介绍。我们这一步，主要介绍的是配置。

首先，确保你已经成功安装了 ruby，并且把「本地程序」下载下来，并解压好了。

接下来，用文本编辑器打开里面的 config.yaml 文件。以上一步，我们配置的情况，我们应该配置成下方这个样子

environment: 'production'
data_dir: '/home/user/Documents/Vnote_notebooks/clippings'
msg_handler: 'vnote_v1'

• 注意上方的 msg_handler 我们填写的是 vnote_v1 而不是默认的 default。
• 另外 data_dir 这一项，我们填写的这个路径，是我们在上一步创建的那个「笔记本」的路径。

配置好了后，你就可以进行安装了。安装好后，确保和 MaoXian 扩展对接上后，这一步就完成了。

配置 MaoXian 扩展

1. 在 设置 > 本地程序 一节，勾选 “启用本地程序“
2. 在 设置 > 存储 一节，配置如下项目：

• 裁剪方式选择「本地程序」
• 存储格式选择 Markdown
• 根目录配置成 mx-wc （这里和 Vnote 那边的根目录保持一致）
• 主文件的文件夹配置成 $CATEGORY_PATH
• 主文件名配置成 $TIME-INTSEC_$TITLE.md
• 资源文件夹配置成 $CATEGORY_PATH/_v_images （这是存图片的地方）
• 元信息文件的文件夹配置成 $CATEGORY_PATH
• 「保存标题文件」一项，取消勾选。

其他配置项，保持不变就好。

验证

经过上面的三小节，整个对接流程已经完成。现在打开一个有图片的网页，再进行裁剪，然后，打开 Vnote，在左边的目录树那里，点击右键，点击刷新。如果你看到刚才裁剪下来的网页，那么恭喜你，对接成功了。

最后

如你在此过程中遇到解决不了的问题，你可以把遇到的问题反映到项目 issue 里。

---

首页