zot_bib_web

Bibliografias interativas da web com Zotero

Exemplo de instalações

Site de laboratório na Penn State

Site pessoal

Documentação

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

Autor/Contato:

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

Características

Essa ferramenta gera bibliografias da Web interativas com base em uma ou mais coleções em um repositório Zotero. As coleções podem ser mantidas por grupos de pessoas, usando a interface da Web do Zotero ou seus aplicativos de desktop.

As bibliografias podem ser encomendadas pela coleção, pelo ano de publicação ou por tipo de publicação (por exemplo, artigos de periódicos primeiro), são pesquisáveis ​​interativamente, podem ser vinculados a documentos em PDF ou outros URLs, possuem registros para BibTex, NOTNOTE e Wikipedia e podem ser exportados para html ou push para um dado de palavra.

ZOT_BIB_WEB não depende de nenhum servidor da web de terceiros. As bibliografias geradas carregam rapidamente porque são armazenadas como arquivos estáticos junto com o restante do seu site. Isso é uma boa fonte para WebCrawlers, incluindo Google Scholar e Citeseer.

A configuração é fácil para quem administra seu próprio site e sabe como usar uma linha de comando (shell). A maneira mais fácil de usá -lo é chamar o zot.py com a chave de uma coleção pública de Zotero. Ele fará um arquivo zotero-bib.html. Copie isso, juntamente com o diretório "Site" e "Arquivos" (se houver) para o seu servidor da web.

Demonstração

• Veja os arquivos HTML na pasta Demo para obter alguns exemplos de bibliografias. Seus respectivos arquivos de configurações e arquivos de estilo CSS estão incluídos.

• Correr:

   ./zot.py -DENETTINGS Demo/Settings3.py
  

  ver isso em ação.

Licença e doações

• Use e modifique este software gratuitamente.
• Nenhuma garantia é fornecida.
• Envie um link para a bibliografia em seu site se você decidir usar zot_bib_web.
• Você pode usar este software gratuitamente.

Requisitos

• Python 2.7 ou 3.6+

• Pyzotero. Para instalar Pyzotero, uma biblioteca para Python:

   sudo pip install pyzotero
  

  ou:

   sudo easy_install pyzotero
  

• Uma coleção Zotero com sua bibliografia (como usuário ou grupo)

• Opcional: Pacote DateUtils para Python (melhora a análise da data, se presente)

Configurar

• Verifique se o zot.py é executável (chmod ug+x zot.py)

• Experimente. De uma linha de comando do tipo Unix, faça isso:

   ./zot.py --Group 160464 dtdtv2ep
  

Em seguida, veja Zotero-bib.html em um navegador. Se isso parecer bom, passe para as próximas etapas para configuração.

• Em um novo arquivo chamado Settings.py, adicione a configuração conforme documentado no arquivo Settings_Example.py. Vá para Zotero.org para obter sua chave secreta da API e seus IDs de usuário ou biblioteca. É fácil: consulte a parte superior do Settings.example.py para obter detalhes. Se o Settings.py estiver configurado, você pode ligar para o Zot.py sem argumentos.

Como alternativa, você pode usar as configurações primárias nos argumentos ao programa.

Bibliografia em Zotero

• Com o Zotero, crie uma bibliografia e observe seu ID (por exemplo, a partir do URL na interface da Web Zotero). Exemplo: MGID90AT . Este ID é o que você precisa para a variável "TopleVelfilter" em Settings.py.
• Você pode adicionar subcolções à sua bibliografia.
• Se você formato encomendado por coleções, dar a eles um pedido pode ser útil. Você pode nomear coleções começando com um número: "10 psicologia social".

Aqui está um exemplo de estrutura de bibliografia:

 Minhas publicações [MGID90AT]
    10 trabalhos selecionados
    15 em preparação / menos de revisão
    20 obras arbitradas por tópico
        Semântica
        Análise
        Diálogo
        Aprendizado de máquina
    30 teses
    40 palestras (sem papel)

Para ver isso, use o Settings.py fornecido como exemplo.

Visão geral das opções de configuração

• A configuração ocorre em um arquivo de configurações, por padrão, nomeado Settings.py.
• Ligue para ./Zot.py-Help para ver uma lista de opções de linha de comando.
• Consulte a documentação para obter informações sobre o arquivo de configurações ou leia Settings_Example.py. Algumas opções são discutidas a seguir.
• Você pode encomendar nossa bibliografia por subcollection, por ano ou por tipo de publicação (por exemplo, artigos de periódicos primeiro e depois documentos de conferência). Mesmo nas categorias de nível superior, você pode classificar suas entradas bibliográficas como desejar. Use as configurações "Sort_Criteria" e "Show_top_section_headings".
• Você pode escolher uma convenção de formatação diferente. O padrão é o formato APA.
• No topo, uma caixa de pesquisa e um conjunto de atalhos podem ser exibidos: por exemplo, vários anos ou vãos de anos, tipos de publicação ou subconsções que indicam áreas de tópicos. Um visitante pode clicar neles para filtrar rapidamente a bibliografia.
• Configure os atalhos mostrados na parte superior usando a variável show_shortcuts. 'Coleção', 'Tipo', 'Ano', 'Venue', 'Venue_short' e 'Tags' são valores suportados, além de listas de valores mais refinados que você pode criar usando a função Shortcut (). Você pode fornecer a lista de valores ou intervalos (por anos), sua ordem e alguma filtragem para mostrar apenas os mais comuns. Consulte o Setting.Example.py para um exemplo detalhado.
• Existem várias outras opções. Novamente, consulte Settings_Example.py.

Implantação em um site

• Carregue a pasta do site ou seu conteúdo para um local público no seu servidor da web. Por padrão, /site /... é o URL assumido.

Para gerar HTML e incluí -lo em um site:

• Execute o Zot.py Once/On Demand ou instale como trabalho ou serviço Cron em um servidor, não o execute mais de uma vez por dia. Configure -o diretamente em zot.py ou em um arquivo de arquivo separado.py para simplificar a atualização.
• Inclua o arquivo resultante zotero-bib.html (ou conforme configurado) em seu site como você achar adequado. Você também pode incluir arquivos de coleta individuais, que também são gerados. Você pode configurar o zot.py para gerar um documento HTML completo ou apenas uma parte dele. ZOT_BIB_WEB gera conteúdo HTML5.
• Estilo sua bibliografia usando CSS. Um arquivo de estilo de exemplo está incluído (consulte o site/ diretório).

Suporte do WordPress

Este pacote pode empurrar diretamente para um site do WordPress. Um programa separado "push.py" está incluído para fazer isso.

Siga estas etapas:

1. Configure o zot.py para gerar uma bibliografia que você gosta. Ligue para ZOT.PY-Full para gerar um arquivo completo Zotero-bib.html para fins de depuração. Configure o Settings.py para não gerar o código HTML completo.
2. Instale o plug-in WPAUTOP-Control (ou um plug-in semelhante) para garantir que o WP não insira quebras de parágrafos em vários lugares da bibliografia. Com este plug -in, você precisará adicionar um "campo personalizado" à página criada na próxima etapa (escolha "Opções de tela" na parte superior da visualização da página, ative campos personalizados. Em seguida, encontre campos personalizados na parte inferior da página e adicione um campo "WPAUTOP" com valor "não".
3. Crie uma página WP ou uma postagem para a bibliografia. Insira [ZOT_BIB_WEB COLECTE] onde você gostaria da bibliografia inserida. Substitua a coleção pelo ID da coleção. (Mais opções: veja push.py)
4. Copie o conteúdo da folha de estilo (no site/) para o seu tema WordPress (selecione "Editor" ou "CSS adicional").
5. Configure o Settings.py para que o jQuery e outros arquivos estejam disponíveis no servidor da Web. Normalmente, isso seria jquery_path = "../wp-includes/js/jquery/jquery.js" clipboard.js e clippy.svg: você pode se referir a um URL público ou servir os arquivos.
6. Configure push.py (na parte superior). Você precisará saber alguns detalhes simples sobre sua instalação WP.
7. Execute push.py regularmente ou sob demanda. Ele chamará o Zot.py automaticamente e atualizará a página no WP.