> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrace se Zotero

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

> [!NOTE]
>
> Tuto funkci původně vyvinuli [davrot](https://github.com/davrot) a [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), [ayaka-notes/ayakaleaf-pro](https://github.com/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.

![](https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/img-b751b9f6.png?fit=max\&auto=format\&n=x9kfDjtWlyyhG_mR\&q=85\&s=80eb902caf484c8cfc1c776017ac2c66)

![](https://mintcdn.com/ayakaleaf-pro/UZ_4Jfz7cU6MnXtE/images/on-premises/image-41.png?fit=max\&auto=format\&n=UZ_4Jfz7cU6MnXtE\&q=85\&s=366c8e9396506163e23ffdc92fbe8c02)

### Nastavení integrace se Zotero

1. Otevřete [tento odkaz](https://www.zotero.org/oauth/apps) 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`

![](https://mintcdn.com/ayakaleaf-pro/UZ_4Jfz7cU6MnXtE/images/on-premises/image-42.png?fit=max\&auto=format\&n=UZ_4Jfz7cU6MnXtE\&q=85\&s=7b2ed79ba28f7d77bc07711068ca71fc)

```dotenv title="config/variables.env" theme={null}
#################
#    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

> [!WARNING]
>
> 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](https://ayakaleaf-pro.mintlify.site/cs/on-premises/release-notes/release-notes-6.x.x.md#ayakaleaf-pro-6.3.0 "mention"). Nové instalace tuto migraci nepotřebují.

> [!CAUTION]
>
> 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

> [accordion] 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.

> [accordion] 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.

> [accordion] 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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.