Șabloane oficiale

Restorm întreține un set de șabloane oficiale pe care le puteți utiliza direct din biblioteca de șabloane. Puteți de asemenea porni de la unul dintre ele, îl puteți forka și adapta la convențiile dumneavoastră.

Catalogul oficial

Șabloanele oficiale sunt publicate sub organizația GitHub Monsieur-Dev:

Șablon	Țintă	Depozit
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
Bază PostgreSQL	SQL · PostgreSQL	restorm-template-db-postgres

Șabloanele la distanță sunt recuperate ca o arhivă (niciodată clonate în git), cu măsuri de protecție de securitate și o dimensiune plafonată.

Șabloane de organizație (Enterprise)

Organizațiile cu un abonament Enterprise dispun de un catalog de șabloane privat, partajat între membrii organizației. Ele apar în bibliotecă sub fila Șabloane <organizație>, alături de cele oficiale.

• Cine le poate adăuga sau retrage: un administrator al organizației, sau un membru căruia adminul i-a acordat dreptul a gestiona șabloanele.
• Cum: din fila Șabloane <organizație> a bibliotecii (butonul Adăugați — URL-ul depozitului și o descriere), sau din panoul de administrare al organizației.
• Ce este: un șablon de organizație este un simplu pointer către un depozit git (ca unul oficial); structura sa este identică cu cea descrisă mai jos, dar vizibilitatea sa este restrânsă la membrii organizației.

Edițiile Community și Pro văd șabloanele oficiale și pot utiliza propriile șabloane (Depozit sau Dosar local) — generarea de cod este liberă în toate edițiile. Șabloanele de organizație partajate sunt, în schimb, rezervate ediției Enterprise.

Structura unui șablon personalizat

Un șablon Restorm este un șablon Cookiecutter/Copier îmbogățit cu un manifest:

• restorm-template.json — la rădăcina depozitului (obligatoriu). Descrie șablonul și declară variabilele pe care le consumă (vedeți Variabile de generare). Anunță de asemenea versiunea de context pe care o suportă: un șablon care nu declară o versiune compatibilă cu aplicația este refuzat.
• copier.yml (sau copier.yaml) — configurația Copier, care declară în special întrebările puse la generare.
• Fișierele șablonului, cu sufixul .jinja, randate cu contextul designului.

Pentru a utiliza un șablon personalizat, alegeți sursa Depozit (proprietar/nume pe GitHub) sau Dosar local (în timp ce îl dezvoltați) în bibliotecă.

Note

Doriți să propuneți un șablon comunității? Regulile de contribuție ale șabloanelor oficiale sunt documentate în depozitul aplicației Restorm (docs/contributing).