Il pannello Problemi analizza il progetto alla ricerca di problemi facili da trascurare mentre si scrive — soprattutto link e immagini che puntano a qualcosa che non esiste più. È un pannello ancorato nella parte inferiore della finestra, che condivide quell’area con il Terminale e il pannello Trova.
Aprire il pannello Problemi
Fai clic sull’icona Problemi nella barra delle attività all’estrema sinistra per mostrare o nascondere il pannello. Alla prima apertura, viene mostrata una scheda Controlla riferimenti per avviare un’analisi.
Controlla riferimenti
Controlla riferimenti analizza ogni file Markdown del progetto e segnala i riferimenti che non è possibile risolvere. Rileva:
- File non trovato — un link o un’immagine punta a un file che non esiste (ad esempio, un file rinominato o eliminato)
- Intestazione non trovata — un link
#anchorpunta a un’intestazione non presente nel documento di destinazione - URL esterno irraggiungibile — facoltativamente, un link esterno che restituisce un errore, mostrato con il relativo stato HTTP
Avvia un’analisi dalla scheda Controlla riferimenti oppure da Strumenti > Controlla riferimenti nel menu. Durante l’analisi, il pannello mostra l’avanzamento; al termine, i risultati compaiono raggruppati per file.
Leggere i risultati
Ogni file che contiene un problema diventa un gruppo nell’albero e, espandendolo, vengono elencati tutti i riferimenti non validi presenti in quel file. Ogni voce mostra:
- Il numero di riga in cui compare il riferimento
- Il testo del riferimento così com’è scritto nel documento
- Un breve motivo — “file non trovato”, “intestazione … non trovata” oppure lo stato HTTP per un URL irraggiungibile
Fai clic su una voce per aprire il file e passare direttamente alla riga, così da poterla correggere. Dopo aver apportato le modifiche, usa Rianalizza per eseguire di nuovo il controllo e verificare che il problema sia stato risolto.
Quando usarlo
Eseguire Controlla riferimenti è particolarmente utile prima di pubblicare o condividere un documento, dopo una serie di rinomine o riorganizzazioni di file, oppure quando hai spostato contenuti tra documenti. Integra la notifica di link non valido che ricevi in linea quando fai clic su un link che non si risolve — il pannello Problemi individua tutti i problemi di questo tipo nell’intero progetto in un’unica passata, anziché uno alla volta.