> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/vi/cau-hinh/overleaf-toolkit/templates.md).
# Mẫu
{% hint style="info" %}
Tính năng này ban đầu được phát triển bởi [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), và được chỉnh sửa và tối ưu bởi [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}
{% columns %}
{% column %}
{% endcolumn %}
{% column %}
{% endcolumn %}
{% endcolumns %}
### Cấu hình
Tính năng Thư viện Mẫu được điều khiển bằng các biến môi trường sau:
* `OVERLEAF_TEMPLATE_GALLERY`: Đặt thành `true` để bật Thư viện Mẫu.
* `OVERLEAF_TEMPLATE_CATEGORIES`: Một danh sách tùy chọn gồm không hoặc nhiều khóa danh mục mẫu, được phân tách bằng khoảng trắng. Các khóa hợp lệ bao gồm:
* *`academic-journal`*
* *`book`*
* *`presentation`*
* *`poster`*
* *`cv`*
* *`homework`*
* *`bibliography`*
* *`calendar`*
* *`formal-letter`*
* *`report`*
* *`thesis`*
* *`newsletter`*
Khóa đặc biệt *`all`* được tự động thêm vào. Khóa này đại diện cho một danh mục bao gồm tất cả các mẫu.
Đối với mỗi khóa danh mục, có thể đặt các biến môi trường tùy chọn sau:
* `TEMPLATE__NAME`: Tên hiển thị của danh mục mẫu.
* `TEMPLATE__DESCRIPTION`: Mô tả ngắn về danh mục.
Nếu khóa danh mục chứa dấu gạch nối (`-`), hãy thay nó bằng dấu gạch dưới (`_`) trong tên biến môi trường.
* `ENABLE_CONVERSIONS`: Phải được đặt thành `true` để bật việc tạo ảnh thu nhỏ và bản xem trước cho các mẫu.
### Quyền xuất bản
Quản trị viên có thể xuất bản các mẫu. Bạn cũng có thể chỉ định một người dùng không phải quản trị viên để quản lý các mẫu được tuyển chọn hiển thị trong thư viện cục bộ của bạn tại `/templates`.
Để làm điều này, bạn cần đặt biến môi trường `OVERLEAF_TEMPLATES_USER_ID` trong `toolkit/config/variables.env` thành `ID` của người dùng sẽ chịu trách nhiệm quản lý mẫu trong phiên bản của bạn, ví dụ:
```dotenv
OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959
```
### Xuất bản mẫu
Đối với mỗi mẫu bạn muốn tải lên:
1. Tạo một dự án chứa mã nguồn của mẫu và đảm bảo nó biên dịch được.
2. Trong menu bên trái của trình soạn thảo, chọn **Xuất bản dưới dạng mẫu**.
3. Trong biểu mẫu xuất hiện, nhập chi tiết của mẫu:
* Trường *Tiêu đề* phải là duy nhất.
* Trường *Mô tả* hỗ trợ định dạng Markdown.
* Trường *Tác giả* chấp nhận các liên kết được định dạng bằng Markdown.
Sau khi gửi, chi tiết mẫu có thể được chỉnh sửa, hoặc mẫu có thể bị xóa qua trang Thư viện Mẫu. Người dùng có thể quản lý các mẫu của chính họ; quản trị viên có thể quản lý bất kỳ mẫu nào.
Dưới đây là một ví dụ:
{% code overflow="wrap" expandable="true" %}
```dotenv
#################
# MẪU #
#################
ENABLE_CONVERSIONS=true
OVERLEAF_TEMPLATE_GALLERY=true
OVERLEAF_TEMPLATE_CATEGORIES=academic-journal book presentation poster cv homework bibliography calendar formal-letter report thesis newsletter
TEMPLATE_ACADEMIC_JOURNAL_NAME=Bài báo tạp chí
TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=Các mẫu cho bài nộp tạp chí học thuật, bao gồm các định dạng cho các nhà xuất bản lớn và máy chủ bản in trước.
TEMPLATE_BIBLIOGRAPHY_NAME=Tài liệu tham khảo
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Các kiểu để tạo và quản lý tài liệu tham khảo bằng BibTeX hoặc BibLaTeX. Phù hợp để dùng trong bài báo học thuật, luận văn và báo cáo.
TEMPLATE_BOOK_NAME=Sách
TEMPLATE_BOOK_DESCRIPTION=Các mẫu để viết sách hoặc tài liệu dài, bao gồm cấu trúc chương, phần mở đầu và chỉ mục.
TEMPLATE_CALENDAR_NAME=Lịch
TEMPLATE_CALENDAR_DESCRIPTION=Các mẫu để tạo lịch năm, tháng hoặc tuần. Hữu ích cho sổ kế hoạch cá nhân hoặc lập lịch sự kiện.
TEMPLATE_CV_NAME=CV và sơ yếu lý lịch
TEMPLATE_CV_DESCRIPTION=Các mẫu cho CV và sơ yếu lý lịch với nhiều định dạng dành cho các vị trí học thuật, công nghiệp và sáng tạo.
TEMPLATE_FORMAL_LETTER_NAME=Thư trang trọng
TEMPLATE_FORMAL_LETTER_DESCRIPTION=Các mẫu cho thư chuyên nghiệp, chẳng hạn như thư xin việc, thư giới thiệu và thư từ chính thức.
TEMPLATE_HOMEWORK_NAME=Bài tập
TEMPLATE_HOMEWORK_DESCRIPTION=Các mẫu cho bài tập về nhà, bài tập môn học và bộ bài tập. Được thiết kế gọn gàng và có cấu trúc tốt cho học sinh và giáo viên.
TEMPLATE_NEWSLETTER_NAME=Bản tin
TEMPLATE_NEWSLETTER_DESCRIPTION=Các mẫu để tạo bản tin với các định dạng cho truyền thông học thuật, doanh nghiệp hoặc cộng đồng.
TEMPLATE_POSTER_NAME=Áp phích
TEMPLATE_POSTER_DESCRIPTION=Các mẫu cho áp phích khoa học và học thuật, thường được dùng trong hội nghị và các buổi thuyết trình nghiên cứu.
TEMPLATE_PRESENTATION_NAME=Bài thuyết trình
TEMPLATE_PRESENTATION_DESCRIPTION=Các mẫu cho Beamer và các định dạng thuyết trình khác, được điều chỉnh cho các bài nói chuyện và bài giảng học thuật.
TEMPLATE_REPORT_NAME=Báo cáo
TEMPLATE_REPORT_DESCRIPTION=Các mẫu cho báo cáo kỹ thuật, phòng thí nghiệm hoặc dự án. Bao gồm các phần dành cho hình ảnh, bảng và tài liệu tham khảo.
TEMPLATE_THESIS_NAME=Luận văn
TEMPLATE_THESIS_DESCRIPTION=Các mẫu để viết luận văn và luận án, tuân theo các hướng dẫn về định dạng và trích dẫn của cơ sở.
TEMPLATE_ALL_NAME=Tất cả các mẫu
TEMPLATE_ALL_DESCRIPTION=Duyệt bộ sưu tập tất cả các mẫu LaTeX hiện có, được phân loại theo loại tài liệu, phong cách và mục đích.
```
{% endcode %}
### Chuyển mẫu từ overleaf.com
Vì Overleaf Pro được kiến trúc để hoạt động ngoại tuyến, nên không có cách tự động để tích hợp [overleaf.com](https://www.overleaf.com/) các mẫu trong thư viện vào bản cài đặt tại chỗ của bạn, tuy nhiên vẫn có thể thực hiện thủ công theo từng mẫu.
Theo mặc định, Overleaf Pro được cấu hình để sử dụng phiên bản lược đồ cơ bản của TeX Live cho việc biên dịch. Phiên bản cơ bản này rất nhẹ và chỉ chứa một tập con rất hạn chế của các gói LaTeX, điều này rất có thể sẽ dẫn đến lỗi thiếu gói đối với người dùng của bạn khi cố gắng sử dụng các mẫu từ [overleaf.com](https://www.overleaf.com/) trên phiên bản tại chỗ cục bộ của bạn.
Rất tiếc, mặc dù không có cách tự động để cài đặt các gói còn thiếu, chúng tôi có một thiết lập có thể cấu hình trong Server Pro, cho phép người dùng của bạn biên dịch dự án với quyền truy cập nhiều gói hơn và theo cách an toàn hơn. Tính năng này được gọi là [Biên dịch trong hộp cát](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) (còn được gọi là Sibling Containers).
Để đảm bảo các mẫu đã tải xuống tương thích với phiên bản Server Pro tại chỗ của bạn, chúng tôi đặc biệt khuyên bạn bật [Biên dịch trong hộp cát](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) vì tính năng này sẽ cung cấp cho người dùng quyền truy cập vào cùng môi trường TeX Live như trên [overleaf.com](https://www.overleaf.com/). Các image này chứa những gói và phông chữ phổ biến nhất và đã được kiểm thử với các mẫu trong thư viện của chúng tôi.
Bạn có thể tìm thêm thông tin về cách cấu hình các phiên bản TeX Live mà người dùng có thể chọn trong dự án của họ, cùng với việc đặt phiên bản image TeX Live mặc định cho các dự án mới, trong [Thay đổi image TeX Live](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#changing-the-tex-live-image) phần trong tài liệu của chúng tôi.
1. Đi tới [Thư viện Mẫu](https://www.overleaf.com/latex/templates) trên [overleaf.com](https://www.overleaf.com/) và tìm mẫu cần thiết, ví dụ [Mẫu bài báo IEEE Photonics Journal - Bài nộp ví dụ](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
2. Nhấp vào **Mở dưới dạng mẫu** nút
3. Nhấp vào menu dự án và chọn **Tải xuống mã nguồn**
4. Tiếp theo, đăng nhập vào tài khoản Server Pro tại chỗ
5. Nhấp vào **Dự án mới** từ bảng điều khiển dự án và chọn **Tải lên dự án**
6. Nhấp vào **Chọn một tệp .zip** nút và chọn tệp zip mẫu đã tải xuống
Sau đó, người dùng có thể sử dụng mẫu vừa tải lên này trong tài khoản của họ, hoặc với tư cách là người dùng mẫu, bạn có thể xuất bản nó để những người dùng khác sử dụng.
### Hỏi & Đáp
Tôi có thể xóa dự án sau khi xuất bản mẫu tương ứng không?
**Trả lời:** Có, nhưng chúng tôi không khuyến nghị làm vậy. Khi bạn xuất bản một mẫu, chúng tôi chụp một ảnh chụp nhanh của dự án và lưu dự án dưới dạng tệp zip tại thời điểm xuất bản. Điều này đảm bảo rằng ngay cả khi bạn xóa dự án tương ứng với mẫu, mẫu đó cũng không bị ảnh hưởng.
Tuy nhiên, chúng tôi cũng sẽ ghi lại ProjectID liên kết với mẫu này, giúp bạn dễ dàng cập nhật mẫu trong tương lai.
Nếu bạn xóa dự án tương ứng, bạn sẽ không thấy nút "Admin: Source Project" trên trang chi tiết mẫu (xem hình bên dưới).
Đối với một số dự án, tại sao việc phát hành một mẫu lại mất nhiều thời gian như vậy?
**Trả lời:** Khi bạn xuất bản mẫu, chúng tôi lưu dự án dưới dạng tệp zip và tệp pdf, việc này thường nhanh. Tuy nhiên, chúng tôi cũng cần tạo ảnh thu nhỏ cho PDF để chúng có thể được hiển thị trong chi tiết mẫu.
Thời gian tạo ảnh thu nhỏ thường phụ thuộc vào nội dung của trang đầu tiên trong PDF của bạn. Để cân bằng giữa chất lượng hiển thị và thời gian chuyển đổi, chúng tôi chọn mức trung bình làm chiều rộng.
Tuy nhiên, nếu trang đầu tiên của PDF chứa nhiều văn bản, việc chuyển đổi ảnh thu nhỏ có thể mất 40 giây hoặc thậm chí lâu hơn, vui lòng kiên nhẫn. Đây là một ví dụ về áp phích lớn, sẽ mất nhiều thời gian hơn.
Một áp phích lớn
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ayakaleaf-pro.ayaka.space/on-premises/vi/cau-hinh/overleaf-toolkit/templates.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.