Convertitore online gratuito da ASCIIDOC a TEXTILE

Cos'è il formato ASCIIDOC

AsciiDoc è un formato di markup leggero memorizzato come testo normale, generalmente con estensione .adoc o .asciidoc. Supporta titoli di documenti, sezioni, avvisi, tabelle, riferimenti incrociati, attributi, elenchi di codice sorgente, immagini e inclusioni.

I file vengono creati ed elaborati da Asciidoctor, dal processore AsciiDoc precedente, da AsciidocFX, Antora e dagli editor di testo. I progetti di documentazione, i file README, i manuali, le note di rilascio e i file sorgente per siti statici lo utilizzano comunemente. La sintassi AsciiDoc varia a seconda delle implementazioni e le estensioni di Asciidoctor possono aggiungere funzionalità che non fanno parte del formato di base.

Cos'è il formato TEXTILE

Textile è un linguaggio di markup in testo normale utilizzato da alcuni wiki, sistemi di gestione dei contenuti, strumenti di pubblicazione e applicazioni web meno recenti. La sintassi utilizza brevi marcatori come h1. Heading per le intestazioni, *bold* per il testo in grassetto, _italic_ per il corsivo e "link text":https://example.com per i collegamenti.

Textile rimane utile quando l'applicazione di destinazione dispone di un parser Textile ma non supporta AsciiDoc. Poiché è testo normale, il file convertito può essere modificato con qualsiasi editor di testo e sottoposto a controllo versione senza utilizzare un formato di documento binario. Le implementazioni di Textile differiscono nel supporto di tabelle, attributi, note a piè di pagina e sintassi estesa.

Come convertire effettivamente ASCIIDOC in TEXTILE

Per una conversione rapida senza installare software, utilizza il convertitore di 101convert.com: carica il file .adoc o .asciidoc, seleziona TEXTILE come formato di output, avvia la conversione e scarica il file .textile risultante.

Per una conversione locale e ripetibile, utilizza Asciidoctor per creare DocBook XML e Pandoc per creare Textile. Pandoc non analizza in modo affidabile direttamente ogni dialetto AsciiDoc, quindi questo processo in due fasi affida ad Asciidoctor l'interpretazione della sintassi sorgente.

1. Installa Asciidoctor e Pandoc utilizzando il metodo di installazione dei pacchetti appropriato per il tuo sistema operativo.
2. Apri un terminale nella directory contenente il file sorgente.
3. Esegui asciidoctor -b docbook5 -o intermediate.xml input.adoc. Sostituisci input.adoc con il nome effettivo del file. Utilizza input.asciidoc quando questa è l'estensione del file sorgente.
4. Converti il documento intermedio con pandoc -f docbook -t textile intermediate.xml -o output.textile.
5. Apri output.textile in un editor di testo oppure importalo nell'applicazione Textile di destinazione e controlla il risultato visualizzato.

Se il sorgente utilizza inclusioni locali, esegui Asciidoctor dalla directory del progetto in modo che i percorsi relativi vengano risolti correttamente. Ad esempio, asciidoctor -b docbook5 -o intermediate.xml chapters/index.adoc potrebbe richiedere che i percorsi delle inclusioni e gli attributi del progetto siano disponibili dalla directory di lavoro.

Limiti di qualità e compatibilità

Il passaggio intermedio a DocBook può modificare i dettagli di presentazione. Gli attributi AsciiDoc, i blocchi condizionali, i ruoli personalizzati, le estensioni, lo stile degli avvisi, i riferimenti incrociati non risolti e le macro specifiche del processore potrebbero essere omessi o rappresentati in modo diverso in Textile.

Controlla tabelle, elenchi annidati, formattazione in linea, immagini, note a piè di pagina, ancoraggi, blocchi di codice sorgente e collegamenti dopo la conversione. Le immagini vengono normalmente referenziate tramite percorso anziché incorporate, quindi copia i file delle immagini e mantieni la struttura delle directory relative. Un renderer Textile potrebbe non supportare ogni funzionalità prodotta da Pandoc; i costrutti non supportati possono apparire come markup con caratteri di escape o come normali paragrafi.

Conserva il file AsciiDoc originale come sorgente autorevole. Modifica l'output Textile solo quando il sistema di destinazione richiede una correzione una tantum, perché la ripetizione della conversione sovrascriverà tali modifiche.