zoterobib

佐特羅圍兜

概述

此儲存庫包含 Zotero Bib 的程式碼，包括 React 元件、翻譯用戶端、樣式表和入口點網站。

先決條件

1. Node.js 與 npm
2. 基本命令列工具，包括 rsync
3. 現有翻譯伺服器
4. 現有號碼布伺服器
5. 現有樣式-repo

本地開發版本

取得圖書館

1. git clone --recursive [email protected]:zotero/zoterobib.git

2. cd zoterobib

3. npm install

4. npm start

這將在 http://127.0.0.1:8001 上提供演示。

您可能需要提供配置選項（請參閱下文）才能使儲存空間和轉換正常運作。

預設情況下，開發伺服器將翻譯伺服器請求代理程式到 localhost:1969 。如果您的伺服器位於其他地方，您需要提供 url，例如上面的最後一步將如下所示：

1. TRANSLATE_URL=http://localhost:1234 npm start

這會將瀏覽器的請求代理到指定的翻譯伺服器。

在生產中使用

若要取得生產就緒文件，請使用以下 npm 指令：

npm run build

配置

可以使用設定檔和/或環境變數為建置（開發和生產）提供設定參數。

最簡單的方法是將config/default.json複製到config/local.json並在那裡放置變數（該檔案被 git 忽略，不應提交）。或可使用config/custom-environment-variables.json中所列的環境變數。有關如何提供配置的更多詳細信息，請參閱 config npm package。

配置選項

接受以下配置選項：

storeURL指定儲存參考書目的bib-server api 的 url。

stylesURL指定styles-repo網站的 url。當留空時，將使用預設值，即 https://www.zotero.org/styles-files/styles.json

translatePrefix指定翻譯伺服器請求應傳送到的位置的附加前綴。在translateURL留空的情況下很有用，這樣就可以將請求導向到託管 zotero-bib 的特定端點。

translateURL指定翻譯伺服器的 URL。預設情況下，假定 localhost 將請求代理程式到翻譯伺服器。

apiAuthorityPart指定 Zotero API 請求的 URL 的權限部分。預設為api.zotero.org 。

開發伺服器配置

執行npm start檢查以下環境變數：

TRANSLATE_URL代理翻譯要求的位置，預設為 http://localhost:1969。預設情況下，ZoteroBib 會將翻譯請求傳送到window.location.origin ，並且開發伺服器應配置為將這些請求代理到翻譯伺服器。

PORT開發伺服器應偵聽哪個端口，預設為 8001。

NO_HYDRATE存取遠端參考書目時，ZoteroBib 可以從預先渲染的 HTML 中進行水合，以避免載入時出現旋轉。出於開發目的，硬編碼參考書目儲存在hydrate.hbs中，並用於服務任何包含遠端參考書目 ID 的請求。若要停用此行為，請將NO_HYDRATE設為1 ，這將服務於index.hbs ，這表示參考書目始終使用微調器在用戶端呈現。