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

# Samlingen Templates

`templates` innehåller ett dokument per mall i mallgalleriet. En malls filer (projektets zip och PDF:en) finns inte här: de lagras i filestore under `template/<_id>/v/<version>/`. Samlingen tillhör webbmodulen `template-gallery` (`services/web/modules/template-gallery`). Schemat är Mongoose-modellen `Template` i `services/web/modules/template-gallery/app/src/models/Template.mjs`; logiken finns i `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` och `TemplateGalleryHelper.mjs` bredvid.

#### Fält

| Fält | Typ | Betydelse | Källa |
| - | - | - | - |
| `_id` | ObjectId | Sätts av Mongoose. Det är också mappen för mallens filer i filestore. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | Titeln. Obligatorisk, högst 150 tecken. Publicering slår upp en mall efter namn, och redigering nekar ett namn som en annan mall har, så namnen förblir unika utan index. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | Kategorilänken, `/templates/<key>`, där `<key>` är ett av `OVERLEAF_TEMPLATE_CATEGORIES` eller `all`. Obligatorisk. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | Beskrivningen som den skrevs, i Markdown. Högst 4096 tecken. Söks av galleriet. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | HTML renderad från `descriptionMD` och rensad. Sätts varje gång `descriptionMD` sätts. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | Författaren som den skrevs, i Markdown. Högst 512 tecken. Söks av galleriet. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | HTML renderad från `authorMD`, bara länkar. Sätts varje gång `authorMD` sätts. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | Licenstexten som valts i formuläret. Obligatorisk, högst 512 tecken. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | Sökvägen till källprojektets rot-doc, utan inledande snedstreck. Obligatorisk: ett projekt utan rot-doc kan inte publiceras. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | Källprojektets kompilator. Obligatorisk. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | Källprojektets TeX Live-image. Mallsidan visar bara den sista delen av den. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | Källprojektets språk för stavningskontroll. Kan ändras i redigeringsformuläret. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | Börjar på 1 och ökar med ett varje gång mallen publiceras igen under samma namn. Filerna för varje version ligger under `v/<version>/`. Obligatorisk. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | Användaren som först publicerade mallen. Att publicera igen ovanpå behåller ägaren. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | Projektet den senast publicerades från. Uppdateras vid varje publicering. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | När den senast publicerades eller redigerades. Obligatorisk, standard nu. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | Mongoose versionsnyckel. Schemat stänger inte av den. | Mongoose standard |

#### Vem skriver

| Kod | Vad den gör |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Kopierar projektets inställningar (`TemplateGalleryHelper.mjs:94-134`), laddar upp zip-filen och PDF:en till filestore och sparar. Om namnet är upptaget svarar den med en konflikt, om inte klienten bad om att skriva över: då uppdaterar den den mallen och höjer dess `version`, och raderar sedan filerna för föregående version. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Tilldelar de skickade fälten till dokumentet, renderar `description` och `author` igen och sätter `lastUpdated`. Redigeringsformuläret skickar de ändrade fälten bland `name`, `license`, `category`, `language`, `authorMD` och `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` raderar dokumentet och filerna för den angivna versionen (`TemplateGalleryManager.mjs:49-51`). |

Bara webbplatsadministratörer och användaren i `OVERLEAF_TEMPLATES_USER_ID` får anropa dessa tre rutter (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Vem läser

| Kod | Vad den gör |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Hittar en mall via `_id` eller `name` för mallsidan och för `GET /api/template` (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). Om `project_id` pekar på ett projekt som inte längre finns utelämnar svaret det; dokumentet ändras inte. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates`: en sida i en kategori, sökt i `name`, `authorMD` och `descriptionMD`, sorterad efter `lastUpdated` eller efter `name` (skiftlägesokänsligt). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Läser `owner` för att namnge ägaren i konfliktmeddelandet. |

#### Index

| Namn | Nycklar | Alternativ | Migrering |
| - | - | - | - |
| `_id_` | `_id: 1` | | standard |

Mongoose `autoIndex` är avstängt (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (unika `project_id`, `user_id`, `name`) är taggad med `server-pro` och `saas`, så den körs inte i CE, som bara kör `server-ce`-migreringarna (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Anteckningar

* Upstream behandlar `templates` som en inaktuell samling och tar bort den på sin egen webbplats (`tools/migrations/20241002180623_drop_unused_collections.mjs`, taggad `saas`). I Ayakaleaf Pro använder mallgallerimodulen den.
* Sortering efter namn använder en skiftlägesokänslig sorteringsordning, och kommentaren vid `TemplateGalleryManager.mjs:186-188` påpekar att ett `name`-index skulle behöva samma. CE har inget `name`-index, så Mongo sorterar i minnet.
* Att radera källprojektet eller ägaren raderar inte mallen.


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