> ## 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.

# Open in Overleaf

> Přidejte na svůj web odkaz, který ve vaší instanci otevře soubor LaTeX nebo celý projekt.

Umístěte odkaz na svůj web, blog nebo stránku kurzu. Každý, kdo na něj klikne, dostane vlastní nový projekt s vašimi soubory. Nic není třeba nastavovat.

Návštěvníci potřebují účet ve vaší instanci. Nepřihlášený návštěvník se nejprve dostane na přihlašovací stránku a projekt se otevře po přihlášení.

Stránky této funkce používají název Overleaf. Váš odkaz nebo tlačítko může obsahovat libovolný text, například **Open in Ayakaleaf**.

## Prohlédněte si příklady

Otevřete na svém webu `/devs`, například `https://ayakaleaf.example.com/devs`. Žádná nabídka na tuto stránku neodkazuje, proto adresu zadejte ručně. Ve výchozím nastavení ji uvidíte jen po přihlášení.

![Stránka Overleaf API s tlačítky A LaTeX code snippet a A zipped project](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/open-in-overleaf-devs.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=e0769b26bc5206799501cf44c0cf2c46)

Stránka Overleaf API

Klikněte na **A LaTeX code snippet** nebo **A zipped project**. Otevře se nový projekt s příkladem.

![Projekt I am a Zip file s main.tex, main2.tex a sample.bib a jeho PDF](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/open-in-overleaf-zip-project.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=0070a05e99c93a4e1ff11962d36a8d83)

Projekt ze zip příkladu

## Odkaz na soubor na vašem webu

**1. Sestavte odkaz**

Za `/docs?snip_uri=` vložte adresu souboru zakódovanou pro URL:

```text theme={null}
https://ayakaleaf.example.com/docs?snip_uri=https%3A%2F%2Fexample.com%2Fmain.tex
```

Pro zabalený projekt použijte `zip_uri`:

```text theme={null}
https://ayakaleaf.example.com/docs?zip_uri=https%3A%2F%2Fexample.com%2Fproject.zip
```

Vaše instance soubor stahuje, takže musí být dostupný přes HTTP nebo HTTPS. Adresy v soukromé síti se odmítají, viz [External URL](https://ayakaleaf-pro.mintlify.site/cs/on-premises/configuration/overleaf-toolkit/external-url.md).

**2. Přidejte ho na stránku**

```html theme={null}
<a href="https://ayakaleaf.example.com/docs?snip_uri=https%3A%2F%2Fexample.com%2Fmain.tex">Open in Ayakaleaf</a>
```

**3. Klikněte na něj**

Nový projekt se otevře v editoru s jediným souborem uloženým jako `main.tex`.

![Projekt Hello from a link v editoru s main.tex a jeho PDF](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/open-in-overleaf-project.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=870760e85a1053dc1730663a74c48744)

Projekt otevřený z odkazu

Každé kliknutí vytvoří další projekt. Projekt je kopie, takže pozdější změny vašeho souboru se do něj nedostanou.

## Vložení souboru do odkazu

U malého souboru nemusíte nic hostovat: vložte jeho obsah do odkazu jako Base64 data URL. V JavaScriptu:

```javascript theme={null}
const tex = '\\documentclass{article}\n\\begin{document}\nHello from a link.\n\\end{document}\n'
const link = 'https://ayakaleaf.example.com/docs?' + new URLSearchParams({
  snip_uri: 'data:application/x-tex;base64,' + btoa(tex),
  name: 'Hello from a link',
})
```

`btoa` přijímá jen znaky Latin-1, proto jiný text nejprve zakódujte jako UTF-8. Pro zabalený projekt použijte `zip_uri` a `data:application/zip;base64,`.

Odkaz delší než asi 8 KB se odmítne s chybou **414 Request-URI Too Large**. Pro větší obsah soubor hostujte nebo použijte [formulář](#use-a-button-instead-of-a-link).

## Volba možností

Přidejte tyto parametry do odkazu nebo do formuláře jako skrytá pole:

| Parametr | Co dělá | Příklad |
| - | - | - |
| `name` | Pojmenuje projekt. Bez něj zabalený projekt převezme název ze svého `\title` a cokoli jiného se jmenuje `Open in Overleaf project`. | `name=My%20notes` |
| `engine` | Nastaví kompilátor: `latex_dvipdf`, `pdflatex`, `xelatex` nebo `lualatex`. | `engine=xelatex` |
| `main_document` | Nastaví hlavní soubor `.tex`, který se otevře jako první. | `main_document=thesis.tex` |
| `snip_uri[]`, `snip_name[]` | Importuje několik souborů, každý s vlastním názvem, ve stejném pořadí. | `snip_uri[]=.../a.tex&snip_name[]=a.tex` |

Soubor `.tex` bez `\documentclass` se zabalí do standardního dokumentu, takže se hned zkompiluje:

```latex theme={null}
\documentclass[12pt]{article}
\usepackage[english]{babel}
\usepackage{amsmath}
\usepackage{tikz}
\begin{document}
Your file
\end{document}
```

## Tlačítko místo odkazu

Formulář odesílá stejné parametry jako odkaz:

```html theme={null}
<form action="https://ayakaleaf.example.com/docs" method="post" target="_blank">
  <input type="hidden" name="snip_uri" value="https://example.com/main.tex">
  <input type="hidden" name="engine" value="xelatex">
  <button type="submit">Open in Ayakaleaf</button>
</form>
```

Chcete-li poslat přímo LaTeX, použijte `snip` pro prostý text nebo `encoded_snip` pro text prošlý funkcí `encodeURIComponent`.

Formulář nefunguje vždy, a proto je odkaz lepší volbou, pokud váš soubor není pro odkaz příliš dlouhý:

| Kde je formulář | Návštěvník je přihlášen | Návštěvník není přihlášen |
| - | - | - |
| Na stejné doméně jako vaše instance nebo na subdoméně | Projekt se otevře | Přihlašovací stránka, žádný projekt |
| Na jiné doméně | Přihlašovací stránka, žádný projekt | Přihlašovací stránka, žádný projekt |

Pokud správce nastaví `OVERLEAF_ALLOW_PUBLIC_ACCESS=true`, projekt se otevře ve všech těchto případech, v případě potřeby po přihlášení. Toto nastavení také zpřístupní další stránky nepřihlášeným návštěvníkům, viz [Page Access](https://ayakaleaf-pro.mintlify.site/cs/on-premises/configuration/overleaf-toolkit/authentication/public-access.md#page-access).

Další nastavení dostupná správcům najdete v [Overleaf Import API](https://ayakaleaf-pro.mintlify.site/cs/on-premises/configuration/overleaf-toolkit/integrations/overleaf-import-api.md). Stránka `/devs` obsahuje další příklady.

## Když se projekt neotevře

Stránka uvede, co se pokazilo. **View the Overleaf API docs** vás přenese na `/devs`.

![Stránka Open in Overleaf se zprávou invalid url a tlačítkem View the Overleaf API docs](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/open-in-overleaf-error.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=0fdd1309fab22f5aa1c80925377627c7)

Odkaz, který instance nemůže použít

| Zpráva | Proč | Co dělat |
| - | - | - |
| `no snippet, snip_uri or zip_uri provided` | Odkaz neobsahuje žádný z těchto parametrů | Zkontrolujte názvy parametrů |
| `invalid url: ...` | Adresa nezačíná HTTP ani HTTPS | Použijte adresu HTTP nebo HTTPS, případně data URL |
| `could not download ... (HTTP 404)` | Soubor na této adrese není | Zkontrolujte adresu |
| `could not download ... (HTTP 403)` | Adresa je v soukromé síti | Hostujte soubor tam, kam má vaše instance přístup |
| `zip_uri did not resolve to a zip archive` | Soubor za `zip_uri` není soubor zip | Zkontrolujte soubor |
| `invalid base64 data url` | Data URL je poškozená | Soubor znovu zakódujte a odkaz zakódujte pro URL |


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