zot_bib_web

Bibliographies Web interactives avec Zotero

Exemples d'installations

Site Web de laboratoire à Penn State

Site Web personnel

Documentation

http://zot-bib-web.readthedocs.io/

Auteur / Contact:

David Reitter - [email protected] http://www.david-reitter.com

Caractéristiques

Cet outil génère des bibliographies Web interactives basées sur une ou plusieurs collections dans un référentiel Zotero. Les collections peuvent être maintenues par des groupes de personnes, en utilisant l'interface Web de Zotero ou leurs applications de bureau.

Les bibliographies peuvent être commandées par la collection, par année de publication, ou par type de publication (par exemple, les articles de revues en premier), sont consultables de manière interactive, peuvent être liées à des documents PDF ou à d'autres URL, ont des enregistrements pour Bibtex, EndNote et Wikipedia, et peuvent être exportés vers HTML ou poussés vers une données WordPress.

ZOT_BIB_WEB ne dépend de aucun serveur Web tiers. Les bibliographies générées se chargent rapidement car elles sont stockées comme des fichiers statiques avec le reste de votre site Web. Cela fait une bonne source pour les webcrawlers, notamment Google Scholar et Citaiser.

La configuration est facile pour quiconque exécute son propre site Web et sait comment utiliser une ligne de commande (Shell). La façon la plus simple de l'utiliser est d'appeler Zot.py avec la clé d'une collection publique Zotero. Il fera un fichier zotero-bib.html. Copiez ceci, ainsi que le répertoire "Site" et "Fichiers" (le cas échéant) dans votre serveur Web.

Démo

• Consultez les fichiers HTML dans le dossier de démonstration pour quelques exemples de bibliographies. Leurs fichiers de paramètres respectifs et les fichiers de style CSS sont inclus.

• Courir:

   ./zot.py --settings Demo / Settings3.py
  

  pour le voir en action.

Licence et dons

• Utilisez et modifiez ce logiciel gratuitement.
• Aucune garantie n'est fournie.
• Veuillez envoyer un e-mail à [email protected] un lien vers la bibliographie de votre site Web si vous décidez d'utiliser ZOT_BIB_WEB.
• Vous pouvez utiliser ce logiciel gratuitement.

Exigences

• Python 2.7 ou 3.6+

• Pyzotero. Pour installer Pyzotero, une bibliothèque pour Python:

   sudo pip install pyzotero
  

  ou:

   sudo easy_install pyzotero
  

• Une collection Zotero avec votre bibliographie (en tant qu'utilisateur ou en groupe)

• Facultatif: Package DateUtils pour Python (améliore l'analyse de la date si présente)

Installation

• Assurez-vous que Zot.py est exécutable (Chmod Ug + x zot.py)

• Essayez-le. À partir d'une ligne de commande de type Unix, faites ceci:

   ./zot.py --group 160464 dtdtv2ep
  

Affichez ensuite Zotero-Bib.html dans un navigateur. Si cela semble bon, passez aux étapes suivantes pour la configuration.

• Dans un nouveau fichier appelé Settings.py, ajoutez la configuration comme documentée dans le fichier SetfitS_Example.py. Allez sur zotero.org pour obtenir votre clé secrète API et vos ID utilisateur ou bibliothèque. C'est facile: voir le haut des paramètres.example.py pour plus de détails. Si Settings.py est configuré, vous pouvez appeler Zot.py sans arguments.

Alternativement, vous pouvez utiliser les paramètres principaux des arguments au programme.

Bibliographie en zotero

• Avec Zotero, créez une bibliographie et notez son ID (par exemple, à partir de l'URL dans l'interface Web Zotero). Exemple: MGID90AT . Cet ID est ce dont vous avez besoin pour la variable "toplevelfilter" dans Settings.py.
• Vous pouvez ajouter des sous-collections à votre bibliographie.
• Si vous format commandé par les collections, leur donner une commande peut être utile. Vous pouvez nommer des collections en commençant par un numéro: "10 psychologie sociale".

Voici un exemple de structure de bibliographie:

 Mes publications [MGID90AT]
    10 œuvres sélectionnées
    15 en préparation / sous-revue
    20 œuvres arbitrées par sujet
        Sémantique
        Analyse
        Dialogue
        Apprentissage automatique
    30 thèses
    40 pourparlers (sans papier)

Pour voir cela, utilisez les paramètres fournis.py comme exemple.

Aperçu des options de configuration

• La configuration a lieu dans un fichier de paramètres, par défaut nommé paramètres.py.
• Appelez ./zot.py - help pour voir une liste d'options de ligne de commande.
• Veuillez vous référer à la documentation pour obtenir des informations sur le fichier de paramètres ou lire paramètres_example.py. Quelques options sont discutées dans ce qui suit.
• Vous pouvez commander notre bibliographie par sous-collection, par année ou par type de publication (par exemple, articles de revues d'abord, puis documents de conférence). Même dans les catégories de niveau supérieur, vous pouvez trier vos entrées bibliographiques comme vous le souhaitez. Utilisez les paramètres "Sort_criteria" et "show_top_section_headings".
• Vous pouvez choisir une convention de formatage différente. La valeur par défaut est le format APA.
• En haut, une boîte de recherche et un ensemble de raccourcis peuvent être affichés: par exemple, plusieurs années ou des travées d'années, des types de publications ou des sous-collections qui indiquent des sujets. Un visiteur peut cliquer dessus pour filtrer rapidement la bibliographie.
• Configurez les raccourcis indiqués en haut à l'aide de la variable show_shortcuts. «Collection», «type», «année», «lieu», «lieu_short» et «tags» sont des valeurs prises en charge, en plus de listes de valeurs plus fines que vous pouvez créer à l'aide de la fonction Shortcut (). Vous pouvez donner la liste des valeurs ou des gammes (pendant des années), leur commande et un certain filtrage pour afficher uniquement les plus courants. Voir paramètres.example.py pour un exemple détaillé.
• Il y a plusieurs autres options. Encore une fois, voir paramètres_example.py.

Déploiement sur un site Web

• Téléchargez le dossier du site ou son contenu sur un lieu public sur votre serveur Web. Par défaut, / site / ... est l'URL supposée.

Pour générer du HTML et l'inclure sur un site Web:

• Exécutez zot.py une fois / sur demande, ou installez-vous en tant que travail ou service CRON sur un serveur ne l'exécutez pas plus d'une fois par jour. Configurez-le directement dans zot.py, ou dans un fichier séparé Settings.py pour faire la mise à niveau simple.
• Incluez le fichier résultant Zotero-Bib.html (ou comme configuré) dans votre site Web comme bon vous semble. Vous pouvez également inclure des fichiers de collecte individuels, qui sont également générés. Vous pouvez configurer Zot.py pour générer un document HTML complet, ou simplement une partie de celui-ci. ZOT_BIB_WEB génère du contenu HTML5.
• Style votre bibliographie à l'aide de CSS. Un exemple de fichier de style est inclus (voir site / répertoire).

Support WordPress

Ce package peut pousser directement sur un site WordPress. Un programme distinct "push.py" est inclus pour ce faire.

Suivez ces étapes:

1. Configurez Zot.py pour générer une bibliographie que vous aimez. Appelez zot.py --full pour générer un fichier complet zotero-bib.html à des fins de débogage. Configurer les paramètres.py pour ne pas générer le code HTML complet.
2. Installez le plugin WPAUTOP-Control (ou un plugin similaire) pour vous assurer que WP n'insertera pas les ruptures de paragraphe à divers endroits de la bibliographie. Avec ce plugin, vous devrez ajouter un "champ personnalisé" à la page créée à l'étape suivante (choisissez "Options d'écran" en haut de la vue en haut de la page, activez les champs personnalisés. Ensuite, trouvez des champs personnalisés en bas de la page et ajoutez un champ "wpautop" avec de la valeur "non".
3. Créez une page WP ou un article pour la bibliographie. Insérer [ZOT_BIB_WEB Collection] où vous aimeriez la bibliographie insérée. Remplacez la collection par l'ID de la collection. (Plus d'options: voir push.py)
4. Copiez le contenu de la feuille de style (sur site /) sur votre thème WordPress (sélectionnez "Editor" ou "CSS supplémentaire").
5. Configurez les paramètres.py pour que jQuery et d'autres fichiers soient disponibles sur le serveur Web. En règle générale, ce serait jquery_path = "../wp-includes/js/jquery/jquery.js" Clipboard.js et Clippy.svg: vous pouvez vous référer à une URL publique ou servir les fichiers vous-même.
6. Configurez Push.py (en haut). Vous devrez connaître quelques détails simples sur votre installation WP.
7. Exécutez Push.py régulièrement ou à la demande. Il appellera Zot.py automatiquement, puis mettra à jour la page dans WP.