> ## 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. # Overleaf İçe Aktarma API'si ### "Overleaf Import API" özelliği Ayakaleaf Pro v6.3'ten itibaren, Overleaf'in ["Open in Overleaf" API'sine](https://cn.overleaf.com/devs) 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](/tr/on-premises/configuration/overleaf-toolkit/overleaf-import-api#signed-out-visitors "mention"). Ö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: ```text wrap theme={null} https://ayakaleaf.example.com/docs?snip_uri=https%3A%2F%2Fexample.com%2Fmain.tex ``` ```text wrap theme={null} 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,` | | Sıkıştırılmış proje | `zip_uri` | `data:application/zip;base64,` | 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: ```text theme={null}
``` 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](/tr/on-premises/configuration/overleaf-toolkit/public-access#page-access "mention"). Ayakaleaf Pro, harici kaynakları getirmek için `linked-url-proxy` mikro hizmetini (esas olarak [external-url.md](/tr/on-premises/configuration/overleaf-toolkit/external-url "mention") 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](/tr/on-premises/configuration/overleaf-toolkit/external-url#outbound-proxy "mention") bölümüne bakın. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.