Overleaf Import API

​

Funksjonen “Overleaf Import API”

Fra og med Ayakaleaf Pro v6.3 kan du lage lenker som importerer en LaTeX-fil eller et zippet prosjekt fra en URL og åpner det i din egen Ayakaleaf-instans, på samme måte som Overleafs «Open in Overleaf»-API.

Denne funksjonen er aktivert som standard; du trenger bare å besøke your.overleaf.com/devs for å se en detaljert side med instruksjoner.

Siden /devs krever innlogging med mindre OVERLEAF_ALLOW_PUBLIC_ACCESS=true, se Utloggede besøkende.

Hvis du for eksempel har en LaTeX-fil på https://example.com/main.tex eller et komplett prosjekt på https://example.com/project.zip, kan du lage en lenke som importerer den til din egen Ayakaleaf Pro-instans og åpner det nye prosjektet:

LaTeX-fil

https://ayakaleaf.example.com/docs?snip_uri=https%3A%2F%2Fexample.com%2Fmain.tex

ZIP-prosjekt

https://ayakaleaf.example.com/docs?snip_uri=https%3A%2F%2Fexample.com%2Fproject.zip

Erstatt ayakaleaf.example.com med domenet til instansen din.

​

Åpne et LaTeX-prosjekt i Ayakaleaf Pro

Fra og med Ayakaleaf Pro v6.3 kan du lage en lenke som importerer en LaTeX-fil eller et zippet prosjekt til din egen Ayakaleaf Pro-instans. Når noen åpner lenken, oppretter Ayakaleaf Pro et nytt prosjekt fra den oppgitte filen og åpner det i editoren.

Send lenken til endepunktet /docs på instansen din:

Parameter	Beskrivelse	Eksempel
snip_uri	URL til en LaTeX-fil som skal importeres. En enkelt ZIP-fil godtas også, men bruk zip_uri for prosjekter.	https://example.com/main.tex
zip_uri	URL til et zippet LaTeX-prosjekt som skal importeres.	https://example.com/project.zip
snip_uri[]	Importer flere filer ved å gjenta denne parameteren.	snip_uri[]=.../main.tex&snip_uri[]=.../refs.bib
snip_name[]	Angi filnavnet for hver snip_uri[], i samme rekkefølge.	snip_name[]=main.tex
engine	Angi kompilatoren: latex_dvipdf, pdflatex, xelatex eller lualatex.	engine=xelatex
main_document	Angi hoved-.tex-filen i det importerte prosjektet.	main_document=main.tex
name	Angi navnet på det nye prosjektet. project_name godtas også.	name=My%20Project

Hvis filene dine for eksempel ligger på example.com, importerer disse lenkene dem til en Ayakaleaf Pro-instans som kjører på ayakaleaf.example.com .

​

Importere et prosjekt med Base64

Du kan bygge inn en LaTeX-fil eller et zippet prosjekt direkte i en «Open in Ayakaleaf»-lenke som en Base64-data-URL. Dette lar deg lage en importlenke uten å måtte legge filen på en egen URL.

Innhold	Parameter	Format for data-URL
LaTeX-fil	snip_uri	data:application/x-tex;base64,<base64-encoded-tex>
Zippet prosjekt	zip_uri	data:application/zip;base64,<base64-encoded-zip>

For å importere et ZIP-prosjekt Base64-koder du ZIP-filen og sender den via zip_uri i stedet. Bruk encodeURIComponent på hele data-URL-en når du bygger en av lenkene. For store prosjekter bør du bruke en ZIP-URL som ligger på en server, fordi begrensninger på URL-lengde i nettlesere og servere kan gjøre Base64-lenker upraktiske.

​

Legge til en «Open in Ayakaleaf»-knapp

Du kan bruke et HTML-skjema for å importere en fil når en besøkende klikker på en knapp. Send skjemaet til endepunktet /docs på instansen din med method="post".

For en LaTeX-fil som ligger på en server:

<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 å importere et zippet prosjekt erstatter du snip_uri med zip_uri og lar den peke til ZIP-filen. Du kan også sende LaTeX-kildekode direkte med snip for råtekst eller encoded_snip for URL-kodet tekst.

Erstatt ayakaleaf.example.com med domenet til instansen din. Hvis instansen din blokkerer forespørsler på tvers av opprinnelser (cross-origin), legger du til nettstedet som har skjemaet i ALLOWED_ORIGINS.

​

Utloggede besøkende

Det nye prosjektet opprettes i den besøkendes konto, så vedkommende må logge inn. Hvordan en utlogget besøkende kommer dit, avhenger av hvordan importen sendes:

• Lenker (GET /docs?...) fungerer på alle instanser: den besøkende sendes til innloggingssiden, og importen fortsetter etter innlogging.
• Skjemaer (POST /docs) krever OVERLEAF_ALLOW_PUBLIC_ACCESS=true for utloggede besøkende. Innsendingen beholdes da i 10 minutter til den besøkende har logget inn, og brukes én gang.

Som standard (OVERLEAF_ALLOW_PUBLIC_ACCESS ikke satt) sendes et skjema fra en utlogget besøkende til innloggingssiden før Ayakaleaf Pro leser det, og innsendingen går tapt: etter innlogging ser den besøkende no snippet, snip_uri or zip_uri provided. Bruk lenker, be besøkende logge inn først, eller aktiver offentlig tilgang, se Sidetilgang.

Hvilke ZIP- eller TeX-ressurser kan jeg importere?

Ayakaleaf Pro bruker mikrotjenesten linked-url-proxy (hovedsakelig brukt for external-url.md) til å hente eksterne ressurser. Generelt kan alle offentlig tilgjengelige ZIP- eller TeX-ressurser på Internett importeres. Ressurser som ligger i private eller interne nettverk, blokkeres av sikkerhetshensyn.

Fra og med den gjenutgitte Ayakaleaf Pro 6.3.0 (3. oktober 2026) kan du konfigurere en HTTP(S)-proxy for henting av eksterne ZIP- og TeX-ressurser med OVERLEAF_LINKED_URL_OUTBOUND_PROXY. Se Utgående proxy for konfigurasjon og begrensninger på nettverkstilgang.