Integração com Zotero

Permita que os usuários importem um arquivo .bib da biblioteca do Zotero para um projeto.

Este recurso foi desenvolvido inicialmente por davrot e yu-i-i/overleaf-cep e modificado por ayaka-notes/ayakaleaf-pro com OAuth. Foi introduzido a partir da v6.2.0. Ainda está em fase beta. Precisamos do seu feedback caso tenha algum problema.

​

Configurar a integração com Zotero

1. Abra este link para criar um cliente OAuth do Zotero (como mostra a imagem)
2. Escolha Application Type: Browser
3. Configure a Callback URL com o seu ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
4. Configure o seu config/variables.env

config/variables.env

#################
#    Zotero     #
#################
# 'zotero' must be in ENABLED_LINKED_FILE_TYPES (set in develop/docker-compose.yml)
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url,zotero

# From a Zotero OAuth client (register at https://www.zotero.org/oauth/apps)
# Application Type: Browser 
# Callback URL -> ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
ZOTERO_CLIENT_ID=
ZOTERO_CLIENT_SECRET=
# Encrypts the Zotero API key in mongo (set in dev to avoid writing a key file
# to /var/lib/overleaf/data, which the dev web container can't create)
# How to generate: `openssl rand -hex 32`
ZOTERO_CIPHER_PASSWORD=dev-zotero-cipher-password
# Optional: route the module's server-side Zotero requests (OAuth + API) through
# an HTTP proxy (must be reachable from the web container; same as github-sync)
# http://10.0.0.1:10808
# (Optional) ZOTERO_PROXY_URL=

​

Observações

Ao atualizar uma instalação existente com arquivos de bibliografia vinculados ao Zotero para a versão 6.3.0 relançada, siga as #ayakaleaf-pro-6.3.0. Novas instalações não precisam dessa migração.

Como o Ayakaleaf é uma plataforma colaborativa, para melhorar a segurança, a partir da versão 6.3.0, apenas o criador original de um arquivo bib de referências poderá atualizar o arquivo importado.

Por exemplo, suponha que o proprietário do projeto, o Usuário A, ative o compartilhamento por link e crie um arquivo test.bib no projeto, vinculando-o à sua própria conta do Zotero. Se outro usuário, o Usuário B, acessar o projeto pelo link compartilhado, o Usuário B ainda poderá ler e baixar test.bib, mas não poderá atualizar nem reimportar o arquivo do Zotero. Somente o Usuário A, como criador original do arquivo de referências, pode realizar atualizações. Em outras palavras, apenas o criador original do arquivo .bib tem permissão para atualizá-lo.

​

Q&A

Como usar o Zotero em um projeto?

Resposta: Depois de vincular o Zotero em Account Settings, abra um projeto e clique em New file → From Zotero. Escolha um nome de arquivo, zotero.bib por padrão, e a biblioteca; em seguida, crie o arquivo. Cite as entradas normalmente, por exemplo com \bibliography{zotero}.

O arquivo é somente leitura no editor. Depois de alterar sua biblioteca do Zotero, abra o arquivo e clique em Refresh para importá-lo novamente.

Por que “Main bibliography file for this project” está vazio ou desativado?

Resposta: Essa configuração lista apenas arquivos .bib que podem ser editados no editor. Os arquivos importados do Zotero são somente leitura, por isso não são listados. Isso é esperado: você ainda pode citar as entradas deles.

Minha instância precisa estar acessível pela internet?

Resposta: Não. A vinculação do Zotero passa pelo navegador do usuário, então apenas o servidor precisa alcançar o Zotero. Se precisar de um proxy para isso, defina ZOTERO_PROXY_URL.