Preskočiť na obsah
Overené

Výber medzi Slim a CLI

Otázka o zdroji pravdy, ktorá rozhoduje, ktorou cestou tvorby začať, a ako medzi nimi prechádzať.

Najlepší spôsob výberu je opýtať sa, kto vlastní zdroj pravdy: stránka, alebo projekt.

Vyberte Slim, keď

  • stránka je malá alebo vložená
  • HTML je prirodzený povrch na tvorbu
  • strom runtime sa generuje priamo
  • chcete odľahčený vstupný bod
  • vytvárate dokumentáciu, ukážky alebo interaktívny marketingový povrch

Vyberte CLI, keď

  • vytvárate plnohodnotnú aplikáciu zo zdrojových súborov
  • chcete kanonický tvar projektu
  • jednotky logiky ako get_data, set_data, batch, api a alert majú žiť vo vyhradených priečinkoch
  • tabuľky, trasy a AI agenti potrebujú explicitné zdroje
  • synchronizáciu a vygenerované runtime dokumenty má riešiť nástroj za vás

Praktická cesta migrácie

Mnohé tímy začínajú v Slim a neskôr prejdú na CLI a táto cesta funguje, pretože sa pod povrchom nemenia koncepty runtime: výrazy polí stále používajú @field_name, programy sa stále kompilujú do rovnakého modelu dokumentov a štrukturálne tagy a panely stále záležia. Nič, čo sa naučíte v režime Slim, nepríde nazmar, keď z neho projekt vyrastie.

Jednoduché pravidlo

Ak stránka pripomína dokument alebo vložený widget, začnite so Slim. Ak projekt pripomína aplikáciu, začnite s CLI.

Chyby prvého dňa, ktorým sa treba vyhnúť

  • Nesprávne prog_id. Ak sa nezhoduje s programom, ktorý Slim nájde, načíta sa nesprávna vec alebo sa nevykreslí nič.
  • Očakávanie iného mentálneho modelu. Slim sa štartuje ľahšie, ale po celý čas sa stále riadi konceptmi runtime Xuda.
  • Predpoklad, že automatická konverzia HTML funguje mimo <template>. Overená automatická cesta HTML do progUi je riadená šablónami; na túto konverziu sa spoľahnite na tagy <template id="...">.
  • Chybne zostavené hodnoty atribútov podobné JSON. Atribút, ktorý vyzerá ako objekt alebo pole, ale nie je platný JSON, zostane obyčajným reťazcom namiesto štruktúrovaných dát.
  • Voliť prácu pre CLI a nazývať ju prácou pre Slim. Ak projekt chce smerovanie, väčšiu štruktúru aplikácie a dlhodobú organizáciu zdrojov, je lepším východiskom CLI.