Studio

scribe studio            # http://127.0.0.1:3600
scribe studio --port 4000

Lo studio è uno strumento di sviluppo locale (HTML renderizzato lato server, nessuna fase di build o autenticazione) che legge il tuo albero di lavoro in tempo reale. Le modifiche ai file spettano agli agenti e agli esseri umani, mentre lo studio è il luogo in cui si osserva e si verifica tutto ciò che Scribe gestisce. Puoi esplorare le collezioni, ispezionare i record con relazioni risolte e anteprime degli asset, individuare immagini errate o mancanti e capire "dove viene usato" un elemento prima di modificarlo. Include inoltre l'attuale dashboard di traduzione (copertura, lista di lavoro, snapshot dei singoli documenti; vedi traduzione).

Esplorazione delle collezioni

Su /types/:typeId, la barra laterale elenca ogni tipo di contenuto indicando il numero di record e un badge riepilogativo per le eventuali anomalie. La tabella dei record mostra ogni slug, una selezione di campi chiave basata sullo schema (con enum e relazioni sotto forma di chip), indicatori di stato per le traduzioni e badge di validazione per singolo elemento.

I filtri dei campi derivano dall'introspezione dello schema e risiedono nei parametri di query (rendendo gli URL condivisibili e renderizzati lato server). I campi enum e le relazioni diventano menu a discesa (quest'ultimo con gli slug di destinazione), i valori booleani si trasformano in interruttori, mentre per le stringhe si applica una ricerca per contenuto.

Qualsiasi tipo con almeno un campo asset permette di trasformare la tabella in una galleria di schede. Ogni scheda mostra l'immagine dell'asset principale, lo slug, i campi chiave e i badge. I filtri si applicano in modo del tutto identico. È il pannello di controllo ideale per il controllo qualità delle immagini generate.

Ispettore dei record

/types/:typeId/:enSlug mostra i campi in base al tipo identificato dall'introspezione:

• translatable: il valore affiancato da un selettore di lingua (dati provenienti dallo store). Il ripiego sull'inglese viene indicato chiaramente quando manca la traduzione.
• structural: il valore in chiaro.
• relation: un link cliccabile verso il record di destinazione (le dipendenze orfane mostrano un badge rosso).
• asset: un'anteprima dell'immagine con URL risolto, peso e dimensioni (i file mancanti sono segnalati da un badge rosso).
• Used by: una sezione di referenze incrociate che elenca tutti i record (di ogni tipo) le cui relazioni puntano a questo elemento.
• Body: un interruttore Raw / Preview (?body=preview). La modalità Preview formatta correttamente Markdown e GFM, mostrando i componenti JSX sconosciuti come riquadri etichettati con le rispettive prop. I token delle relazioni diventano link cliccabili (con chiara indicazione di quelli interrotti) e i token degli asset sono visualizzati come immagini reali. Per i tipi indicizzabili è disponibile anche un link "view on site".

I tasti freccia permettono di spostarsi tra i record. ArrowLeft e ArrowRight passano rispettivamente al record precedente e successivo (all'interno dello stesso tipo) seguendo l'ordine predefinito della collezione, senza ricominciare dall'inizio una volta raggiunta la fine. Questa navigazione mantiene attivi la lingua selezionata e i parametri di visualizzazione del corpo. Tali scorciatoie vengono ignorate se il cursore si trova in un campo di input.

Esplorazione degli asset

/assets espone una griglia di miniature per ciascuna directory radice gestita. Ogni asset mostra l'anteprima, il percorso, il peso, le dimensioni e una lista referenced by, aggiornata in tempo reale in memoria, con tutti i record e i campi che lo richiamano. Degli appositi badge segnalano gli elementi non referenziati (potenziali orfani), quelli mancanti ma ancora richiamati, quelli troppo pesanti (oltre il limite di maxKB) o con un formato diverso dal previsto. Consulta assets per approfondire il sistema dei campi sottostante.

Ricerca globale

/search?q= esegue una ricerca per sottostringa (senza distinzione tra maiuscole e minuscole) all'interno degli slug inglesi, in tutti i valori del frontmatter e nei corpi MDX grezzi. Troverai un modulo di ricerca in ogni pagina. I risultati vengono raggruppati per tipo assieme a un frammento di testo evidenziato, con un limite di 20 riscontri per categoria.

Eliminazione dei record

La barra degli strumenti dell'ispettore include un pulsante Delete in stile pericolo. Cliccandolo si apre una pagina di conferma che illustra l'intero piano di eliminazione diviso in sezioni (rimozioni a cascata, scollamenti, asset coinvolti, conteggi delle traduzioni per lingua e potenziali impedimenti) seguita da un pulsante di conferma rosso. Se il piano è bloccato, vedrai solo gli avvisi e nessun pulsante di conferma. Dare il via libera significa eseguire il piano alla lettera: verranno cancellati il file sorgente, i suoi asset, le traduzioni memorizzate, gli snapshot ed eventuali riscritture derivate dagli scollamenti. Nient'altro. L'impostazione onTargetDelete di una relazione (restrict, detach o cascade) e la modalità onDelete di un asset stabiliscono il comportamento del piano. Lo stesso piano è accessibile da riga di comando usando scribe delete. Questa è l'unica funzione distruttiva dello studio e rimane utilizzabile esclusivamente su localhost.

Cosa non fa lo studio

Nessuna modifica dei contenuti, avvio automatico di traduzioni, caricamento di immagini, autenticazione o vero e proprio rendering dei componenti MDX. Il lavoro di stesura e modifica resta affidato al tuo editor di testo e a git. Lo studio serve unicamente per la revisione.