Integrace se Zotero

Umožněte uživatelům importovat do projektu soubor .bib z jejich knihovny Zotero.

Tuto funkci původně vyvinuli davrot a yu-i-i/overleaf-cep, ayaka-notes/ayakaleaf-pro ji upravil o podporu OAuth. Je k dispozici od verze v6.2.0. Stále je ve fázi beta. Pokud narazíte na jakýkoli problém, potřebujeme vaši zpětnou vazbu.

​

Nastavení integrace se Zotero

1. Otevřete tento odkaz a vytvořte klienta Zotero OAuth (jak ukazuje obrázek)
2. Zvolte Application Type: Browser
3. Nastavte Callback URL na ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
4. Nakonfigurujte svůj soubor 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=

​

Poznámky

Při upgradu existující instalace se soubory bibliografie propojenými se Zotero na znovu vydanou verzi 6.3.0 postupujte podle pokynů v #ayakaleaf-pro-6.3.0. Nové instalace tuto migraci nepotřebují.

Protože Ayakaleaf je platforma pro spolupráci, bude z bezpečnostních důvodů od verze 6.3.0 aktualizovat importovaný referenční soubor bib smět pouze jeho původní tvůrce.

Předpokládejme například, že vlastník projektu, uživatel A, povolí sdílení odkazem a vytvoří v projektu soubor test.bib, který propojí se svým vlastním účtem Zotero. Pokud k projektu přistoupí přes sdílený odkaz jiný uživatel, uživatel B, bude moci soubor test.bib číst a stahovat, ale nebude jej smět aktualizovat ani znovu importovat ze Zotero. Aktualizace může provádět pouze uživatel A jakožto původní tvůrce referenčního souboru. Jinými slovy, oprávnění aktualizovat soubor .bib má pouze jeho původní tvůrce.

​

Otázky a odpovědi

Jak v projektu používat Zotero?

Odpověď: Po propojení Zotera v Account Settings otevřete projekt a klikněte na New file → From Zotero. Zvolte název souboru, ve výchozím nastavení zotero.bib, a knihovnu, a poté soubor vytvořte. Jeho položky citujte jako obvykle, například pomocí \bibliography{zotero}.

Soubor je v editoru pouze pro čtení. Po změně své knihovny Zotero soubor otevřete a kliknutím na Refresh jej znovu importujte.

Proč je „Main bibliography file for this project“ prázdné nebo neaktivní?

Odpověď: Toto nastavení uvádí pouze soubory .bib, které lze upravovat v editoru. Soubory importované ze Zotera jsou pouze pro čtení, a proto se v seznamu nezobrazují. Jde o očekávané chování: jejich položky můžete i nadále citovat.

Musí být moje instance dostupná z internetu?

Odpověď: Ne. Propojení Zotera probíhá přes prohlížeč uživatele, takže k Zoteru se musí dostat pouze server. Pokud k tomu potřebuje proxy, nastavte ZOTERO_PROXY_URL.