Verificado
Escolher entre o Slim e a CLI
A questão da fonte da verdade que decide em que caminho de escrita começar e como passar de um para o outro.
A melhor forma de escolher é perguntar quem é dono da fonte da verdade: uma página ou um projeto.
Escolha o Slim quando
- a página é pequena ou incorporada
- o HTML é a superfície de escrita natural
- a árvore de runtime é gerada diretamente
- quer um ponto de entrada leve
- está a criar documentação, demonstrações ou uma superfície de marketing interativa
Escolha a CLI quando
- está a criar uma aplicação completa a partir de ficheiros-fonte
- quer uma estrutura de projeto canónica
- as unidades de lógica, como
get_data,set_data,batch,apiealert, devem ficar em pastas dedicadas - as tabelas, as rotas e os agentes de IA precisam de recursos explícitos
- quer que a sincronização e os documentos de runtime gerados sejam tratados por si
Um caminho prático de migração
Muitas equipas começam no Slim e passam para a CLI mais tarde, e esse caminho funciona porque os conceitos
do runtime não mudam por baixo: as expressões de campos continuam a usar @field_name, os programas continuam a compilar
para o mesmo modelo de documento, e as tags estruturais e os painéis continuam a ser importantes. Nada do que aprender no
modo Slim se desperdiça quando um projeto o ultrapassa.
Uma regra simples
Se a página parece um documento ou um widget incorporado, comece pelo Slim. Se o projeto parece uma aplicação, comece pela CLI.
Erros do primeiro dia a evitar
prog_iderrado. Se não corresponder a um programa que o Slim consiga encontrar, carrega a coisa errada ou nada é apresentado.- Esperar um modelo mental diferente. O Slim é mais leve para começar, mas segue sempre os conceitos de runtime do Xuda.
- Assumir que a conversão automática de HTML funciona fora de
<template>. O caminho automático verificado de HTML paraprogUié orientado por templates; apoie-se em tags<template id="...">para essa conversão. - Valores de atributos tipo JSON mal formados. Um atributo que parece um objeto ou array mas não é JSON válido continua a ser uma string simples em vez de se tornar dados estruturados.
- Escolher trabalho de CLI e chamar-lhe trabalho de Slim. Se o projeto precisa de rotas, de uma estrutura de aplicação maior e de uma organização de código-fonte duradoura, a CLI é o melhor ponto de partida.