Obsidian Weread 插件安装与配置指南
1. 项目基础介绍和主要编程语言
Obsidian Weread 插件是一个用于将微信读书(Weread)中的高亮标注和笔记同步到 Obsidian Vault 的社区插件。该项目的主要编程语言是 TypeScript,同时也使用了 JavaScript、HTML 和 Nunjucks 等技术。
2. 项目使用的关键技术和框架
- TypeScript: 主要编程语言,用于编写插件的核心逻辑。
- JavaScript: 用于处理一些动态交互和逻辑。
- HTML: 用于构建用户界面。
- Nunjucks: 一个模板引擎,用于生成笔记内容。
- Obsidian API: 用于与 Obsidian 笔记应用进行交互。
3. 项目安装和配置的准备工作和详细安装步骤
准备工作
- 安装 Obsidian: 确保你已经在本地安装了 Obsidian 笔记应用。
- 创建 Vault: 在 Obsidian 中创建一个新的 Vault(笔记库),或者使用现有的 Vault。
- 安装 Node.js: 确保你的系统中已经安装了 Node.js,因为插件的安装和运行需要 Node.js 环境。
详细安装步骤
步骤 1:克隆项目仓库
首先,打开终端或命令行工具,导航到你希望存放项目的目录,然后执行以下命令克隆项目仓库:
git clone https://github.com/zhaohongxuan/obsidian-weread-plugin.git
步骤 2:安装依赖
进入克隆的项目目录,并安装项目所需的依赖:
cd obsidian-weread-plugin
npm install
步骤 3:构建插件
在项目目录中运行以下命令来构建插件:
npm run build
步骤 4:安装插件到 Obsidian
- 打开 Obsidian 应用,进入你创建的 Vault。
- 点击左侧边栏的“设置”图标,进入设置页面。
- 在设置页面中,找到“社区插件”选项,点击“浏览”按钮。
- 在社区插件市场中搜索“Weread”,找到 Weread Plugin 并点击“安装”。
- 安装完成后,点击“启用”按钮以启用插件。
步骤 5:配置插件
- 在 Obsidian 中,点击左侧边栏的“设置”图标,进入设置页面。
- 找到“Obsidian Weread Plugin”选项,进入插件设置页面。
- 点击右侧的“登录”按钮,在弹出的登录页面中使用微信扫码登录。
- 登录完成后,设置笔记保存位置、笔记最小划线数量、笔记文件夹分类等选项。
步骤 6:使用插件
- 点击左侧边栏的微信读书按钮,或者使用快捷键
Command+P
(Windows 上是Ctrl+P
)调出命令面板。 - 输入“Weread”,找到“Sync Weread”命令并执行,即可同步微信读书中的高亮标注和笔记到 Obsidian Vault。
注意事项
- 插件是覆盖式更新,请不要在同步的文件里修改内容,写永久笔记时可以使用 Block 引用的方式进行批注。
- 长期不使用插件可能导致 Cookie 失效,需要重新登录。
- 偶尔可能会有网络连接问题,重新点击同步即可,已同步的笔记不会再次更新。
通过以上步骤,你就可以成功安装并配置 Obsidian Weread 插件,将微信读书中的笔记同步到 Obsidian 中。