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

`templates` indeholder ét dokument pr. skabelon i skabelongalleriet. Filerne til en skabelon (projektets zip og PDF'en) ligger ikke her: de opbevares i filestore under `template/<_id>/v/<version>/`. Samlingen hører til webmodulet `template-gallery` (`services/web/modules/template-gallery`). Skemaet er Mongoose-modellen `Template` i `services/web/modules/template-gallery/app/src/models/Template.mjs`; logikken ligger i `services/web/modules/template-gallery/app/src/TemplateGalleryManager.mjs` og `TemplateGalleryHelper.mjs` ved siden af.

#### Felter

| Felt | Type | Betydning | Kilde |
| - | - | - | - |
| `_id` | ObjectId | Sættes af Mongoose. Det er også mappen til skabelonens filer i filestore. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | Titlen. Påkrævet, højst 150 tegn. Udgivelse slår en skabelon op efter navn, og redigering afviser et navn, som en anden skabelon har, så navnene forbliver unikke uden indeks. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | Kategorilinket, `/templates/<key>`, hvor `<key>` er én af `OVERLEAF_TEMPLATE_CATEGORIES` eller `all`. Påkrævet. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | Beskrivelsen, som den blev skrevet, i Markdown. Højst 4096 tegn. Galleriet søger i den. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | HTML gengivet ud fra `descriptionMD` og renset. Sættes, hver gang `descriptionMD` sættes. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | Forfatteren, som den blev skrevet, i Markdown. Højst 512 tegn. Galleriet søger i den. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | HTML gengivet ud fra `authorMD`, kun links. Sættes, hver gang `authorMD` sættes. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | Licensteksten, der er valgt i formularen. Påkrævet, højst 512 tegn. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | Stien til kildeprojektets rod-doc uden indledende skråstreg. Påkrævet: et projekt uden rod-doc kan ikke udgives. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | Kildeprojektets compiler. Påkrævet. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | Kildeprojektets TeX Live-image. Skabelonsiden viser kun den sidste del af det. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | Kildeprojektets sprog til stavekontrol. Kan ændres i redigeringsformularen. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | Starter på 1 og stiger med én, hver gang skabelonen udgives igen under samme navn. Filerne for hver version ligger under `v/<version>/`. Påkrævet. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | Brugeren, der først udgav skabelonen. At udgive igen oven på den bevarer ejeren. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | Projektet, den senest blev udgivet fra. Opdateres ved hver udgivelse. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | Hvornår den senest blev udgivet eller redigeret. Påkrævet, standard nu. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | Mongoose-versionsnøglen. Skemaet slår den ikke fra. | Mongoose-standard |

#### Hvem skriver

| Kode | Hvad den gør |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Kopierer projektets indstillinger (`TemplateGalleryHelper.mjs:94-134`), uploader zip-filen og PDF'en til filestore og gemmer. Hvis navnet er optaget, svarer den med en konflikt, medmindre klienten bad om at overskrive: så opdaterer den skabelonen, øger dens `version` og sletter derefter filerne for den forrige version. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Tildeler de indsendte felter til dokumentet, gengiver `description` og `author` igen og sætter `lastUpdated`. Redigeringsformularen sender de ændrede felter blandt `name`, `license`, `category`, `language`, `authorMD` og `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` sletter dokumentet og filerne for den angivne version (`TemplateGalleryManager.mjs:49-51`). |

Kun webstedsadministratorer og brugeren i `OVERLEAF_TEMPLATES_USER_ID` må kalde disse tre ruter (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Hvem læser

| Kode | Hvad den gør |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Finder én skabelon via `_id` eller `name` til skabelonsiden og til `GET /api/template` (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). Hvis `project_id` peger på et projekt, der ikke længere findes, udelader svaret det; dokumentet ændres ikke. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates`: én side i en kategori, søgt i `name`, `authorMD` og `descriptionMD`, sorteret efter `lastUpdated` eller efter `name` (uden forskel på store og små bogstaver). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Læser `owner` for at navngive ejeren i konfliktmeddelelsen. |

#### Indekser

| Navn | Nøgler | Indstillinger | Migrering |
| - | - | - | - |
| `_id_` | `_id: 1` | | standard |

Mongoose `autoIndex` er slået fra (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (unikke `project_id`, `user_id`, `name`) er mærket `server-pro` og `saas`, så den kører ikke i CE, som kun kører `server-ce`-migreringerne (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Bemærkninger

* Upstream behandler `templates` som en forældet samling og fjerner den på sit eget websted (`tools/migrations/20241002180623_drop_unused_collections.mjs`, mærket `saas`). I Ayakaleaf Pro bruger skabelongallerimodulet den.
* Sortering efter navn bruger en sorteringsrækkefølge uden forskel på store og små bogstaver, og kommentaren ved `TemplateGalleryManager.mjs:186-188` bemærker, at et `name`-indeks ville have brug for den samme. CE har intet `name`-indeks, så Mongo sorterer i hukommelsen.
* At slette kildeprojektet eller ejeren sletter ikke skabelonen.


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