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

# Templates Koleksiyonu

`templates`, şablon galerisindeki her şablon için bir belge tutar. Bir şablonun dosyaları (proje zip'i ve PDF) burada değildir: filestore'da `template/<_id>/v/<version>/` altında tutulur. Koleksiyon `template-gallery` web modülüne aittir (`services/web/modules/template-gallery`). Şema, `services/web/modules/template-gallery/app/src/models/Template.mjs` içindeki `Template` Mongoose modelidir; mantık `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` ve yanındaki `TemplateGalleryHelper.mjs` içindedir.

#### Alanlar

| Alan | Tür | Anlam | Kaynak |
| - | - | - | - |
| `_id` | ObjectId | Mongoose tarafından ayarlanır. Aynı zamanda şablon dosyalarının filestore'daki klasörüdür. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | Başlık. Zorunlu, en fazla 150 karakter. Yayınlama bir şablonu adına göre arar, düzenleme ise başka bir şablonun kullandığı adı reddeder; bu sayede adlar indeks olmadan benzersiz kalır. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | Kategori bağlantısı `/templates/<key>`; burada `<key>`, `OVERLEAF_TEMPLATE_CATEGORIES` değerlerinden biri veya `all` olur. Zorunlu. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | Girildiği haliyle açıklama, Markdown biçiminde. En fazla 4096 karakter. Galeri tarafından aranır. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | `descriptionMD` alanından oluşturulup temizlenmiş HTML. `descriptionMD` her ayarlandığında ayarlanır. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | Girildiği haliyle yazar, Markdown biçiminde. En fazla 512 karakter. Galeri tarafından aranır. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | `authorMD` alanından oluşturulan HTML, yalnızca bağlantılar. `authorMD` her ayarlandığında ayarlanır. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | Formda seçilen lisans metni. Zorunlu, en fazla 512 karakter. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | Kaynak projenin kök doc'unun yolu, baştaki eğik çizgi olmadan. Zorunlu: kök doc'u olmayan bir proje yayınlanamaz. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | Kaynak projenin derleyicisi. Zorunlu. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | Kaynak projenin TeX Live imajı. Şablon sayfası yalnızca son kısmını gösterir. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | Kaynak projenin yazım denetimi dili. Düzenleme formunda değiştirilebilir. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | 1'den başlar ve şablon aynı adla her yeniden yayınlandığında bir artar. Her sürümün dosyaları `v/<version>/` altındadır. Zorunlu. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | Şablonu ilk yayınlayan kullanıcı. Üzerine yeniden yayınlamak sahibi korur. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | En son yayınlandığı proje. Her yayınlamada güncellenir. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | En son ne zaman yayınlandığı veya düzenlendiği. Zorunlu, varsayılan şimdi. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | Mongoose sürüm anahtarı. Şema bunu kapatmaz. | Mongoose varsayılanı |

#### Kim yazar

| Kod | Ne yapar |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Projenin ayarlarını kopyalar (`TemplateGalleryHelper.mjs:94-134`), zip'i ve PDF'i filestore'a yükler ve kaydeder. Ad alınmışsa, istemci üzerine yazmayı istemedikçe çakışma ile yanıt verir: istediğinde o şablonu günceller ve `version` değerini artırır, ardından önceki sürümün dosyalarını siler. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Gönderilen alanları belgeye atar, `description` ve `author` alanlarını yeniden oluşturur ve `lastUpdated` değerini ayarlar. Düzenleme formu `name`, `license`, `category`, `language`, `authorMD` ve `descriptionMD` arasından değişen alanları gönderir (`services/web/modules/template-gallery/frontend/js/pages/template/util/api.ts:22-29`). |
| `TemplateGalleryHelper.mjs:186-222` (`deleteTemplateAssets`) | `DELETE /template/:template_id/delete` belgeyi ve belirtilen sürümün dosyalarını siler (`TemplateGalleryManager.mjs:49-51`). |

Bu üç rotayı yalnızca site yöneticileri ve `OVERLEAF_TEMPLATES_USER_ID` içindeki kullanıcı çağırabilir (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Kim okur

| Kod | Ne yapar |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Şablon sayfası ve `GET /api/template` için (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`) `_id` veya `name` ile tek bir şablon bulur. `project_id` artık var olmayan bir projeyi gösteriyorsa yanıt onu dışarıda bırakır; belge değiştirilmez. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates`: bir kategorinin bir sayfası; `name`, `authorMD` ve `descriptionMD` içinde aranır, `lastUpdated` veya `name` (büyük/küçük harfe duyarsız) ile sıralanır. |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Çakışma mesajında sahibi adlandırmak için `owner` alanını okur. |

#### İndeksler

| Ad | Anahtarlar | Seçenekler | Migration |
| - | - | - | - |
| `_id_` | `_id: 1` | | varsayılan |

Mongoose `autoIndex` kapalıdır (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (benzersiz `project_id`, `user_id`, `name`) `server-pro` ve `saas` etiketlidir; bu yüzden yalnızca `server-ce` migration'larını çalıştıran CE'de çalışmaz (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Notlar

* Upstream `templates` koleksiyonunu eskimiş bir koleksiyon olarak görür ve kendi sitesinde kaldırır (`tools/migrations/20241002180623_drop_unused_collections.mjs`, `saas` etiketli). Ayakaleaf Pro'da şablon galerisi modülü onu kullanır.
* Ada göre sıralama büyük/küçük harfe duyarsız bir harmanlama kullanır ve `TemplateGalleryManager.mjs:186-188` konumundaki yorum, bir `name` indeksinin de aynısına ihtiyaç duyacağını belirtir. CE'de `name` indeksi yoktur, bu yüzden Mongo bellekte sıralar.
* Kaynak projeyi veya sahibi silmek şablonu silmez.


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