Bibliografías web interactivas con Zotero
Instalaciones de ejemplo
Sitio web de laboratorio en Penn State
Sitio web personal
Documentación
http://zot-bib-web.readthedocs.io/
Autor/Contacto:
David [email protected] http://www.david-reitter.com
Características
Esta herramienta genera bibliografías web interactivas basadas en una o más colecciones en un repositorio de Zotero. Los grupos de personas pueden mantener las colecciones, utilizando la interfaz web de Zotero o sus aplicaciones de escritorio.
Las bibliografías se pueden ordenar mediante la colección, por año de publicación, o por tipo de publicación (por ejemplo, artículos de revistas primero), se pueden buscar interactivamente, se pueden vincular a documentos PDF u otras URL, tener registros para Bibtex, EndNote y Wikipedia, y se puede exportar a HTML o llevar a una base de datos.
ZOT_BIB_WEB no depende de ningún servidor web de terceros. Las bibliografías generadas se cargan rápidamente porque se almacenan como archivos estáticos junto con el resto de su sitio web. Esto es una buena fuente para los trabajadores web, incluidos Google Scholar y el CitaSeer.
La configuración es fácil para cualquiera que ejecute su propio sitio web y sepa cómo usar una línea de comandos (shell). La forma más fácil de usarlo es llamar a Zot.py con la clave de una colección pública de Zotero. Hará un archivo zotero-bib.html. Copie esto, junto con el directorio "Sitio" y "Archivos" (si los hay) a su servidor web.
Manifestación
Vea los archivos HTML en la carpeta de demostración para obtener algunos ejemplos de bibliografías. Se incluyen sus respectivos archivos de configuración y archivos de estilo CSS.
Correr:
./zot.py --settings demo/settings3.py
para verlo en acción.
Licencia y donaciones
- Use y modifique este software de forma gratuita.
- No se proporciona ninguna garantía.
- Envíe un correo electrónico a [email protected] Un enlace a la bibliografía en su sitio web si decide usar zot_bib_web.
- Puede usar este software de forma gratuita.
Requisitos
Python 2.7 o 3.6+
Pyzotero. Para instalar Pyzotero, una biblioteca para Python:
sudo pip instalar pyzotero
o:
sudo fácil_install pyzotero
Una colección Zotero con su bibliografía (como usuario o como grupo)
Opcional: paquete DateUtils para Python (mejora el análisis de la fecha si está presente)
Configuración
Asegúrese de que Zot.py sea ejecutable (chmod ug+x zot.py)
Pruébalo. Desde una línea de comandos tipo Unix, haz esto:
./zot.py -Grupo 160464 DTDTV2EP
Luego ver Zotero-bib.html en un navegador. Si eso se ve bien, pase a los siguientes pasos para la configuración.
- En un nuevo archivo llamado settings.py, agregue la configuración como se documenta en el archivo settings_example.py. Vaya a zotero.org para obtener su clave secreta API y sus ID de usuario o biblioteca. Es fácil: vea la parte superior de Settings.example.py para más detalles. Si Settings.py está configurado, puede llamar a Zot.py sin argumentos.
Alternativamente, puede usar la configuración principal en argumentos al programa.
Bibliografía en Zotero
- Con Zotero, cree una bibliografía y tenga en cuenta su ID (por ejemplo, de la URL en la interfaz web Zotero). Ejemplo:
MGID90AT . Esta identificación es lo que necesita para la variable "toplevelfilter" en settings.py. - Puede agregar subcolecciones a su bibliografía.
- Si formatea las colecciones ordenadas, darles un pedido puede ser útil. Puede nombrar colecciones que comienzan con un número: "10 Psicología Social".
Aquí hay un ejemplo de una estructura de bibliografía:
Mis publicaciones [mgid90at]
10 obras seleccionadas
15 en preparación / bajo revisión
20 obras arbitradas por tema
Semántica
Analizador
Diálogo
Aprendizaje automático
30 tesis
40 charlas (sin papel)
Para ver esto, use el Settings.py provisto como ejemplo.
Descripción general de las opciones de configuración
- La configuración se lleva a cabo en un archivo de configuración, de forma predeterminada, Settings.py.
- Llame ./zot.py --help para ver una lista de opciones de línea de comandos.
- Consulte la documentación para obtener información sobre el archivo de configuración, o lea Settings_example.py. Se discuten algunas opciones a continuación.
- Puede ordenar nuestra bibliografía por subcolección, por año o por tipo de publicación (por ejemplo, artículos de revistas primero, luego documentos de conferencia). Incluso dentro de las categorías de nivel superior, puede ordenar sus entradas bibliográficas como desee. Use la configuración "sort_criteria" y "show_top_section_headings".
- Puede elegir una convención de formato diferente. El valor predeterminado es el formato APA.
- En la parte superior, se pueden mostrar un cuadro de búsqueda y un conjunto de atajos: por ejemplo, varios años o tramos de años, tipos de publicación o subcolecciones que indican áreas temáticas. Un visitante puede hacer clic en estos para filtrar rápidamente la bibliografía.
- Configure los atajos que se muestran en la parte superior utilizando la variable show_shortcuts. 'Collection', 'Type', 'Year', 'Venue', 'Venue_Short' y 'Etiquetas' son valores compatibles, además de listas de valores más de grano fino que puede crear utilizando la función Storkcut (). Puede dar la lista de valores o rangos (durante años), su pedido y algunos filtros para mostrar solo los más comunes. Consulte settings.example.py para obtener un ejemplo detallado.
- Hay varias opciones más. Nuevamente, vea Settings_example.py.
Implementación en un sitio web
- Cargue la carpeta del sitio o su contenido a un lugar público en su servidor web. Por defecto, /sitio /... es la URL supuesta.
Para generar HTML e incluirlo en un sitio web:
- Ejecute zot.py una vez/en demanda, o instale como trabajo o servicio cron en un servidor no lo ejecute más de una vez al día. Confígalo directamente en Zot.py, o en un archivo separado Settings.py para simplificar la actualización.
- Incluya el archivo resultante zotero-bib.html (o según lo configurado) en su sitio web como mejor le parezca. También puede incluir archivos de recopilación individuales, que también se generan. Puede configurar Zot.py para generar un documento HTML completo, o simplemente una parte de él. ZOT_BIB_WEB genera contenido HTML5.
- Estille su bibliografía con CSS. Se incluye un archivo de estilo de ejemplo (ver Sitio/ Directorio).
Soporte de WordPress
Este paquete puede empujar directamente a un sitio de WordPress. Se incluye un programa separado "Push.py" para hacer esto.
Sigue estos pasos:
- Configure Zot.py para generar una bibliografía que le guste. Llame a Zot.py-Full para generar un archivo completo Zotero-Bib.html para fines de depuración. Configurar settings.py para no generar el código HTML completo.
- Instale el complemento WPAUTOP-Control (o un complemento similar) para asegurarse de que WP no inserta saltos de párrafo en varios lugares de la bibliografía. Con este complemento, deberá agregar un "campo personalizado" a la página creada en el siguiente paso (elija "Opciones de pantalla" en la parte superior de la vista de la página, habilite los campos personalizados. Luego encuentre campos personalizados en la parte inferior de la página y agregue un campo "WPAutop" con valor "NO".
- Cree una página WP o una publicación para la bibliografía. Inserte [colección zot_bib_web] donde desea insertarse la bibliografía. Reemplace la colección con la identificación de la colección. (Más opciones: ver push.py)
- Copie el contenido de la hoja de estilo (en el sitio/) a su tema de WordPress (seleccione "Editor" o "CSS adicional").
- Configurar settings.py para que jQuery y otros archivos estén disponibles en el servidor web. Por lo general, esto sería jQuery_Path = "../wp-includes/js/jquery/jquery.js" portapock.js y clippy.svg: puede consultar una URL pública o servir los archivos usted mismo.
- Configurar push.py (en la parte superior). Necesitará saber algunos detalles simples sobre su instalación de WP.
- Ejecute push.py regularmente o a pedido. Llamará a Zot.py automáticamente y luego actualizará la página en WP.
