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

> Legg til en lenke på nettstedet ditt som åpner en LaTeX-fil eller et helt prosjekt i instansen din.

Legg en lenke på nettstedet, bloggen eller kurssiden din. Alle som klikker på den, får et eget nytt prosjekt med filene dine. Ingenting trenger å settes opp.

Besøkende trenger en konto på instansen din. En besøkende som ikke er logget inn, kommer først til innloggingssiden, og prosjektet åpnes etter innloggingen.

Sidene for denne funksjonen bruker navnet Overleaf. Din egen lenke eller knapp kan ha hvilken som helst tekst, for eksempel **Open in Ayakaleaf**.

## Se eksemplene

Åpne `/devs` på nettstedet ditt, for eksempel `https://ayakaleaf.example.com/devs`. Ingen meny lenker til denne siden, så skriv inn adressen selv. Som standard må du være logget inn for å se den.

![Siden Overleaf API med knappene A LaTeX code snippet og 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)

Siden Overleaf API

Klikk på **A LaTeX code snippet** eller **A zipped project**. Et nytt prosjekt med eksemplet åpnes.

![Prosjektet I am a Zip file med main.tex, main2.tex og sample.bib, og PDF-en](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)

Prosjektet fra zip-eksemplet

## Lenke til en fil på nettstedet ditt

**1. Bygg lenken**

Sett den URL-kodede adressen til filen etter `/docs?snip_uri=`:

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

For et zippet prosjekt bruker du `zip_uri`:

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

Instansen din laster ned filen, så den må være tilgjengelig over HTTP eller HTTPS. Adresser i et privat nettverk avvises, se [External URL](https://ayakaleaf-pro.mintlify.site/no/on-premises/configuration/overleaf-toolkit/external-url.md).

**2. Legg den til på siden din**

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

**3. Klikk på den**

Det nye prosjektet åpnes i redigeringsprogrammet, med én fil lagret som `main.tex`.

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

Et prosjekt åpnet fra en lenke

Hvert klikk oppretter et nytt prosjekt. Prosjektet er en kopi, så senere endringer i filen din når det ikke.

## Legg filen i lenken

For en liten fil trenger du ikke å være vert for noe: legg innholdet i lenken som en Base64-data-URL. I JavaScript:

```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` tar bare imot Latin-1-tegn, så kod annen tekst som UTF-8 først. For et zippet prosjekt bruker du `zip_uri` og `data:application/zip;base64,`.

En lenke som er lengre enn omtrent 8 KB, avvises med feilen **414 Request-URI Too Large**. For noe større er du vert for filen eller bruker et [skjema](#use-a-button-instead-of-a-link).

## Velg alternativene

Legg disse til i lenken, eller i skjemaet som skjulte felt:

| Parameter | Hva den gjør | Eksempel |
| - | - | - |
| `name` | Gir prosjektet navn. Uten den får et zippet prosjekt navnet fra sin `\title`, og alt annet heter `Open in Overleaf project`. | `name=My%20notes` |
| `engine` | Angir kompilatoren: `latex_dvipdf`, `pdflatex`, `xelatex` eller `lualatex`. | `engine=xelatex` |
| `main_document` | Angir hovedfilen `.tex`, som åpnes først. | `main_document=thesis.tex` |
| `snip_uri[]`, `snip_name[]` | Importerer flere filer, hver med sitt eget navn, i samme rekkefølge. | `snip_uri[]=.../a.tex&snip_name[]=a.tex` |

En `.tex`-fil uten `\documentclass` pakkes inn i et standarddokument, så den kompileres med en gang:

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

## Bruk en knapp i stedet for en lenke

Et skjema sender de samme parameterne som en lenke:

```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>
```

For å sende selve LaTeX-koden bruker du `snip` for ren tekst eller `encoded_snip` for tekst som er sendt gjennom `encodeURIComponent`.

Et skjema fungerer ikke alltid, og derfor er en lenke det beste valget med mindre filen din er for lang til en:

| Hvor skjemaet er | Besøkende er logget inn | Besøkende er ikke logget inn |
| - | - | - |
| På samme domene som instansen din, eller et underdomene | Prosjektet åpnes | Innloggingsside, ikke noe prosjekt |
| På et annet domene | Innloggingsside, ikke noe prosjekt | Innloggingsside, ikke noe prosjekt |

Hvis administratoren setter `OVERLEAF_ALLOW_PUBLIC_ACCESS=true`, åpnes prosjektet i alle disse tilfellene, etter innlogging om nødvendig. Den innstillingen åpner også andre sider for utloggede besøkende, se [Page Access](https://ayakaleaf-pro.mintlify.site/no/on-premises/configuration/overleaf-toolkit/authentication/public-access.md#page-access).

Resten av det administratorer kan stille inn, finner du i [Overleaf Import API](https://ayakaleaf-pro.mintlify.site/no/on-premises/configuration/overleaf-toolkit/integrations/overleaf-import-api.md). Siden `/devs` har flere eksempler.

## Hvis prosjektet ikke åpnes

Siden forteller hva som gikk galt. **View the Overleaf API docs** tar deg til `/devs`.

![Siden Open in Overleaf med meldingen invalid url og knappen 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)

En lenke instansen ikke kan bruke

| Melding | Hvorfor | Hva du gjør |
| - | - | - |
| `no snippet, snip_uri or zip_uri provided` | Lenken har ingen av disse | Kontroller parameternavnene |
| `invalid url: ...` | Adressen begynner ikke med HTTP eller HTTPS | Bruk en HTTP- eller HTTPS-adresse, eller en data-URL |
| `could not download ... (HTTP 404)` | Filen finnes ikke på den adressen | Kontroller adressen |
| `could not download ... (HTTP 403)` | Adressen er i et privat nettverk | Legg filen der instansen din har lov til å nå den |
| `zip_uri did not resolve to a zip archive` | Filen bak `zip_uri` er ikke en zip-fil | Kontroller filen |
| `invalid base64 data url` | Data-URL-en er skadet | Kod filen på nytt og URL-kod lenken |


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