Convertitore online gratuito da ASCIIDOC a HTML

I file AsciiDoc devono essere convertiti quando la documentazione deve essere aperta in un browser, pubblicata su un sito web o fornita a un sistema che accetta HTML invece del markup sorgente. HTML conserva titoli, elenchi, link, tabelle, blocchi di codice e altra struttura in un formato direttamente visualizzabile.

Cos'è il formato ASCIIDOC

AsciiDoc è un formato di markup in testo semplice per documenti strutturati come documentazione software, manuali, file README, articoli e specifiche tecniche. Gli autori definiscono la struttura con una sintassi leggibile per titoli, elenchi, link, avvisi, tabelle, codice sorgente, immagini e riferimenti incrociati.

Le estensioni di file comuni sono .adoc, .asciidoc e talvolta .asc. I file vengono creati o modificati con normali editor di testo e strumenti di documentazione tra cui Asciidoctor, Asciidoctor.js e Antora. Un file AsciiDoc contiene markup sorgente, quindi un browser visualizzerà i relativi caratteri di formattazione invece di eseguire il rendering della struttura prevista del documento.

Cos'è il formato HTML

HTML è il formato di markup interpretato dai browser web e utilizzato da siti web, portali di documentazione, sistemi di gestione dei contenuti e flussi di lavoro correlati alle email. Una conversione HTML trasforma la struttura AsciiDoc in elementi come <h1>, <p>, <ul>, <table> e <pre>.

HTML è adatto quando i destinatari hanno bisogno di visualizzare il contenuto in un browser, cercare nella documentazione, copiare il contenuto o utilizzare un file incorporabile in una pagina web. Il risultato può includere stili CSS, riferimenti a immagini, risorse per l'evidenziazione della sintassi e link ad altre pagine generate.

Come convertire effettivamente ASCIIDOC in HTML

Utilizzo di Asciidoctor

1. Installa Ruby e il processore Asciidoctor, quindi esegui gem install asciidoctor.
2. Apri un terminale nella directory contenente il file sorgente.
3. Converti il file con asciidoctor input.adoc -o output.html. Sostituisci i nomi dei file con i nomi effettivi dell'origine e della destinazione.
4. Apri output.html in un browser e controlla titoli, link, tabelle, blocchi di codice e immagini.

Per produrre HTML incorporato adatto all'inserimento in un'altra pagina, usa asciidoctor -e input.adoc -o fragment.html. Per applicare un foglio di stile, specificane la posizione con un attributo Asciidoctor come asciidoctor -a stylesheet=site.css input.adoc -o output.html.

Utilizzo di un convertitore online

Puoi convertire gratuitamente il file sul sito web 101convert.com senza installare software. Carica il file AsciiDoc, scegli HTML come formato di output, se richiesto, avvia la conversione e scarica il file generato. Dopo il download, controlla le immagini collegate e i file inclusi, perché la conversione basata sul browser potrebbe non avere accesso ai percorsi locali a cui fa riferimento l'origine.

Considerazioni sulla qualità e sulla compatibilità

I documenti AsciiDoc possono fare riferimento a immagini, includere altri file sorgente, caricare attributi e utilizzare estensioni personalizzate. Una conversione locale con Asciidoctor è generalmente preferibile quando queste dipendenze sono importanti, perché il convertitore può essere eseguito dalla directory di progetto corretta e utilizzare gli attributi previsti.

Mantieni le immagini e i file CSS referenziati nelle posizioni relative previste oppure aggiorna i percorsi generati prima della pubblicazione. Un file HTML può contenere link a risorse separate invece di incorporarle, quindi spostare solo il file HTML può causare immagini mancanti o un output privo di stili.

Macro personalizzate, estensioni non supportate, inclusioni mancanti e attributi del documento errati possono produrre un output incompleto. Testa l'HTML generato nel browser o nel sistema di pubblicazione di destinazione, soprattutto quando l'origine utilizza l'evidenziazione della sintassi, link tra documenti o caratteri non ASCII.