zoterobib

Babero Zotero

Descripción general

Este repositorio contiene código para Zotero Bib, incluidos componentes de React, cliente de traducción, hojas de estilo y sitio web de punto de entrada.

Requisitos previos

1. Nodo JS con npm
2. Herramientas básicas de línea de comandos, incluido rsync
3. Servidor de traducción existente
4. Servidor de dorsales existente
5. Repositorio de estilos existentes

Versión de Desarrollo Local

Obtener la biblioteca

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

2. cd zoterobib

3. npm install

4. npm start

Esto servirá de demostración en http://127.0.0.1:8001.

Es posible que deba proporcionar opciones de configuración (consulte a continuación) para que el almacenamiento y la traducción funcionen.

De forma predeterminada, el servidor de desarrollo envía las solicitudes del servidor de traducciones a localhost:1969 . Si su servidor está ubicado en otro lugar, deberá proporcionar la URL; por ejemplo, el último paso anterior se vería así:

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

Esto enviará las solicitudes del navegador al servidor de traducción especificado.

Uso en producción

Para obtener archivos listos para producción, utilice el siguiente comando npm:

npm run build

Configuración

Es posible proporcionar parámetros de configuración para la compilación (tanto en desarrollo como en producción) utilizando archivos de configuración y/o variables de entorno.

La forma más sencilla es copiar config/default.json a config/local.json y colocar las variables allí (git ignora este archivo y no debe confirmarse). Alternativamente, se pueden utilizar las variables de entorno enumeradas en config/custom-environment-variables.json . Para obtener más detalles sobre cómo proporcionar configuraciones, consulte el paquete config npm.

Opciones de configuración

Se aceptan las siguientes opciones de configuración:

storeURL Especifica la URL de la API del servidor bib donde se almacenan las bibliografías.

estilosURL Especifica la URL del sitio web del repositorio de estilos . Cuando se deja vacío, se usará el valor predeterminado, que es https://www.zotero.org/styles-files/styles.json

TranslatePrefix Especifica un prefijo adicional a dónde se debe enviar la solicitud del servidor de traducción. Útil en casos en los que translateURL se deja vacío para que sea posible dirigir solicitudes a un punto final específico en cualquier lugar donde esté alojado zotero-bib.

traducirURL Especifica la URL para el servidor de traducción . De forma predeterminada, se supone que localhost envía la solicitud al servidor de traducción.

apiAuthorityPart Especifica la parte de autoridad de la URL para las solicitudes de la API de Zotero. El valor predeterminado es api.zotero.org .

Configuración del servidor de desarrollo

La ejecución de npm start comprueba las siguientes variables de entorno:

TRANSLATE_URL Dónde enviar las solicitudes de traducción; el valor predeterminado es http://localhost:1969. De forma predeterminada, ZoteroBib enviará solicitudes de traducción a window.location.origin y el servidor de desarrollo debe configurarse para enviar estas solicitudes a un servidor de traducción.

PUERTO ¿En qué puerto debe escuchar el servidor de desarrollo? El valor predeterminado es 8001.

NO_HYDRATE Al acceder a una bibliografía remota, ZoteroBib puede hidratarse desde HTML prerenderizado para evitar un giro durante la carga. Para fines de desarrollo, se almacena una bibliografía codificada en hydrate.hbs y se utiliza para atender cualquier solicitud que incluya una identificación de bibliografía remota. Para deshabilitar este comportamiento, establezca NO_HYDRATE en 1 , lo que servirá index.hbs en su lugar, lo que significa que la bibliografía siempre se representa en el lado del cliente con un control giratorio.