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

# Collection Templates

`templates` lưu một tài liệu cho mỗi mẫu trong thư viện mẫu. Các tệp của một mẫu (tệp zip của dự án và PDF) không nằm ở đây: chúng được giữ trong filestore dưới `template/<_id>/v/<version>/`. Collection thuộc module web `template-gallery` (`services/web/modules/template-gallery`). Schema là model Mongoose `Template` trong `services/web/modules/template-gallery/app/src/models/Template.mjs`; logic nằm trong `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` và `TemplateGalleryHelper.mjs` bên cạnh.

#### Các trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Do Mongoose đặt. Đây cũng là thư mục chứa các tệp của mẫu trong filestore. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | Tiêu đề. Bắt buộc, tối đa 150 ký tự. Việc xuất bản tra cứu mẫu theo tên, và việc chỉnh sửa từ chối tên mà mẫu khác đã dùng, nên tên vẫn là duy nhất mà không cần chỉ mục. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | Liên kết danh mục, `/templates/<key>`, trong đó `<key>` là một trong các giá trị của `OVERLEAF_TEMPLATE_CATEGORIES` hoặc `all`. Bắt buộc. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | Mô tả như đã nhập, ở dạng Markdown. Tối đa 4096 ký tự. Được thư viện tìm kiếm. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | HTML được kết xuất từ `descriptionMD` và làm sạch. Được đặt mỗi khi `descriptionMD` được đặt. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | Tác giả như đã nhập, ở dạng Markdown. Tối đa 512 ký tự. Được thư viện tìm kiếm. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | HTML được kết xuất từ `authorMD`, chỉ gồm liên kết. Được đặt mỗi khi `authorMD` được đặt. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | Văn bản giấy phép được chọn trong biểu mẫu. Bắt buộc, tối đa 512 ký tự. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | Đường dẫn của doc gốc trong dự án nguồn, không có dấu gạch chéo ở đầu. Bắt buộc: dự án không có doc gốc thì không thể xuất bản. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | Trình biên dịch của dự án nguồn. Bắt buộc. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | Image TeX Live của dự án nguồn. Trang mẫu chỉ hiển thị phần cuối của nó. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | Ngôn ngữ kiểm tra chính tả của dự án nguồn. Có thể thay đổi trong biểu mẫu chỉnh sửa. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | Bắt đầu từ 1 và tăng thêm một mỗi khi mẫu được xuất bản lại với cùng tên. Tệp của mỗi phiên bản nằm dưới `v/<version>/`. Bắt buộc. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | Người dùng đã xuất bản mẫu đầu tiên. Xuất bản lại đè lên vẫn giữ chủ sở hữu. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | Dự án mà mẫu được xuất bản lần gần nhất. Được cập nhật mỗi lần xuất bản. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | Thời điểm được xuất bản hoặc chỉnh sửa gần nhất. Bắt buộc, mặc định là hiện tại. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | Khóa phiên bản của Mongoose. Schema không tắt nó. | Mặc định của Mongoose |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Sao chép cài đặt của dự án (`TemplateGalleryHelper.mjs:94-134`), tải tệp zip và PDF lên filestore rồi lưu. Nếu tên đã được dùng, nó trả về xung đột, trừ khi client yêu cầu ghi đè: khi đó nó cập nhật mẫu đó, tăng `version`, rồi xóa các tệp của phiên bản trước. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Gán các trường được gửi vào tài liệu, kết xuất lại `description` và `author`, và đặt `lastUpdated`. Biểu mẫu chỉnh sửa gửi các trường đã thay đổi trong số `name`, `license`, `category`, `language`, `authorMD` và `descriptionMD` (`services/web/modules/template-gallery/frontend/js/pages/template/util/api.ts:22-29`). |
| `TemplateGalleryHelper.mjs:186-222` (`deleteTemplateAssets`) | `DELETE /template/:template_id/delete` xóa tài liệu và các tệp của phiên bản được chỉ định (`TemplateGalleryManager.mjs:49-51`). |

Chỉ quản trị viên trang và người dùng trong `OVERLEAF_TEMPLATES_USER_ID` mới được gọi ba route này (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Tìm một mẫu theo `_id` hoặc `name` cho trang mẫu và cho `GET /api/template` (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). Nếu `project_id` trỏ đến một dự án không còn tồn tại, phản hồi sẽ bỏ nó đi; tài liệu không bị thay đổi. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates`: một trang của một danh mục, tìm kiếm trong `name`, `authorMD` và `descriptionMD`, sắp xếp theo `lastUpdated` hoặc theo `name` (không phân biệt hoa thường). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Đọc `owner` để nêu tên chủ sở hữu trong thông báo xung đột. |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `_id_` | `_id: 1` | | mặc định |

`autoIndex` của Mongoose bị tắt (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (`project_id`, `user_id`, `name` duy nhất) được gắn thẻ `server-pro` và `saas`, nên nó không chạy trong CE, vốn chỉ chạy các migration `server-ce` (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Ghi chú

* Upstream coi `templates` là một collection lỗi thời và xóa nó trên trang của mình (`tools/migrations/20241002180623_drop_unused_collections.mjs`, gắn thẻ `saas`). Trong Ayakaleaf Pro, module thư viện mẫu sử dụng nó.
* Sắp xếp theo tên dùng một collation không phân biệt hoa thường, và chú thích tại `TemplateGalleryManager.mjs:186-188` lưu ý rằng một chỉ mục `name` cũng sẽ cần collation tương tự. CE không có chỉ mục `name`, nên Mongo sắp xếp trong bộ nhớ.
* Xóa dự án nguồn hoặc chủ sở hữu không xóa mẫu.


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