build/serve/check/ecc. cercano docs/ (con fallback su src/) relativamente alla directory corrente, o a --projectRoot=<path> se specificato. Esegui il comando dalla cartella radice del progetto, oppure passa --projectRoot:

bxSites build --projectRoot=/percorso/ai/miei-docs

Esegui bxSites doctor per vedere esattamente quale chiave/riga ha rifiutato il config loader. Cause comuni: mescolare tab e spazi nell'indentazione YAML, una virgola in eccesso nel JSON, o una chiave che si aspetta un array (come nav o i18n.locales) scritta come semplice stringa. Vedi Configurazione per il riferimento completo delle chiavi.

build, serve e search-index richiedono tutti e quattro questi moduli BoxLang. Installare bx-sites stesso li installa automaticamente come dipendenze di box.json (install-bx-module bx-sites oppure box install bx-sites) - se vedi questo errore, o l'installazione non è andata a buon fine, o il modulo è stato registrato manualmente senza le sue dipendenze. Rieseguire box install dalla radice del progetto risolve tutto di nuovo; bxSites doctor conferma quale modulo (se presente) manca ancora.

Una cartella theme/ personalizzata deve fornire sia layout.bxm che page.bxm - doctor segnala quale manca. Vedi Temi per il contratto completo, oppure esegui bxSites theme:new per esportare un tema integrato come punto di partenza funzionante invece di scriverne uno da zero.

serve osserva docs/, il tuo bxsites.yaml/.json, e un override theme/ a livello di progetto - una modifica altrove (ad esempio modificare un file sotto resources/ in un checkout di un modulo, non un progetto reale) non attiva una ricostruzione. Se una modifica reale non viene comunque riflessa, ferma serve, esegui bxSites clean per svuotare qualsiasi cache di build obsoleta, e riavvia bxSites serve.

build non elimina l'output precedentemente costruito che non ha più una pagina sorgente corrispondente. Esegui bxSites clean prima di build per rimuovere completamente site/ e qualsiasi cache di build, poi ricostruisci da zero. Se uno step CI segnala successo ma il sito distribuito non lo riflette, controlla il log effettivo dello step di build cercando Error: - una build che va in crash può comunque restituire uno stato di successo fuorviante in alcune configurazioni CI.

È previsto, non un bug: una lingua non deve avere ogni pagina tradotta per essere utilizzabile. Una pagina mancante in docs/i18n/<codice>/ viene comunque costruita al suo URL previsto, mostrando il contenuto della lingua predefinita con un piccolo avviso in cima alla pagina. Vedi Internazionalizzazione (i18n).

i18n:status verifica solo la presenza della pagina per lingua, non la parità di contenuto per pagina - una copia in una lingua può esistere ma mancare comunque di una sezione aggiunta successivamente alla pagina della lingua predefinita. Confronta direttamente il file della lingua con la sua controparte nella lingua predefinita se sospetti questo.