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

> Thêm vào trang web của bạn một liên kết mở một tệp LaTeX hoặc cả một dự án trong phiên bản của bạn.

Đặt một liên kết trên trang web, blog hoặc trang khóa học của bạn. Bất kỳ ai nhấp vào đó đều nhận được một dự án mới của riêng họ với các tệp của bạn. Bạn không cần thiết lập gì.

Khách truy cập cần có tài khoản trên phiên bản của bạn. Khách chưa đăng nhập sẽ được chuyển tới trang đăng nhập trước, và dự án mở ra sau khi đăng nhập.

Các trang của tính năng này dùng tên Overleaf. Liên kết hoặc nút của bạn có thể ghi bất cứ nội dung gì, chẳng hạn **Open in Ayakaleaf**.

## Xem các ví dụ

Mở `/devs` trên trang của bạn, ví dụ `https://ayakaleaf.example.com/devs`. Không có menu nào liên kết tới trang này, vì vậy hãy tự nhập địa chỉ. Theo mặc định, bạn phải đăng nhập để xem trang.

![Trang Overleaf API với các nút A LaTeX code snippet và A zipped project](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/open-in-overleaf-devs.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=e0769b26bc5206799501cf44c0cf2c46)

Trang Overleaf API

Nhấp **A LaTeX code snippet** hoặc **A zipped project**. Một dự án mới mở ra với ví dụ đó.

![Dự án I am a Zip file với main.tex, main2.tex và sample.bib, cùng PDF của nó](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)

Dự án từ ví dụ nén

## Liên kết tới một tệp trên trang web của bạn

**1. Tạo liên kết**

Đặt địa chỉ của tệp, đã mã hóa URL, sau `/docs?snip_uri=`:

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

Với dự án dạng nén, dùng `zip_uri`:

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

Phiên bản của bạn sẽ tải tệp xuống, vì vậy tệp phải truy cập được qua HTTP hoặc HTTPS. Địa chỉ trong mạng riêng sẽ bị từ chối, xem [External URL](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/external-url.md).

**2. Thêm vào trang của bạn**

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

**3. Nhấp vào liên kết**

Dự án mới mở trong trình soạn thảo, với một tệp duy nhất được lưu là `main.tex`.

![Dự án Hello from a link trong trình soạn thảo, với main.tex và PDF của nó](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/open-in-overleaf-project.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=870760e85a1053dc1730663a74c48744)

Một dự án mở từ liên kết

Mỗi lần nhấp sẽ tạo thêm một dự án. Dự án là một bản sao, vì vậy các thay đổi sau này đối với tệp của bạn không được cập nhật vào đó.

## Đưa tệp vào liên kết

Với tệp nhỏ, bạn không cần lưu trữ gì: hãy đưa nội dung tệp vào liên kết dưới dạng data URL Base64. Trong JavaScript:

```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` chỉ nhận ký tự Latin-1, vì vậy hãy mã hóa văn bản khác sang UTF-8 trước. Với dự án dạng nén, dùng `zip_uri` và `data:application/zip;base64,`.

Liên kết dài hơn khoảng 8 KB sẽ bị từ chối với lỗi **414 Request-URI Too Large**. Với nội dung lớn hơn, hãy lưu trữ tệp hoặc dùng [biểu mẫu](#use-a-button-instead-of-a-link).

## Chọn các tùy chọn

Thêm các tham số này vào liên kết, hoặc vào biểu mẫu dưới dạng trường ẩn:

| Tham số | Tác dụng | Ví dụ |
| - | - | - |
| `name` | Đặt tên dự án. Nếu không có, dự án nén lấy tên trong `\title` của nó, còn mọi trường hợp khác có tên `Open in Overleaf project`. | `name=My%20notes` |
| `engine` | Đặt trình biên dịch: `latex_dvipdf`, `pdflatex`, `xelatex` hoặc `lualatex`. | `engine=xelatex` |
| `main_document` | Đặt tệp `.tex` chính, được mở đầu tiên. | `main_document=thesis.tex` |
| `snip_uri[]`, `snip_name[]` | Nhập nhiều tệp, mỗi tệp có tên riêng, theo cùng thứ tự. | `snip_uri[]=.../a.tex&snip_name[]=a.tex` |

Tệp `.tex` không có `\documentclass` sẽ được bọc trong một tài liệu tiêu chuẩn, nên biên dịch được ngay:

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

## Dùng nút thay cho liên kết

Biểu mẫu gửi cùng các tham số như liên kết:

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

Để gửi trực tiếp mã LaTeX, dùng `snip` cho văn bản thuần hoặc `encoded_snip` cho văn bản đã qua `encodeURIComponent`.

Biểu mẫu không phải lúc nào cũng hoạt động, vì vậy liên kết là lựa chọn tốt hơn, trừ khi tệp của bạn quá dài để đưa vào liên kết:

| Biểu mẫu nằm ở đâu | Khách đã đăng nhập | Khách chưa đăng nhập |
| - | - | - |
| Cùng tên miền với phiên bản của bạn, hoặc tên miền con | Dự án mở ra | Trang đăng nhập, không có dự án |
| Trên tên miền khác | Trang đăng nhập, không có dự án | Trang đăng nhập, không có dự án |

Nếu quản trị viên đặt `OVERLEAF_ALLOW_PUBLIC_ACCESS=true`, dự án sẽ mở trong tất cả các trường hợp này, sau khi đăng nhập nếu cần. Thiết lập đó cũng mở các trang khác cho khách chưa đăng nhập, xem [Page Access](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/authentication/public-access.md#page-access).

Để biết những gì khác quản trị viên có thể thiết lập, xem [Overleaf Import API](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/integrations/overleaf-import-api.md). Trang `/devs` có thêm ví dụ.

## Nếu dự án không mở

Trang sẽ cho biết điều gì đã xảy ra. **View the Overleaf API docs** đưa bạn tới `/devs`.

![Trang Open in Overleaf với thông báo invalid url và nút View the Overleaf API docs](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/open-in-overleaf-error.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=0fdd1309fab22f5aa1c80925377627c7)

Một liên kết mà phiên bản không thể dùng

| Thông báo | Lý do | Cách xử lý |
| - | - | - |
| `no snippet, snip_uri or zip_uri provided` | Liên kết không có tham số nào trong số này | Kiểm tra tên tham số |
| `invalid url: ...` | Địa chỉ không bắt đầu bằng HTTP hoặc HTTPS | Dùng địa chỉ HTTP hoặc HTTPS, hoặc data URL |
| `could not download ... (HTTP 404)` | Tệp không có ở địa chỉ đó | Kiểm tra địa chỉ |
| `could not download ... (HTTP 403)` | Địa chỉ nằm trong mạng riêng | Lưu trữ tệp ở nơi phiên bản của bạn được phép truy cập |
| `zip_uri did not resolve to a zip archive` | Tệp tại `zip_uri` không phải tệp zip | Kiểm tra tệp |
| `invalid base64 data url` | Data URL bị hỏng | Mã hóa lại tệp và mã hóa URL cho liên kết |


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