zoterobib
v2.3.1
このリポジトリには、React コンポーネント、翻訳クライアント、スタイルシート、エントリポイント Web サイトなどの Zotero Bib のコードが含まれています。
ライブラリの入手
git clone --recursive [email protected]:zotero/zoterobib.git
cd zoterobib
npm install
npm start
これは http://127.0.0.1:8001 でデモを提供します。
ストレージと変換を機能させるには、構成オプション (以下を参照) を指定する必要がある場合があります。
デフォルトでは、開発サーバーは翻訳サーバーリクエストを localhost:1969 にプロキシします。サーバーが別の場所にある場合は、URL を指定する必要があります。たとえば、上記の最後のステップは次のようになります。
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 パッケージを参照してください。
次の構成オプションが受け入れられます。
storeURL参考文献が保存されるbib-server API の URL を指定します。
styleURLスタイルリポジトリWeb サイトの URL を指定します。空のままにすると、デフォルトの https://www.zotero.org/styles-files/styles.json が使用されます。
translationPrefix翻訳サーバー要求の送信先に対する追加のプレフィックスを指定します。 zotero-bib がホストされている場所にある特定のエンドポイントにリクエストを送信できるように、 translateURLが空のままの場合に便利です。
translationURL翻訳サーバーの 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が提供されます。これは、参考文献が常にスピナーを使用してクライアント側でレンダリングされることを意味します。
