Lewati ke konten

Generasi kode

Dari bagian Kode, Restorm menghasilkan kode aplikasi Anda dari desain Anda. Generasi bertumpu pada template yang kompatibel dengan Cookiecutter/Copier: milik Anda, atau yang disediakan Restorm.

Bagian Kode: sebuah template yang ditambahkan, sebuah folder keluaran, dan pratinjau pohon berkas yang dihasilkan sebelum penulisan

  1. Tambahkan satu atau beberapa template — melalui pustaka template.
  2. Pilih sebuah folder keluaran (absolut, atau relatif terhadap proyek).
  3. Klik Hasilkan proyek.

Generasi dirender dalam sebuah sandbox lalu diproduksi dalam bentuk pratinjau: Restorm menunjukkan kepada Anda pohon berkas yang dihasilkan dan tidak menulis apa pun selama Anda belum mengonfirmasi. Anda kemudian dapat Tulis ke folder keluaran atau Batalkan. (Generasi diblokir selama masih ada masalah validasi.)

Sebuah template dapat mendeklarasikan pertanyaan (dalam arti Copier — misalnya sebuah project_slug), yang Anda jawab pada saat menghasilkan. Jawaban Anda disimpan dalam sebuah berkas .copier-answers.yml di akar keluaran, dan dimuat ulang pada generasi berikutnya.

Generasi tidak bersifat satu arah. Menghasilkan ulang berperan seperti sebuah copier update: Restorm mengingat sebuah basis dan melakukan penggabungan tiga arah antara keluaran template yang baru dan modifikasi lokal Anda — perubahan Anda karena itu tidak ditimpa. Anda mengembangkan desain Anda (atau template-nya), Anda menghasilkan ulang, dan kodenya diperbarui sambil menjaga pekerjaan Anda.

Pustaka template menawarkan empat sumber:

  • Resmi — template yang dipelihara oleh Restorm, terlihat oleh semua.
  • Organisasi — template yang dibagikan di dalam organisasi Anda, bersifat privat bagi anggotanya. Ini adalah fitur Enterprise: seorang admin — atau anggota yang memiliki hak mengelola template — menambah atau menghapusnya (URL repositori + deskripsi), dari tab Template <organisasi> pustaka atau dari dasbor administrasi. Lihat Template resmi dan organisasi.
  • Repositori — sebuah repositori GitHub pemilik/nama (biasanya sebuah fork dari template resmi yang telah Anda sesuaikan).
  • Folder lokal — sebuah template yang sedang dikembangkan, tanpa jaringan.

Struktur sebuah template dan katalog resmi dijelaskan di halaman Template resmi. Apa yang diterima sebuah template dari desain Anda (model, rute, dan penandanya) dirinci dalam Konteks template, dan pengaturan khusus template dalam Variabel generasi.