> ## 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` inneholder ett dokument per mal i malgalleriet. Filene til en mal (prosjektets zip og PDF-en) ligger ikke her: de lagres i filestore under `template/<_id>/v/<version>/`. Samlingen tilhører webmodulen `template-gallery` (`services/web/modules/template-gallery`). Skjemaet 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 av.

#### Felter

| Felt | Type | Betydning | Kilde |
| - | - | - | - |
| `_id` | ObjectId | Settes av Mongoose. Det er også mappen for malens filer i filestore. | `TemplateGalleryHelper.mjs:148-150` |
| `name` | String | Tittelen. Påkrevd, høyst 150 tegn. Publisering slår opp en mal etter navn, og redigering avviser et navn som en annen mal har, så navnene forblir unike uten indeks. | `Template.mjs:7`, `TemplateGalleryHelper.mjs:50-52`, `TemplateGalleryManager.mjs:30-38,55` |
| `category` | String | Kategorilenken, `/templates/<key>`, der `<key>` er én av `OVERLEAF_TEMPLATE_CATEGORIES` eller `all`. Påkrevd. | `Template.mjs:8`, `services/web/modules/template-gallery/index.mjs:17-31`, `TemplateGalleryManager.mjs:206` |
| `descriptionMD` | String | Beskrivelsen slik den ble skrevet, i Markdown. Høyst 4096 tegn. Søkes i av galleriet. | `Template.mjs:10`, `TemplateGalleryHelper.mjs:53-55`, `TemplateGalleryManager.mjs:207-212` |
| `description` | String | HTML gjengitt fra `descriptionMD` og renset. Settes hver gang `descriptionMD` settes. | `Template.mjs:9`, `TemplateGalleryHelper.mjs:224-228` |
| `authorMD` | String | Forfatteren slik den ble skrevet, i Markdown. Høyst 512 tegn. Søkes i av galleriet. | `Template.mjs:12`, `TemplateGalleryHelper.mjs:56-58` |
| `author` | String | HTML gjengitt fra `authorMD`, bare lenker. Settes hver gang `authorMD` settes. | `Template.mjs:11`, `TemplateGalleryHelper.mjs:229-232` |
| `license` | String | Lisensteksten som er valgt i skjemaet. Påkrevd, høyst 512 tegn. | `Template.mjs:13`, `TemplateGalleryHelper.mjs:59-61` |
| `mainFile` | String | Stien til kildeprosjektets rot-doc, uten innledende skråstrek. Påkrevd: et prosjekt uten rot-doc kan ikke publiseres. | `Template.mjs:14`, `TemplateGalleryHelper.mjs:112-114` |
| `compiler` | String | Kildeprosjektets kompilator. Påkrevd. | `Template.mjs:15`, `TemplateGalleryHelper.mjs:122` |
| `imageName` | String | Kildeprosjektets TeX Live-image. Malsiden viser bare den siste delen av det. | `Template.mjs:16`, `TemplateGalleryHelper.mjs:123`, `TemplateGalleryManager.mjs:249-253` |
| `language` | String | Kildeprosjektets språk for stavekontroll. Kan endres i redigeringsskjemaet. | `Template.mjs:17`, `TemplateGalleryHelper.mjs:124` |
| `version` | Number | Starter på 1 og øker med én hver gang malen publiseres på nytt under samme navn. Filene for hver versjon ligger under `v/<version>/`. Påkrevd. | `Template.mjs:18`, `TemplateGalleryManager.mjs:74-79` |
| `owner` | ObjectId | Brukeren som først publiserte malen. Å publisere på nytt over den beholder eieren. | `Template.mjs:19`, `TemplateGalleryManager.mjs:70-79` |
| `project_id` | ObjectId | Prosjektet den sist ble publisert fra. Oppdateres ved hver publisering. | `Template.mjs:20`, `TemplateGalleryManager.mjs:81-84` |
| `lastUpdated` | Date | Når den sist ble publisert eller redigert. Påkrevd, standard nå. | `Template.mjs:21-27`, `TemplateGalleryHelper.mjs:125`, `TemplateGalleryManager.mjs:41` |
| `__v` | Number | Mongoose-versjonsnøkkelen. Skjemaet slår den ikke av. | Mongoose-standard |

#### Hvem skriver

| Kode | Hva den gjør |
| - | - |
| `TemplateGalleryManager.mjs:53-97` (`createTemplateFromProject`) | `POST /template/new/:Project_id`. Kopierer prosjektets innstillinger (`TemplateGalleryHelper.mjs:94-134`), laster opp zip-filen og PDF-en til filestore og lagrer. Hvis navnet er tatt, svarer den med en konflikt, med mindre klienten ba om å overskrive: da oppdaterer den malen og øker `version`, og sletter deretter filene for forrige versjon. |
| `TemplateGalleryManager.mjs:21-47` (`editTemplate`) | `POST /template/:template_id/edit`. Tilordner de innsendte feltene til dokumentet, gjengir `description` og `author` på nytt og setter `lastUpdated`. Redigeringsskjemaet sender de endrede feltene blant `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 filene for den angitte versjonen (`TemplateGalleryManager.mjs:49-51`). |

Bare nettstedsadministratorer og brukeren i `OVERLEAF_TEMPLATES_USER_ID` kan kalle disse tre rutene (`services/web/modules/template-gallery/app/src/Router.mjs:55-62,70-84`, `PermissionsMiddleware.mjs:8-19`).

#### Hvem leser

| Kode | Hva den gjør |
| - | - |
| `TemplateGalleryManager.mjs:158-183` (`getTemplate`) | Finner én mal via `_id` eller `name` for malsiden og for `GET /api/template` (`services/web/modules/template-gallery/app/src/TemplateGalleryController.mjs:210-232`). Hvis `project_id` peker på et prosjekt som ikke lenger finnes, utelater svaret det; dokumentet endres ikke. |
| `TemplateGalleryManager.mjs:190-236` (`getCategoryTemplates`) | `GET /api/templates`: én side i en kategori, søkt i `name`, `authorMD` og `descriptionMD`, sortert etter `lastUpdated` eller etter `name` (uten hensyn til store og små bokstaver). |
| `TemplateGalleryHelper.mjs:64-80` (`canUserOverrideTemplate`) | Leser `owner` for å navngi eieren i konfliktmeldingen. |

#### Indekser

| Navn | Nøkler | Alternativer | Migrering |
| - | - | - | - |
| `_id_` | `_id: 1` | | standard |

Mongoose `autoIndex` er slått av (`services/web/app/src/infrastructure/Mongoose.mjs:7`). `tools/migrations/20190912145030_create_templates_indexes.mjs` (unike `project_id`, `user_id`, `name`) er merket `server-pro` og `saas`, så den kjører ikke i CE, som bare kjører `server-ce`-migreringene (`server-ce/init_scripts/900_run_web_migrations.sh`).

#### Merknader

* Upstream behandler `templates` som en utdatert samling og fjerner den på sitt eget nettsted (`tools/migrations/20241002180623_drop_unused_collections.mjs`, merket `saas`). I Ayakaleaf Pro bruker malgallerimodulen den.
* Sortering etter navn bruker en sorteringsrekkefølge uten hensyn til store og små bokstaver, og kommentaren ved `TemplateGalleryManager.mjs:186-188` påpeker at en `name`-indeks ville trenge den samme. CE har ingen `name`-indeks, så Mongo sorterer i minnet.
* Å slette kildeprosjektet eller eieren sletter ikke malen.


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