> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-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 तथा tối ưu hóa 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 kiểm soát 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`: 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.
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 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 tạo hì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 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`.
Để thực hiện việc 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
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 rằng dự á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 thông tin 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, có thể chỉnh sửa thông tin chi tiết của mẫu hoặc xóa mẫu thông qua trang Thư viện Mẫu. Người dùng có thể quản lý các mẫu của riêng họ; quản trị viên có thể quản lý bất kỳ mẫu nào.
Đây là một ví dụ:
{% code overflow="wrap" expandable="true" %}
```dotenv
#################
# TEMPLATES #
#################
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=Mẫu để gửi bài cho các tạp chí học thuật, bao gồm các định dạng dành cho các nhà xuất bản lớn và máy chủ bản thảo sơ bộ.
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 để sử 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=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 đầu sách và lập chỉ mục.
TEMPLATE_CALENDAR_NAME=Lịch
TEMPLATE_CALENDAR_DESCRIPTION=Mẫu để tạo lịch năm, tháng hoặc tuần. Hữu ích cho kế hoạch cá nhân hoặc lên lịch sự kiện.
TEMPLATE_CV_NAME=CV và sơ yếu lý lịch
TEMPLATE_CV_DESCRIPTION=Mẫu CV và sơ yếu lý lịch với nhiều định dạng 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=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=Mẫu cho bài tập về nhà, bài tập môn học và bộ bài toán. Được thiết kế rõ ràng, có cấu trúc tốt cho học sinh, sinh viên và nhà giáo dục.
TEMPLATE_NEWSLETTER_NAME=Bản tin
TEMPLATE_NEWSLETTER_DESCRIPTION=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=Mẫu cho áp phích khoa học và học thuật, thường được dùng tại hội nghị và trong các bài thuyết trình nghiên cứu.
TEMPLATE_PRESENTATION_NAME=Bài thuyết trình
TEMPLATE_PRESENTATION_DESCRIPTION=Mẫu cho Beamer và các định dạng trình bày khác, được thiết kế 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=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, bảng và tài liệu tham khảo.
TEMPLATE_THESIS_NAME=Luận văn
TEMPLATE_THESIS_DESCRIPTION=Mẫu để viết luận văn và luận án, tuân theo các hướng dẫn định dạng và trích dẫn của tổ chức.
TEMPLATE_ALL_NAME=Tất cả mẫu
TEMPLATE_ALL_DESCRIPTION=Duyệt bộ sưu tập tất cả các mẫu LaTeX có sẵn, được phân loại theo loại tài liệu, kiểu dáng và mục đích.
```
{% endcode %}
### Chuyển mẫu từ overleaf.com
Do Overleaf Pro được thiết kế để hoạt động ngoại tuyến, không có cách tự động để tích hợp [overleaf.com](https://www.overleaf.com/) các mẫu thư viện vào bản cài đặt tại chỗ của bạn, tuy nhiên bạn có thể thực hiện thủ công cho từng mẫu.
Theo mặc định, Overleaf Pro được cấu hình để sử dụng phiên bản sơ đồ cơ bản của TeXLive để biên dịch. Phiên bản cơ bản này nhẹ và chỉ chứa một tập hợp rất hạn chế các gói LaTeX, điều này rất có thể sẽ dẫn đến lỗi thiếu gói cho người dùng của bạn khi cố sử dụng các mẫu từ [overleaf.com](https://www.overleaf.com/) trên phiên bản cục bộ tại chỗ 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 bị thiếu, chúng tôi có một cài đặt 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 vào 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 nghị 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 của bạn quyền truy cập vào cùng môi trường TeX Live như môi trường trên [overleaf.com](https://www.overleaf.com/). Các ảnh này chứa những gói và phông chữ phổ biến nhất, đồng thời đã đượ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ề việc 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 như đặt phiên bản ảnh TeX Live mặc định cho các dự án mới, trong [Thay đổi ảnh 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ều hướng đến [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ản gửi ví dụ](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
2. Nhấp vào nút **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 nút **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 nút **Chọn tệp .zip** và chọn tệp zip mẫu đã tải xuống
Sau đó, người dùng có thể sử dụng mẫu mới tải lên này trong tài khoản của riêng họ hoặc, với vai trò người dùng quản lý mẫu, bạn có thể xuất bản mẫu đó để 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 nhanh 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 vẫn 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).
Tại sao đối với một số dự án, 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 hình thu nhỏ cho PDF để chúng có thể hiển thị trong thông tin chi tiết của mẫu.
Thời gian tạo hì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 chiều rộng ở mức trung bình.
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 hình thu nhỏ có thể mất 40 giây hoặc lâu hơn, vui lòng kiên nhẫn. Đây là ví dụ về một áp phích lớn; thời gian sẽ lâu 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://overleaf-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.