notero下载 - notero源码下载

notero

其他源码

v0.6.7

下载

诺特罗

Notero 是一个 Zotero 插件，用于将项目和笔记同步到 Notion 中。使用方法：

？配置您的 Notion 数据库。
？将 Notero 插件安装到 Zotero 中。
？选择要监控的 Zotero 集合。
添加或更新集合中的项目。
观看您的项目同步到 Notion 中！

诺特罗在行动

概念由 @arhoff ??‍? |建立与？通过@dvanoni

为什么使用 Notero？

将参考管理器、任务列表、阅读笔记、分析表和草稿集成到一处。
在 Notion 中编写时轻松链接到参考文献。
创建自定义视图以按项目、标签、作者等过滤和排序大型参考列表。
反向链接可以轻松找到任何提及参考文献的注释和草稿。
将引用链接到其他数据库中的条目，例如出版物管道中的项目、任务、手稿、出版渠道等。

Notero 的工作原理

Notero 插件监视在 Notero 首选项中指定的任何集合中添加或修改的 Zotero 项目。每当添加或修改项目时，Notero 都会执行以下操作：

将包含 Zotero 项目属性（标题、作者等）的页面保存到 Notero 首选项中指定的 Notion 数据库中。
向 Zotero 项目添加notion标签。
将附件添加到链接到 Notion 中页面的 Zotero 项目。

除了提供从 Zotero 打开 Notion 页面的便捷方式之外，链接附件还可以作为 Notero 的参考，以便它可以更新给定 Zotero 项目的相应 Notion 页面。

同步项目

默认情况下，只要修改了受监控的集合中的项目，Notero 就会同步它们。您可以通过取消选中 Notero 首选项中的“修改项目时同步”选项来禁用此功能。

您还可以从集合或项目上下文菜单同步项目（右键单击）：

要同步集合中的所有项目，请打开集合的上下文菜单并选择Sync Items to Notion 。
要同步一项或多项，请在主窗格中选择该项，打开上下文菜单，然后选择Sync to Notion 。

笔记

为了防止“修改时同步”功能多次保存到 Notion，当标签和链接附件添加到项目时，Notero 不会通知 Zotero。这意味着它们可能不会立即出现在 Zotero 中，您可能需要导航到不同的项目并返回才能使它们出现。

同步笔记和 PDF 注释

与某个项目关联的 Zotero 注释可以同步到 Notion 中，作为该项目对应页面的内容。与常规项目一样，您可以使用上下文菜单中的“同步到概念”选项手动同步笔记。

可以通过 Notero 首选项中的同步笔记选项启用笔记自动同步。启用后，只要修改笔记，笔记就会自动同步。此外，当常规项目同步时，其所有注释（如果尚未同步）也将同步。

要从 PDF 同步注释（注释和突出显示），您首先需要将它们提取到 Zotero 注释中：

选择一个项目或 PDF，打开上下文菜单，然后选择“从注释中添加注释” 。
如果需要，可以从笔记面板右上角的菜单中启用突出显示颜色。

从 PDF 注释创建注释的示例

CleanShot.2023-07-26.at.20.41.32-converted.mp4

安装和设置

使用 Notero 需要设置一个 Notion 数据库，将其连接到 Notero，并在 Zotero 中安装 Notero 插件。详细的设置说明如下。

配置概念

创建您想要将 Zotero 项目同步到的 Notion 数据库。
请参阅下面的示例，您可以将其复制到您的 Notion 工作区中。
在 https://www.notion.com/my-integrations 创建 Notion 内部集成并启用所有“内容功能”。
集成功能设置示例
记下上一步中的“内部集成秘密”。
授予您对数据库的集成访问权限。
来自 Notion 开发者文档：
1. 转到工作区中的数据库页面。
2. 单击页面右上角的•••更多菜单。
3. 向下滚动并单击“连接到” 。
4. 在“搜索连接...”菜单中搜索并选择您的集成。
Notion 文档中的连接设置示例
根据需要配置数据库属性。有关更多详细信息，请参阅下面的数据库属性部分。

概念数据库属性

Notero 可以同步下列属性的数据。 Notero 所需的唯一属性是Title属性类型。其他属性是可选的，因此您可以仅使用适合您需要的属性。

Title属性可以命名为Name以外的名称，只要它不与任何其他属性名称冲突即可。其他属性的名称和类型必须完全按照此处指定的进行配置。请注意，属性名称区分大小写，因此大小写必须完全匹配。

未来计划支持定制属性；请参阅问题 #355。

物业名称	物业类型	笔记
`Name`	标题	可通过 Notero 首选项中的“概念页面标题”选项配置格式
`Abstract`	文本
`Authors`	文本
`Citation Key`	文本	需要更好的 BibTeX
`Collections`	多选
`Date`	文本
`Date Added`	日期
`Date Modified`	日期
`DOI`	网址
`Editors`	文本
`Extra`	文本
`File Path`	文本
`Full Citation`	文本	基于导出 → 快速复制 → 项目格式的 Zotero 设置的格式
`In-Text Citation`	文本	基于导出 → 快速复制 → 项目格式的 Zotero 设置的格式
`Item Type`	选择
`Place`	文本
`Proceedings Title`	文本
`Publication`	文本
`Series Title`	文本
`Short Title`	文本
`Tags`	多选
`Title`	文本
`URL`	网址
`Year`	数字
`Zotero URI`	网址	如果登录到 Zotero，则打开网络库中的项目

安装和配置 Notero 插件

重要的

最新版本的 Notero 需要 Zotero 7.0 或更高版本。
Notero v0.5.17 中提供了对 Zotero 6.0.27 及更高版本的支持。
请参阅变更日志以获取所有发行说明。

下载最新版本的.xpi文件。
- Firefox 用户请注意：您需要右键单击上述下载链接并选择“链接另存为...”才能正确下载文件。
- 如果上述下载链接不起作用，您可以从最新版本页面的资产部分下载.xpi文件。
通过工具 → 插件菜单项打开 Zotero 插件管理器。
通过以下任一方式安装.xpi文件：
- 将其拖放到插件管理器窗口中或
- 使用窗口右上角齿轮菜单中的“从文件安装插件...”选项选择它
从“工具”→“Notero 首选项... ”菜单项打开 Notero 首选项，然后输入所需的首选项。
- Zotero 7 用户请注意：Notero 首选项已移至 Zotero 首选项主窗口中的一个部分。

使用指南

有关设置和使用 Notero 的更多视觉指南，请参阅社区优秀成员制作的以下资源：

使用 Notion 和 Zotero 构建文献跟踪器（博客文章）作者：Jewel Johnson
如何同步 Zotero → 概念 // 研究论文工作流程（2023 年教程）（视频），作者：Holly Jane
从集成 Zotero 和 Notion 开始进行智能笔记：第一步（视频），作者：Jingjing Lin 博士

如果您想分享您如何使用 Notero 并希望列在此处，请随时提交 PR 或联系我！

常见问题解答

如何从 Notion 同步回 Zotero

虽然这很好，但不幸的是它超出了这个插件的范围。从 Notion 获取更新到 Zotero 需要设置一个托管服务，该服务从 Notion 订阅 webhooks，然后使用 Zotero API 更新 Zotero 中的项目。 Notion 尚未发布官方 webhook 支持，但有一些第三方工具可以用于此目的。理论上，这在技术上是可行的，但这将是一个单独的项目。

如何将附件同步到 Notion

由于 Notion 存在以下限制，目前没有同步文件或链接到本地文件的好方法：

Notion API目前不支持上传文件。
Notion 仅支持http:和https: URL，因此无法使用file: URL 直接链接到文件。

目前，最好的解决方法是：

使用File Path属性将您指向本地文件的位置。
如果您将文件同步到 Zotero 帐户，您可以从Zotero URI属性打开 Zotero Web 界面，然后从那里打开文件。

如何批量同步现有项目

要同步受监控集合中已有的多个项目，您可以从集合或项目上下文菜单中执行此操作。请参阅上面的同步项目部分。

如何修复 Notion API 错误

找不到数据库

如果您收到以下错误：

APIResponseError：找不到 ID 为： xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx的数据库

这很可能意味着您尚未授予 Notero 访问您的 Notion 数据库的权限。确保遵循配置概念部分中的所有步骤。单击数据库右上角的•••按钮应会显示您为Notero 创建的集成的连接。

连接设置示例

无法更新已存档的页面

如果您收到以下错误：

APIResponseError：无法更新已存档的页面。更新之前您必须取消存档该页面。

当 Notero 尝试同步已在之前的同步中为其创建了 Notion 页面的项目，但该页面已被删除时，可能会发生这种情况。（请注意，删除 Notion 页面会将其移至垃圾箱，Notion API 将此称为“已存档”。）

如 Notero 工作原理部分所述，Notero 通过附加到项目的名为Notion的链接将 Zotero 项目与 Notion 页面关联起来。要解决此问题，请删除有问题的项目上的此链接附件，然后再次执行同步。

不存在的财产

如果您收到以下错误：

APIResponseError：属性不是存在的属性

如果您之前将项目同步到一个 Notion 数据库，然后更改您的 Notero 首选项以指定不同的数据库，则可能会发生这种情况。 Notero 可能会尝试更新旧数据库中的页面，而不是在新数据库中创建页面，如果在不同的数据库中配置了不同的属性，则可能会发生此错误。

要解决此问题，您应该删除 Notion 中的旧数据库，然后将其从 Notion 中的垃圾箱中永久删除。

概念数据库示例

我们提供了一些示例 Notion 数据库，这些数据库已配置了 Notero 同步的所有属性。

打开其中一个示例后，单击页面右上角的“复制”按钮将其复制到您的 Notion 工作区中。

基本示例

一个空数据库，仅包含由 Notero 同步的属性。如果您想从头开始并自行定制，这很有用。

高级示例

具有多个视图和一些示例条目的数据库。有关如何使用不同视图的说明，请参阅下文。

书目信息表视图

表格视图可以轻松编辑条目。
通过单击DOI或URL属性轻松导航到原始来源。
- 书籍的 DOI 可能需要从 Zotero 的Extra字段手动复制和粘贴。
单击Zotero URI属性可查看/编辑 Zotero 中的条目或以不同的引文样式导出参考书目条目。

阅读状态板视图

跟踪您需要查找的有希望的参考文献、您通过馆际互借请求的书籍和文章，以及足够相关以保证进行深入笔记或撰写备忘录的作品。

文献综述表视图

快速分析和比较您正在审阅的文献的属性（例如，理论框架、样本、使用的方法、主要发现等）
使用Related References属性轻松链接到其他作品（例如，同一特刊中的文章、同一编辑书中的书籍章节、响应或扩展其他作品的研究和评论）。

图书画廊视图

添加封面图片（例如，右键单击 → 从亚马逊复制图片地址）。
跟踪您拥有、借阅和借给他人的书籍。
- 添加图书馆图书和馆际互借的到期日期和提醒。

发展

Notero 使用生成器-zotero-plugin 搭建起来，并使用深受 zotero-plugin 启发的构建脚本。非常感谢 @retorquere 创建这些。

本地设置

以下步骤基于 Zotero 插件开发文档，应该允许您自行构建和运行 Notero。

为了避免对您的默认 Zotero 配置文件造成任何潜在损坏，您可以创建一个新的配置文件以用于开发目的。
创建一个名为zotero.config.json的文件，其中包含用于启动 Zotero 的配置选项。请参阅zotero.config.example.json以获取包含所有可用配置选项描述的示例文件。
安装依赖项：
```
 npm ci
```
构建 Notero 并启动安装了插件的 Zotero：
```
 npm start
```
或者，您可以启动您想要的 Zotero 测试版：
```
 npm run start-beta
```
start脚本执行多个步骤：
1. 执行npm run build将插件构建到build目录中。
2. 如果已定义，请运行zotero.config.json中指定的scripts.prestart命令。
3. 将包含build目录绝对路径的文件写入 Zotero 配置文件目录中的extensions目录中。
4. 从 Zotero 配置文件目录中的prefs.js中删除extensions.lastAppBuildId和extensions.lastAppVersion行。
5. 使用zotero.config.json中指定的配置文件和以下命令行参数启动 Zotero：
```
 -purgecaches -ZoteroDebugText -jsdebugger -datadir profile
```
6. 如果已定义，请运行zotero.config.json中指定的scripts.poststart命令，并为其提供ZOTERO_PID环境变量。