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環境變數。