--- order: 8 section: features title: Studio description: >- Uno studio locale per sfogliare i contenuti, effettuare ricerche in tutti i documenti, visualizzare in anteprima i corpi in MDX, ispezionare le traduzioni ed eliminare le voci in modo sicuro. noindex: false canonicalPath: /it/docs/studio --- ```bash 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](/docs/translation)). ## 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](/docs/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`](/docs/cli#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.