Convertitore online gratuito da ASCIIDOC a TYP

Typst richiede documenti sorgente nel suo formato di markup .typ, mentre molti progetti di documentazione sono creati come file .adoc o .asciidoc. La conversione tra questi formati consente di riutilizzare documentazione strutturata in un flusso di pubblicazione Typst senza ricreare manualmente ogni titolo, elenco e riferimento.

Cos'è il formato ASCIIDOC

AsciiDoc è un formato di markup in testo normale per documentazione tecnica, manuali, file README, libri e pagine web. I file usano comunemente .adoc o .asciidoc; Asciidoctor e Asciidoctor.js li creano e li elaborano. Il formato supporta titoli, elenchi, tabelle, blocchi di codice sorgente, riferimenti incrociati, attributi, inclusioni, avvisi, immagini e metadati del documento.

Cos'è il formato TYP

Nella categoria dei file di testo, .typ indica il markup sorgente di Typst. Typst è un sistema di composizione tipografica il cui compilatore trasforma i file sorgente in PDF e altri output renderizzati. I file TYP combinano una sintassi sorgente leggibile con istruzioni di layout per titoli, figure, tabelle, citazioni, impostazioni di pagina e funzioni riutilizzabili. Sono utili quando il flusso di lavoro di destinazione utilizza il compilatore Typst invece di un renderer AsciiDoc o di una toolchain LaTeX.

Come convertire effettivamente ASCIIDOC in TYP

Il metodo automatizzato più affidabile consiste nel convertire Asciidoctor in DocBook XML, seguito da Pandoc in Typst. Installa Asciidoctor e una versione recente di Pandoc, quindi esegui:

asciidoctor -b docbook5 -o document.xml document.adoc
pandoc -f docbook -t typst -o document.typ document.xml

Sostituisci document.adoc con il nome del file sorgente. Il primo comando espande la struttura AsciiDoc in DocBook; il secondo associa gli elementi DocBook al markup Typst. Compila il risultato con:

typst compile document.typ

Per un file AsciiDoc che dipende dagli attributi, impostali durante la conversione, ad esempio:

asciidoctor -a revnumber=2.0 -a showtitle -b docbook5 -o document.xml document.adoc

Puoi anche utilizzare il convertitore gratuito su 101convert.com senza installare software: seleziona il formato sorgente ASCIIDOC, carica il file, scegli TYP e salva il risultato convertito.

Limitazioni relative a qualità e compatibilità

Si tratta di una traduzione del markup, non di una modifica del formato a livello di byte. I titoli di base, i paragrafi, il testo in evidenza, gli elenchi, le tabelle, i blocchi di codice e molti collegamenti vengono generalmente trasferiti correttamente, ma gli attributi AsciiDoc, i contenuti condizionali, i ruoli personalizzati, le macro, le estensioni, le inclusioni e i blocchi di diagrammi possono richiedere una riscrittura manuale in Typst.

Quando possibile, risolvi le inclusioni e genera gli asset esterni prima della conversione. Controlla i percorsi delle immagini, le larghezze delle tabelle, le citazioni, le impostazioni di pagina e i riferimenti incrociati nel file .typ generato. Pandoc può preservare il contenuto modificando al contempo la semantica del layout, quindi compila il file con Typst e controlla il PDF renderizzato invece di affidarti esclusivamente al sorgente convertito.