Creating HTML and PDF
Create HTML and PDF from an AsciiDoc file directly from your IDE.
The user can choose Create HTML from current file from the editor’s action toolbar to convert the file to HTML format. If creating HTML succeeds, the exported file is opened in the system’s default browser.
The user can choose Create PDF from current file from the editor’s action toolbar to convert the file shown in the current AsciiDoc editor to a PDF using Asciidoctor PDF version 1.6.x. If creating the PDF succeeds, the plugin opens the PDF in the system’s PDF viewer. To find out more how to configure the output and formatting, visit https://asciidoctor.org/docs/asciidoctor-pdf/.
As of the AsciiDoc Plugin version 0.31.14+, Asciidoctor PDF is no longer included in the plugin as default as it adds approximately 2 MB to the download of the installation and each update.
When creating a PDF for the first time, the plugin will download the necessary dependency.
The download requires a working internet connection. When the download fails, the IDE prompts to check proxy settings or to retry the download. The IDE’s event log contains instructions for a manual download of the file.
The dependencies will be cached locally. A new download will only be necessary when the AsciiDoc plugin requires a newer version.
Users can force the download by selecting “Download AsciiDoc dependencies for diagrams and PDF creation” in the settings of the plugin.