Integracja z Zotero

Pozwól użytkownikom importować do projektu plik .bib z ich biblioteki Zotero.

Ta funkcja została pierwotnie opracowana przez davrot i yu-i-i/overleaf-cep, a następnie zmodyfikowana przez ayaka-notes/ayakaleaf-pro z obsługą OAuth. Jest dostępna od wersji v6.2.0. Nadal znajduje się w fazie beta. Jeśli napotkasz jakiś problem, prosimy o opinię.

​

Konfiguracja integracji z Zotero

1. Otwórz ten link, aby utworzyć klienta OAuth Zotero (jak pokazano na obrazku)
2. Wybierz Application Type: Browser
3. Ustaw Callback URL na ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
4. Skonfiguruj plik 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=

​

Uwagi

Przy aktualizacji istniejącej instalacji z powiązanymi plikami bibliografii Zotero do ponownie wydanej wersji 6.3.0 postępuj zgodnie z #ayakaleaf-pro-6.3.0. Nowe instalacje nie wymagają tej migracji.

Ponieważ Ayakaleaf jest platformą do współpracy, w celu zwiększenia bezpieczeństwa od wersji 6.3.0 tylko pierwotny twórca pliku bibliografii bib może aktualizować zaimportowany plik.

Załóżmy na przykład, że właściciel projektu, Użytkownik A, włącza udostępnianie przez link i tworzy w projekcie plik test.bib powiązany z własnym kontem Zotero. Jeśli inny użytkownik, Użytkownik B, uzyska dostęp do projektu przez udostępniony link, nadal będzie mógł odczytać i pobrać test.bib, ale nie będzie mógł zaktualizować ani ponownie zaimportować pliku z Zotero. Tylko Użytkownik A, jako pierwotny twórca pliku bibliografii, może wykonywać aktualizacje. Innymi słowy, uprawnienia do aktualizacji pliku .bib ma wyłącznie jego pierwotny twórca.

​

Pytania i odpowiedzi

Jak używać Zotero w projekcie?

Odpowiedź: Po połączeniu Zotero w Account Settings otwórz projekt i kliknij New file → From Zotero. Wybierz nazwę pliku (domyślnie zotero.bib) oraz bibliotekę, a następnie utwórz plik. Cytuj jego wpisy jak zwykle, na przykład za pomocą \bibliography{zotero}.

Plik jest w edytorze tylko do odczytu. Po zmianie biblioteki Zotero otwórz plik i kliknij Refresh, aby zaimportować go ponownie.

Dlaczego pole "Main bibliography file for this project" jest puste lub nieaktywne?

Odpowiedź: To ustawienie wyświetla tylko pliki .bib, które można edytować w edytorze. Pliki zaimportowane z Zotero są tylko do odczytu, więc nie są wyświetlane. Jest to zamierzone zachowanie: nadal możesz cytować ich wpisy.

Czy moja instancja musi być dostępna z internetu?

Odpowiedź: Nie. Łączenie Zotero odbywa się za pośrednictwem przeglądarki użytkownika, więc dostęp do Zotero musi mieć jedynie serwer. Jeśli potrzebuje do tego proxy, ustaw ZOTERO_PROXY_URL.