Oficiální šablony
Restorm udržuje sadu oficiálních šablon, které můžete používat přímo z knihovny šablon. Můžete také vyjít z jedné z nich, forknout ji a přizpůsobit svým konvencím.
Oficiální katalog
Section titled “Oficiální katalog”Oficiální šablony jsou publikovány pod GitHub organizací
Monsieur-Dev:
| Šablona | Cíl | Repozitář |
|---|---|---|
| Server REST · TypeScript | REST · TypeScript · Express | restorm-template-server-rest-typescript |
| Server REST · .NET | REST · C# · ASP.NET Core | restorm-template-server-rest-dotnet |
| Server gRPC · TypeScript | gRPC · TypeScript | restorm-template-server-grpc-typescript |
| Server gRPC · .NET | gRPC · C# / .NET | restorm-template-server-grpc-dotnet |
| Databáze PostgreSQL | SQL · PostgreSQL | restorm-template-db-postgres |
Vzdálené šablony jsou získávány jako archiv (nikdy klonovány přes git), s bezpečnostními pojistkami a omezenou velikostí.
Šablony organizace (Enterprise)
Section titled “Šablony organizace (Enterprise)”Organizace s předplatným Enterprise disponují soukromým katalogem šablon, sdíleným mezi členy organizace. Objevují se v knihovně pod záložkou Šablony <organizace>, vedle oficiálních.
- Kdo je může přidávat nebo odebírat: administrátor organizace nebo člen, kterému admin udělil oprávnění spravovat šablony.
- Jak: ze záložky Šablony <organizace> knihovny (tlačítko Přidat — URL repozitáře a popis) nebo z administrátorského panelu organizace.
- Co to je: šablona organizace je prostý ukazatel na git repozitář (jako oficiální); její struktura je totožná s tou popsanou níže, ale její viditelnost je omezena na členy organizace.
Edice Community a Pro vidí oficiální šablony a mohou používat vlastní šablony (Repozitář nebo Lokální složka) — generování kódu je zdarma ve všech edicích. Sdílené šablony organizace jsou naopak vyhrazeny edici Enterprise.
Struktura vlastní šablony
Section titled “Struktura vlastní šablony”Šablona Restorm je šablona Cookiecutter/Copier obohacená o manifest:
restorm-template.json— v kořeni repozitáře (povinný). Popisuje šablonu a deklaruje proměnné, které konzumuje (viz Proměnné generování). Rovněž oznamuje verzi kontextu, kterou podporuje: šablona, která nedeklaruje verzi kompatibilní s aplikací, je odmítnuta.copier.yml(nebocopier.yaml) — konfigurace Copier, která deklaruje zejména otázky kladené při generování.- Soubory šablony, se sufixem
.jinja, vykreslené s kontextem návrhu.
Chcete-li použít vlastní šablonu, zvolte v knihovně zdroj Repozitář
(vlastník/název na GitHubu) nebo Lokální složka (během jejího vývoje).