zoterobib

조테로 턱받이

개요

이 저장소에는 React 구성요소, 번역 클라이언트, 스타일시트 및 진입점 웹사이트를 포함한 Zotero Bib용 코드가 포함되어 있습니다.

전제 조건

1. npm을 사용하는 노드 JS
2. rsync를 포함한 기본 명령줄 도구
3. 기존 번역 서버
4. 기존 턱받이 서버
5. 기존 스타일 저장소

로컬 개발 버전

도서관 얻기

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 패키지를 참조하세요.

구성 옵션

다음 구성 옵션이 허용됩니다.

storeURL 참고문헌이 저장되는 bib-server API의 URL을 지정합니다.

stylesURL styles-repo 웹사이트의 URL을 지정합니다. 비워두면 기본값인 https://www.zotero.org/styles-files/styles.json이 사용됩니다.

TranslationPrefix 번역 서버 요청을 보내야 하는 위치에 대한 추가 접두사를 지정합니다. zotero-bib가 호스팅되는 모든 곳에서 특정 엔드포인트로 요청을 전달할 수 있도록 translateURL 이 비어 있는 경우에 유용합니다.

번역URL 번역 서버 의 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 대신 제공됩니다. 즉, 참고문헌은 항상 스피너를 사용하여 클라이언트측에서 렌더링됩니다.