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

> Web sitenize, örneğinizde bir LaTeX dosyasını veya bütün bir projeyi açan bir bağlantı ekleyin.

Web sitenize, blogunuza veya ders sayfanıza bir bağlantı koyun. Ona tıklayan herkes, dosyalarınızı içeren kendine ait yeni bir proje alır. Herhangi bir kurulum gerekmez.

Ziyaretçilerin örneğinizde bir hesabı olması gerekir. Oturum açmamış bir ziyaretçi önce oturum açma sayfasına gider ve proje oturum açıldıktan sonra açılır.

Bu özelliğin sayfaları Overleaf adını kullanır. Kendi bağlantınız veya düğmeniz istediğiniz metni taşıyabilir, örneğin **Open in Ayakaleaf**.

## Örneklere bakın

Sitenizde `/devs` sayfasını açın, örneğin `https://ayakaleaf.example.com/devs`. Hiçbir menü bu sayfaya bağlantı vermez, bu yüzden adresi yazın. Varsayılan olarak görmek için oturum açmış olmanız gerekir.

![A LaTeX code snippet ve A zipped project düğmeleri bulunan Overleaf API sayfası](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/open-in-overleaf-devs.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=e0769b26bc5206799501cf44c0cf2c46)

Overleaf API sayfası

**A LaTeX code snippet** veya **A zipped project** düğmesine tıklayın. Örneği içeren yeni bir proje açılır.

![main.tex, main2.tex ve sample.bib içeren I am a Zip file projesi ve PDF'i](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)

Zip örneğinden oluşturulan proje

## Web sitenizdeki bir dosyaya bağlantı verme

**1. Bağlantıyı oluşturun**

Dosyanın URL kodlu adresini `/docs?snip_uri=` sonrasına koyun:

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

Sıkıştırılmış bir proje için `zip_uri` kullanın:

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

Örneğiniz dosyayı indirir, bu yüzden dosyanın HTTP veya HTTPS üzerinden erişilebilir olması gerekir. Özel ağdaki adresler reddedilir, bkz. [External URL](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/external-url.md).

**2. Sayfanıza ekleyin**

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

**3. Tıklayın**

Yeni proje, `main.tex` olarak kaydedilmiş tek bir dosyayla düzenleyicide açılır.

![Düzenleyicide main.tex ve PDF'i ile Hello from a link projesi](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/open-in-overleaf-project.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=870760e85a1053dc1730663a74c48744)

Bir bağlantıdan açılan proje

Her tıklama başka bir proje oluşturur. Proje bir kopyadır, bu yüzden dosyanızda sonradan yapılan değişiklikler ona ulaşmaz.

## Dosyayı bağlantıya koyma

Küçük bir dosya için hiçbir şey barındırmanız gerekmez: içeriğini Base64 data URL olarak bağlantıya koyun. JavaScript'te:

```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` yalnızca Latin-1 karakterlerini kabul eder, bu yüzden diğer metinleri önce UTF-8 olarak kodlayın. Sıkıştırılmış bir proje için `zip_uri` ve `data:application/zip;base64,` kullanın.

Yaklaşık 8 KB'tan uzun bir bağlantı **414 Request-URI Too Large** hatasıyla reddedilir. Daha büyük içerikler için dosyayı barındırın veya bir [form](#use-a-button-instead-of-a-link) kullanın.

## Seçenekleri belirleme

Bunları bağlantıya veya gizli alanlar olarak forma ekleyin:

| Parametre | Ne yapar | Örnek |
| - | - | - |
| `name` | Projeye ad verir. Olmadığında sıkıştırılmış proje adını `\title` değerinden alır, diğer her şeyin adı `Open in Overleaf project` olur. | `name=My%20notes` |
| `engine` | Derleyiciyi ayarlar: `latex_dvipdf`, `pdflatex`, `xelatex` veya `lualatex`. | `engine=xelatex` |
| `main_document` | İlk açılan ana `.tex` dosyasını ayarlar. | `main_document=thesis.tex` |
| `snip_uri[]`, `snip_name[]` | Birden fazla dosyayı, her biri kendi adıyla, aynı sırada içe aktarır. | `snip_uri[]=.../a.tex&snip_name[]=a.tex` |

`\documentclass` içermeyen bir `.tex` dosyası standart bir belgeye sarılır, böylece hemen derlenir:

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

## Bağlantı yerine düğme kullanma

Bir form, bağlantıyla aynı parametreleri gönderir:

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

LaTeX'in kendisini göndermek için düz metinde `snip`, `encodeURIComponent` ile işlenmiş metinde `encoded_snip` kullanın.

Form her zaman çalışmaz. Bu yüzden dosyanız bağlantıya sığmayacak kadar uzun değilse bağlantı daha iyi bir seçimdir:

| Formun bulunduğu yer | Ziyaretçi oturum açmış | Ziyaretçi oturum açmamış |
| - | - | - |
| Örneğinizle aynı alan adında veya bir alt alan adında | Proje açılır | Oturum açma sayfası, proje yok |
| Başka bir alan adında | Oturum açma sayfası, proje yok | Oturum açma sayfası, proje yok |

Yöneticiniz `OVERLEAF_ALLOW_PUBLIC_ACCESS=true` ayarlarsa proje, gerekirse oturum açıldıktan sonra, bu durumların hepsinde açılır. Bu ayar, oturumu kapalı ziyaretçilere başka sayfaları da açar, bkz. [Page Access](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/authentication/public-access.md#page-access).

Yöneticilerin ayarlayabileceği diğer şeyler için [Overleaf Import API](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/integrations/overleaf-import-api.md) sayfasına bakın. `/devs` sayfasında daha fazla örnek vardır.

## Proje açılmazsa

Sayfa neyin yanlış gittiğini söyler. **View the Overleaf API docs** sizi `/devs` sayfasına götürür.

![invalid url mesajı ve View the Overleaf API docs düğmesi bulunan Open in Overleaf sayfası](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/open-in-overleaf-error.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=0fdd1309fab22f5aa1c80925377627c7)

Örneğin kullanamadığı bir bağlantı

| Mesaj | Neden | Ne yapmalı |
| - | - | - |
| `no snippet, snip_uri or zip_uri provided` | Bağlantıda bunlardan hiçbiri yok | Parametre adlarını kontrol edin |
| `invalid url: ...` | Adres HTTP veya HTTPS ile başlamıyor | HTTP veya HTTPS adresi ya da data URL kullanın |
| `could not download ... (HTTP 404)` | Dosya o adreste değil | Adresi kontrol edin |
| `could not download ... (HTTP 403)` | Adres özel bir ağda | Dosyayı örneğinizin erişebileceği bir yerde barındırın |
| `zip_uri did not resolve to a zip archive` | `zip_uri` arkasındaki dosya bir zip dosyası değil | Dosyayı kontrol edin |
| `invalid base64 data url` | Data URL bozuk | Dosyayı yeniden kodlayın ve bağlantıyı URL kodlayın |


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