Sari la conținut

Generarea de cod

Din secțiunea Cod, Restorm generează codul aplicației dumneavoastră pornind de la designul dumneavoastră. Generarea se bazează pe șabloane compatibile Cookiecutter/Copier: ale dumneavoastră, sau cele propuse de Restorm.

Secțiunea Cod: un șablon adăugat, un dosar de ieșire și previzualizarea arborelui generat înainte de scriere

  1. Adăugați unul sau mai multe șabloane — prin biblioteca de șabloane.
  2. Alegeți un dosar de ieșire (absolut, sau relativ la proiect).
  3. Faceți clic pe Generați proiectul.

Generarea este randată într-un sandbox apoi produsă sub formă de previzualizare: Restorm vă arată arborele fișierelor generate și nu scrie nimic atât timp cât nu ați confirmat. Puteți atunci Scrie în dosarul de ieșire sau Abandona. (Generarea este blocată atât timp cât rămân probleme de validare.)

Un șablon poate declara întrebări (în sensul Copier — de exemplu un project_slug), la care răspundeți în momentul generării. Răspunsurile sunt înregistrate într-un fișier .copier-answers.yml la rădăcina ieșirii, și reîncărcate la generarea următoare.

Generarea nu este într-un singur sens. Regenerarea joacă rolul unui copier update: Restorm memorează o bază și realizează o fuziune pe trei căi între noua ieșire a șablonului și modificările dumneavoastră locale — schimbările dumneavoastră nu sunt deci suprascrise. Faceți să evolueze designul (sau șablonul), regenerați, iar codul se actualizează păstrând munca dumneavoastră.

Biblioteca de șabloane propune patru surse:

  • Oficial — șabloanele întreținute de Restorm, vizibile pentru toți.
  • Organizație — șabloanele partajate în cadrul organizației dumneavoastră, private pentru membrii ei. Este o funcționalitate Enterprise: un admin — sau un membru care deține dreptul a gestiona șabloanele — le adaugă sau le retrage (URL-ul depozitului + descriere), din fila Șabloane <organizație> a bibliotecii sau din panoul de administrare. Vedeți Șabloane oficiale și de organizație.
  • Depozit — un depozit GitHub proprietar/nume (de obicei un fork al unui șablon oficial pe care l-ați adaptat).
  • Dosar local — un șablon în curs de dezvoltare, fără rețea.

Structura unui șablon și catalogul oficial sunt descrise în pagina Șabloane oficiale. Ceea ce un șablon primește de la designul dumneavoastră (modele, rute și flag-urile lor) este detaliat în Contextul șablonului, iar setările proprii șablonului în Variabile de generare.