Overleaf Import API

​

Funktionen “Overleaf Import API”

Fra og med Ayakaleaf Pro v6.3 kan du oprette links, der importerer en LaTeX-fil eller et zippet projekt fra en URL og åbner det i din egen Ayakaleaf-instans, på samme måde som Overleafs “Open in Overleaf”-API.

Denne funktion er aktiveret som standard; du skal blot besøge your.overleaf.com/devs for at se en detaljeret side med instruktioner.

Siden /devs kræver login, medmindre OVERLEAF_ALLOW_PUBLIC_ACCESS=true, se Signed-out visitors.

Hvis du for eksempel hoster en LaTeX-fil på https://example.com/main.tex eller et komplet projekt på https://example.com/project.zip, kan du oprette et link, der importerer det til din egen Ayakaleaf Pro-instans og åbner det nye projekt:

LaTeX-fil

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

ZIP-projekt

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

Erstat ayakaleaf.example.com med din instans’ domæne.

​

Åbn et LaTeX-projekt i Ayakaleaf Pro

Fra og med Ayakaleaf Pro v6.3 kan du oprette et link, der importerer en LaTeX-fil eller et zippet projekt til din egen Ayakaleaf Pro-instans. Når nogen åbner linket, opretter Ayakaleaf Pro et nyt projekt ud fra den angivne fil og åbner det i editoren.

Send linket til din instans’ /docs-endpoint:

Parameter	Beskrivelse	Eksempel
snip_uri	URL til en LaTeX-fil, der skal importeres. En enkelt ZIP-fil accepteres også, men brug zip_uri til projekter.	https://example.com/main.tex
zip_uri	URL til et zippet LaTeX-projekt, der skal importeres.	https://example.com/project.zip
snip_uri[]	Importér flere filer ved at gentage denne parameter.	snip_uri[]=.../main.tex&snip_uri[]=.../refs.bib
snip_name[]	Angiv filnavnet for hver snip_uri[] i samme rækkefølge.	snip_name[]=main.tex
engine	Angiv compileren: latex_dvipdf, pdflatex, xelatex eller lualatex.	engine=xelatex
main_document	Angiv den primære .tex-fil i det importerede projekt.	main_document=main.tex
name	Angiv navnet på det nye projekt. project_name accepteres også.	name=My%20Project

Hvis dine filer for eksempel hostes på example.com, importerer disse links dem til en Ayakaleaf Pro-instans, der hostes på ayakaleaf.example.com.

​

Importér et projekt med Base64

Du kan indlejre en LaTeX-fil eller et zippet projekt direkte i et “Open in Ayakaleaf”-link som en Base64-data-URL. Det giver dig mulighed for at oprette et importlink uden at hoste filen på en separat URL.

Indhold	Parameter	Data-URL-format
LaTeX-fil	snip_uri	data:application/x-tex;base64,<base64-encoded-tex>
Zippet projekt	zip_uri	data:application/zip;base64,<base64-encoded-zip>

For at importere et ZIP-projekt skal du i stedet Base64-kode ZIP-filen og sende den via zip_uri. Brug encodeURIComponent på hele data-URL’en, når du konstruerer et af disse links. Til store projekter bør du bruge en hostet ZIP-URL, fordi browserens og serverens grænser for URL-længde kan gøre Base64-links upraktiske.

​

Tilføj en “Open in Ayakaleaf”-knap

Du kan bruge en HTML-formular til at importere en fil, når en besøgende klikker på en knap. Send formularen til din instans’ /docs-endpoint med method="post".

For en hostet LaTeX-fil:

<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 at importere et zippet projekt skal du erstatte snip_uri med zip_uri og lade den pege på ZIP-filen. Du kan også sende LaTeX-kildekode direkte med snip for rå tekst eller encoded_snip for URL-kodet tekst.

Erstat ayakaleaf.example.com med din instans’ domæne. Hvis din instans har blokering af cross-origin-anmodninger aktiveret, skal du tilføje det websted, der hoster formularen, til ALLOWED_ORIGINS.

​

Besøgende, der ikke er logget ind

Det nye projekt oprettes på den besøgendes konto, så vedkommende skal logge ind. Hvordan en besøgende, der ikke er logget ind, kommer dertil, afhænger af, hvordan importen sendes:

• Links (GET /docs?...) fungerer på alle instanser: Den besøgende sendes til login-siden, og importen fortsætter efter login.
• Formularer (POST /docs) kræver OVERLEAF_ALLOW_PUBLIC_ACCESS=true for besøgende, der ikke er logget ind. Indsendelsen gemmes så i 10 minutter, indtil den besøgende har logget ind, og bruges én gang.

Som standard (OVERLEAF_ALLOW_PUBLIC_ACCESS ikke sat) sendes en formular, der indsendes af en besøgende, som ikke er logget ind, til login-siden, før Ayakaleaf Pro læser den, og indsendelsen går tabt: Efter login ser den besøgende no snippet, snip_uri or zip_uri provided. Brug links, bed de besøgende om at logge ind først, eller aktivér offentlig adgang, se Page Access.

Hvilke ZIP- eller TeX-ressourcer kan jeg importere?

Ayakaleaf Pro bruger mikrotjenesten linked-url-proxy (der primært bruges til external-url.md) til at hente eksterne ressourcer. Generelt kan enhver offentligt tilgængelig ZIP- eller TeX-ressource på internettet importeres. Ressourcer, der hostes på private eller interne netværk, blokeres af sikkerhedshensyn.

Fra og med den genudgivne Ayakaleaf Pro 6.3.0 (3. oktober 2026) kan du konfigurere en HTTP(S)-proxy til at hente eksterne ZIP- og TeX-ressourcer med OVERLEAF_LINKED_URL_OUTBOUND_PROXY. Se Outbound Proxy for at få oplysninger om konfiguration og begrænsninger af netværksadgang.