Overleaf İçe Aktarma API'si

​

“Overleaf Import API” özelliği

Ayakaleaf Pro v6.3’ten itibaren, Overleaf’in “Open in Overleaf” API’sine benzer şekilde, bir URL’den LaTeX dosyasını veya sıkıştırılmış (zip) bir projeyi içe aktaran ve onu kendi Ayakaleaf örneğinizde açan bağlantılar oluşturabilirsiniz.

Bu özellik varsayılan olarak etkindir; ayrıntılı sayfayı ve talimatları görmek için yalnızca your.overleaf.com/devs adresini ziyaret etmeniz yeterlidir.

OVERLEAF_ALLOW_PUBLIC_ACCESS=true ayarlanmadığı sürece /devs sayfası oturum açmayı gerektirir; bkz. Oturum açmamış ziyaretçiler.

Örneğin, https://example.com/main.tex adresinde bir LaTeX dosyası veya https://example.com/project.zip adresinde eksiksiz bir proje barındırıyorsanız, bunu kendi Ayakaleaf Pro örneğinize içe aktaran ve yeni projeyi açan bir bağlantı oluşturabilirsiniz:

LaTeX dosyası

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

ZIP projesi

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

ayakaleaf.example.com ifadesini örneğinizin alan adıyla değiştirin.

​

Ayakaleaf Pro’da bir LaTeX projesi açma

Ayakaleaf Pro v6.3’ten itibaren, bir LaTeX dosyasını veya sıkıştırılmış bir projeyi kendi Ayakaleaf Pro örneğinize içe aktaran bir bağlantı oluşturabilirsiniz. Birisi bağlantıyı açtığında Ayakaleaf Pro, sağlanan dosyadan yeni bir proje oluşturur ve onu düzenleyicide açar.

Bağlantıyı örneğinizin /docs uç noktasına yönlendirin:

Parametre	Açıklama	Örnek
snip_uri	İçe aktarılacak LaTeX dosyasının URL’si. Tek bir ZIP dosyası da kabul edilir, ancak projeler için zip_uri kullanın.	https://example.com/main.tex
zip_uri	İçe aktarılacak sıkıştırılmış LaTeX projesinin URL’si.	https://example.com/project.zip
snip_uri[]	Bu parametreyi tekrarlayarak birden fazla dosya içe aktarın.	snip_uri[]=.../main.tex&snip_uri[]=.../refs.bib
snip_name[]	Her snip_uri[] için aynı sırayla dosya adını belirleyin.	snip_name[]=main.tex
engine	Derleyiciyi ayarlayın: latex_dvipdf, pdflatex, xelatex veya lualatex.	engine=xelatex
main_document	İçe aktarılan projedeki ana .tex dosyasını ayarlayın.	main_document=main.tex
name	Yeni projenin adını ayarlayın. project_name da kabul edilir.	name=My%20Project

Örneğin, dosyalarınız example.com üzerinde barındırılıyorsa, bu bağlantılar onları ayakaleaf.example.com adresinde barındırılan bir Ayakaleaf Pro örneğine içe aktarır.

​

Base64 kullanarak bir projeyi içe aktarma

Bir LaTeX dosyasını veya sıkıştırılmış bir projeyi, Base64 veri URL’si olarak doğrudan bir “Open in Ayakaleaf” bağlantısına gömebilirsiniz. Bu sayede dosyayı ayrı bir URL’de barındırmadan bir içe aktarma bağlantısı oluşturabilirsiniz.

İçerik	Parametre	Veri URL’si biçimi
LaTeX dosyası	snip_uri	data:application/x-tex;base64,<base64-encoded-tex>
Sıkıştırılmış proje	zip_uri	data:application/zip;base64,<base64-encoded-zip>

Bir ZIP projesini içe aktarmak için ZIP dosyasını Base64 ile kodlayın ve bunun yerine zip_uri üzerinden iletin. Her iki bağlantıyı oluştururken de veri URL’sinin tamamına encodeURIComponent uygulayın. Büyük projeler için barındırılan bir ZIP URL’si kullanın, çünkü tarayıcı ve sunucu URL uzunluğu sınırları Base64 bağlantılarını kullanışsız hale getirebilir.

​

Bir “Open in Ayakaleaf” düğmesi ekleme

Bir ziyaretçi bir düğmeye tıkladığında dosya içe aktarmak için bir HTML formu kullanabilirsiniz. Formu method="post" ile örneğinizin /docs uç noktasına gönderin.

Barındırılan bir LaTeX dosyası için:

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

Sıkıştırılmış bir projeyi içe aktarmak için snip_uri yerine zip_uri kullanın ve onu ZIP dosyasına yönlendirin. Ayrıca LaTeX kaynağını, ham metin için snip veya URL ile kodlanmış metin için encoded_snip kullanarak doğrudan gönderebilirsiniz.

ayakaleaf.example.com ifadesini örneğinizin alan adıyla değiştirin. Örneğiniz çapraz kaynaklı (cross-origin) istek engellemeyi etkinleştiriyorsa, formu barındıran web sitesini ALLOWED_ORIGINS listesine ekleyin.

​

Oturum açmamış ziyaretçiler

Yeni proje ziyaretçinin hesabında oluşturulur, bu nedenle ziyaretçinin oturum açması gerekir. Oturum açmamış bir ziyaretçinin oraya nasıl ulaşacağı, içe aktarmanın nasıl gönderildiğine bağlıdır:

• Bağlantılar (GET /docs?...) her örnekte çalışır: ziyaretçi giriş sayfasına yönlendirilir ve içe aktarma oturum açıldıktan sonra devam eder.
• Formlar (POST /docs), oturum açmamış ziyaretçiler için OVERLEAF_ALLOW_PUBLIC_ACCESS=true gerektirir. Bu durumda gönderim, ziyaretçi oturum açana kadar 10 dakika boyunca saklanır ve bir kez kullanılır.

Varsayılan olarak (OVERLEAF_ALLOW_PUBLIC_ACCESS ayarlanmamışsa), oturum açmamış bir ziyaretçinin gönderdiği form, Ayakaleaf Pro onu okumadan önce giriş sayfasına yönlendirilir ve gönderim kaybolur: oturum açtıktan sonra ziyaretçi no snippet, snip_uri or zip_uri provided mesajını görür. Bağlantılar kullanın, ziyaretçilerden önce oturum açmalarını isteyin veya genel erişimi etkinleştirin; bkz. Sayfa Erişimi.

Hangi ZIP veya TeX kaynaklarını içe aktarabilirim?

Ayakaleaf Pro, harici kaynakları getirmek için linked-url-proxy mikro hizmetini (esas olarak external-url.md için kullanılır) kullanır. Genel olarak, İnternet üzerinden herkese açık olarak erişilebilen herhangi bir ZIP veya TeX kaynağı içe aktarılabilir. Özel veya dahili ağlarda barındırılan kaynaklar güvenlik nedeniyle engellenir.

Yeniden yayımlanan Ayakaleaf Pro 6.3.0 (3 Ekim 2026) sürümünden itibaren, harici ZIP ve TeX kaynaklarını getirmek için OVERLEAF_LINKED_URL_OUTBOUND_PROXY ile bir HTTP(S) proxy yapılandırabilirsiniz. Yapılandırma ve ağ erişim kısıtlamaları için Giden Proxy bölümüne bakın.