Perché l’OCR normale rovina il codice
Il riconoscimento del testo generico è pensato per la prosa. Tratta gli spazi a inizio riga come rumore, unisce le righe che sembrano appartenere allo stesso paragrafo e riporta le virgolette così come le vede. Per un paragrafo va benissimo, ma il codice ne esce a pezzi: Python smette di funzionare quando perde l’indentazione, un file YAML cambia significato e una sola virgoletta curva copiata da una slide trasforma una stringa in un errore di sintassi.
La modalità Codice legge l’immagine in un altro modo:
- Indentazione e spaziatura restano, riga per riga, così i blocchi annidati restano annidati.
- Le virgolette curve vengono raddrizzate:
“hello”e‘a’tornano"hello"e'a'. - Il linguaggio viene indicato quando è riconosciuto, per esempio «Sembra uno screenshot di codice Python»: un segnale rapido che la modalità è quella giusta.
Se scarichi un file Markdown, il codice è racchiuso in un blocco di codice delimitato, pronto da inserire in un README, in una pagina wiki o nei tuoi appunti.
Temi scuri e sintassi colorata
Ormai quasi tutti gli editor e i terminali usano temi scuri, mentre i motori OCR leggono meglio il testo scuro su sfondo chiaro. Il Miglioramento automatico riconosce il testo chiaro su sfondo scuro e lo inverte prima della lettura, quindi gli screenshot in modalità scura non richiedono nessuna preparazione da parte tua.
Anche la sintassi colorata di solito non crea problemi. I punti deboli sono le parti di un tema con poco contrasto: commenti grigi su sfondo grigio scuro o i segni tenui che indicano gli spazi. Se escono confusi, prova la scala di grigi e un po’ più di contrasto, poi passa alla vista ripulita per controllare di non aver perso nulla.
Caratteri da ricontrollare
In molti font per programmatori alcuni caratteri sono quasi identici, e uno screenshot piccolo peggiora le cose. I soliti sospetti:
- 0 e O, soprattutto nei nomi di variabile e nei valori esadecimali
- 1, l e I, che in certi font differiscono di un solo pixel
- Parentesi:
{e(,]e), più le parentesi angolari dei generics e dei tag HTML - Punteggiatura:
;e:,,e., e un backtick letto come apice dritto - Lettere attaccate:
rnletto comem, oclletto comed - Trattini bassi che spariscono o diventano spazi in nomi come
user_id
I font con le legature disegnano !=, => o >= come simboli unici, che potrebbero non essere riletti come i caratteri che hai digitato. Se lo screenshot viene dal tuo editor, disattiva le legature prima di catturarlo.
Il controllo più rapido è incollare il codice in un editor con un linter o un compilatore: parentesi spaiate e caratteri estranei saltano fuori in pochi secondi.
Verificare l’indentazione in Python e YAML
Nei linguaggi in cui l’indentazione ha un significato, una riga spostata di un livello può funzionare lo stesso, ma fare un’altra cosa. Un linter non sempre se ne accorge, quindi confronta l’annidamento con lo screenshot per ogni blocco importante, come il corpo di un ciclo o una chiave annidata in un file di configurazione.
Fai clic su una riga del risultato e il punto corrispondente si illumina sull’immagine: così controlli in un attimo dove cominciava davvero una riga. Se un intero blocco è spostato, di solito fai prima a correggerlo nell’editor indentando tutto il blocco insieme, invece che una riga alla volta.
Fare uno screenshot più pulito
Spesso ottieni un risultato migliore rifacendo lo screenshot che correggendo i caratteri a mano dopo:
- Ingrandisci prima di catturare. Un testo più grande ha più pixel per carattere, e questo aiuta soprattutto con la punteggiatura.
- Cattura solo il codice. Lascia fuori barre laterali, schede e minimappa, così alle tue righe non si mescola nient’altro.
- Disattiva il ritorno a capo automatico. Una riga lunga che l’editor manda a capo su due righe viene letta come due righe.
- Attenzione a tabulazioni e spazi. Un’immagine non può mostrare quali usava l’originale: se il tuo progetto usa le tabulazioni, lancia il formatter dopo aver incollato.
Per gli screenshot in generale, comprese chat e finestre di errore, le basi sono in screenshot in testo e nella guida su come estrarre il testo da uno screenshot. Se il codice fa parte di una pagina di documentazione più ampia, immagine in Markdown spiega come dividere testo e codice in screenshot separati.