Zotero-integrasjon

La brukere importere en .bib-fil fra Zotero-biblioteket sitt til et prosjekt.

Denne funksjonen ble opprinnelig utviklet av davrot og yu-i-i/overleaf-cep, og modifisert av ayaka-notes/ayakaleaf-pro med OAuth. Den ble introdusert i v6.2.0 og senere. Den er fortsatt i betastatus. Vi trenger tilbakemeldingen din hvis du opplever problemer.

​

Sette opp Zotero-integrasjon

1. Åpne denne lenken for å opprette en Zotero OAuth-klient (som vist på bildet)
2. Velg Application Type: Browser
3. Sett opp Callback URL med din ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
4. Konfigurer 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=

​

Merknader

Når du oppgraderer en eksisterende installasjon med Zotero-koblede bibliografifiler til den nyutgitte 6.3.0, følger du migreringsinstruksjonene for Zotero / Mendeley. Nye installasjoner trenger ikke denne migreringen.

Siden Ayakaleaf er en samarbeidsplattform, vil det av sikkerhetshensyn fra og med versjon 6.3.0 kun være den opprinnelige oppretteren av en referansefil (bib) som får oppdatere den importerte filen.

For eksempel: Anta at prosjekteieren, bruker A, aktiverer lenkedeling og oppretter en test.bib-fil i prosjektet, koblet til sin egen Zotero-konto. Hvis en annen bruker, bruker B, får tilgang til prosjektet via den delte lenken, kan bruker B fortsatt lese og laste ned test.bib, men får ikke oppdatere eller importere filen på nytt fra Zotero. Bare bruker A, som den opprinnelige oppretteren av referansefilen, kan utføre oppdateringer. Med andre ord er det kun den opprinnelige oppretteren av .bib-filen som har tillatelse til å oppdatere den.

​

Spørsmål og svar

Hvordan bruker jeg Zotero i et prosjekt?

Svar: Etter at du har koblet til Zotero i Account Settings, åpner du et prosjekt og klikker New file → From Zotero. Velg et filnavn, zotero.bib som standard, og biblioteket, og opprett deretter filen. Siter oppføringene som vanlig, for eksempel med \bibliography{zotero}.

Filen er skrivebeskyttet i editoren. Etter at du har endret Zotero-biblioteket ditt, åpner du filen og klikker Refresh for å importere den på nytt.

Hvorfor er «Main bibliography file for this project» tom eller deaktivert?

Svar: Denne innstillingen viser bare .bib-filer som kan redigeres i editoren. Filer som er importert fra Zotero, er skrivebeskyttet, så de vises ikke. Dette er forventet: du kan fortsatt sitere oppføringene i dem.

Må instansen min være tilgjengelig fra internett?

Svar: Nei. Kobling av Zotero går gjennom brukerens nettleser, så det er bare serveren som trenger å nå Zotero. Hvis den trenger en proxy til det, setter du ZOTERO_PROXY_URL.