Non tutti i documenti nascono in Word. Typst è diventato un modo rapido per scrivere articoli, lettere, curriculum e appunti delle lezioni senza lottare con LaTeX, e molti team tengono manuali, specifiche e procedure operative in AsciiDoc. Poi qualcuno chiede una copia firmata e scansionata, e sul computer che hai davanti c’è solo il file sorgente.

Look Scanned ora li apre entrambi. Usa Da Typst (.typ) a PDF scansionato per i file .typ e Da AsciiDoc (.adoc) a PDF scansionato per i file .adoc e .asciidoc. Il documento viene impaginato direttamente nel browser. Controlli le pagine nell’anteprima, aggiungi l’effetto scansione e scarichi un PDF che sembra passato da un vero scanner. Non serve installare Typst CLI, né Ruby, né Asciidoctor PDF, e non c’è nessun account a cui accedere.

Typst: il vero compilatore, nel tuo browser

Look Scanned esegue il compilatore ufficiale di Typst (Typst 0.14) in una versione pensata per il browser. È lo stesso compilatore che sta dietro a typst compile, quindi pagine, a capo, equazioni e tabelle escono come sul tuo computer, compresi il formato della pagina e i margini impostati dal documento.

  • La prima volta ci vuole un attimo. Il compilatore e i font di Typst, circa 20 MB in tutto, vengono scaricati da Look Scanned la prima volta. Poi arrivano dalla cache del browser, e i file Typst si aprono anche offline.
  • Un solo file, niente pacchetti. Si compilano solo documenti autosufficienti. Una riga #import "@preview/…" non funziona, perché non c’è un registro di pacchetti da cui scaricare. Lo stesso vale per tutto ciò che legge un altro file: un’immagine inserita con #image, un capitolo incluso con #include o dati caricati da un file CSV o JSON.
  • Solo i font predefiniti di Typst. Il testo viene composto con i font forniti con Typst: Libertinus Serif, New Computer Modern con il relativo font matematico e DejaVu Sans Mono per il codice. I font installati sul tuo computer non sono disponibili, quindi un altro font indicato nel documento viene sostituito con questi. Coprono gli alfabeti latino (vietnamita compreso), greco, cirillico ed ebraico. Per il testo in cinese, giapponese e coreano non c’è nessun font di ripiego, e anche scritture come arabo, thailandese o devanagari non sono supportate come si deve, quindi controlla l’anteprima se il tuo documento le usa.
  • Il sorgente deve compilare. Se Typst segnala un errore, al posto delle pagine compare un messaggio di errore.

Dato che Typst genera un vero PDF prima che venga applicato l’effetto scansione, il suo testo può essere conservato. Quando salvi in PDF, attiva «Conserva il testo originale (simile all’OCR)» nelle Impostazioni di output: il testo del PDF scansionato resterà ricercabile e copiabile.

AsciiDoc: Asciidoctor senza Ruby

I file AsciiDoc vengono convertiti da Asciidoctor, il processore di riferimento per AsciiDoc, nella sua versione JavaScript che gira nel browser. Il risultato viene impaginato su pagine A4 con margini di un pollice, e questo è ciò che viene riportato:

  • L’intestazione del documento: titolo, autore e riga della revisione, più l’indice quando il documento imposta :toc:.
  • Sezioni, elenchi, tabelle, note a piè di pagina, citazioni e richiami nel codice (callout). I blocchi di avviso (admonition) mostrano la loro etichetta, come Note o Warning, come testo anziché come icona.
  • Le formule STEM, composte con un vero font matematico quando il documento imposta :stem:. Funzionano sia la notazione AsciiMath sia quella LaTeX, nel testo e in blocchi.
  • I listati di codice colorati secondo la sintassi quando il documento imposta :source-highlighter:, qualunque sia l’evidenziatore indicato. Senza questo attributo i listati restano senza colori, come altrove.
  • Tabelle e listati lunghi proseguono nella pagina successiva, e una riga di tabella non viene mai tagliata a metà.

Alcune cose invece non passano:

  • include:: non viene seguito. Ogni direttiva include appare come un link al suo percorso, al posto del contenuto incluso. Unisci prima le parti in un unico file.
  • Le immagini richiedono un indirizzo web completo. Un’immagine indicata con un percorso relativo come images/diagram.png non si trova, perché il file viene aperto da solo, senza la sua cartella. Un’immagine con un indirizzo https:// completo viene caricata dal sito che la ospita, e serve una connessione a internet.
  • I diagrammi restano codice. Asciidoctor Diagram non è disponibile, quindi un blocco PlantUML o Mermaid appare come il testo che hai scritto.
  • I font sono quelli del tuo dispositivo. Il testo viene composto con i font installati sul tuo computer o telefono, quindi su un’altra macchina lo stesso file può cambiare pagina in punti diversi.
  • I file molto lunghi possono andare oltre il tempo limite. L’impaginazione deve finire entro circa 30 secondi, quindi dividi un documento lungo quanto un libro in file più piccoli.
  • I file .asc non sono accettati. Quell’estensione di solito indica chiavi e firme PGP. Rinomina il file AsciiDoc in .adoc prima di aprirlo.

Come trasformare un file .typ o .adoc in un PDF scansionato

  1. Apri Da Typst (.typ) a PDF scansionato o Da AsciiDoc (.adoc) a PDF scansionato e seleziona il tuo file.
  2. Attendi qualche istante mentre le pagine vengono preparate, poi scorri l’anteprima pagina per pagina. Controlla titoli, equazioni, tabelle e codice.
  3. Regola l’effetto scansione. Tieni bassi sfocatura e rumore se il documento ha caratteri piccoli o formule fitte.
  4. Fai clic su «Genera PDF scansionato», poi su «Scarica PDF scansionato».

Se preferisci le immagini, puoi esportare ogni pagina in JPG o PNG. La nostra guida a PDF, JPG e PNG spiega quando conviene ciascun formato. Con Pro, la scansione in blocco elabora più file .typ o .adoc alla volta.

Il tuo file resta sul tuo dispositivo

Entrambi i formati vengono convertiti e scansionati nel browser, e il file sorgente non viene mai caricato su un server. Per Typst, gli unici download sono il compilatore e i suoi font, dal sito di Look Scanned stesso; pacchetti e altri file non vengono mai scaricati. Per AsciiDoc, l’unica eccezione è un’immagine con un indirizzo https:// completo, che viene scaricata dal sito che la ospita, proprio come se aprissi la pagina nel browser.

Buono a sapersi

  • Il risultato è fatto di immagini. Come in una vera scansione, il testo del PDF non si può selezionare né cercare, a meno che tu non abbia usato l’opzione per il testo descritta sopra con un file Typst. Conserva il sorgente .typ o .adoc per le modifiche.
  • L’effetto scansione viene sempre applicato. Look Scanned serve a far sembrare scansionati i documenti. Se ti serve solo un PDF pulito, esportalo con Typst o con Asciidoctor PDF.
  • Ti servono pacchetti, include o diagrammi? Genera il PDF su un computer con Typst o Asciidoctor PDF installato, poi aggiungi l’effetto scansione a quel PDF in Look Scanned. Funziona con qualsiasi documento, perché lo strumento originale ha già fatto la parte difficile.

Scrivi in un altro formato? Scopri come Look Scanned gestisce i file LaTeX e i file Markdown, HTML e TXT.

Hai un file .typ o .adoc che deve sembrare scansionato? Provalo con Typst o con AsciiDoc.