Using asciidoc and asciidoctor to write documentation tutorial. You should probably only consider using it if the file size of the original pdf is several megabytes. The asciidoctorpdfoptimize is not guaranteed to reduce the size of the pdf file. Well cover the most common usages of the processor in this document. Apart from asciidoc 1 and a python interpreter, no other programs are required to convert asciidoc text files to docbook or html. The processor generates the output format using a converter.
Asciidoc ships with a set of default templates in the tin, but you can customize the templates or create your own to get exactly the output you want. Using the asciidoctorfopub project, you can convert any docbook file into a nicely formatted pdf with nothing more than a java runtime jvm and development kit jdk. A path relative to output files containing admonition and navigation icons. The asciidoc a2xformat attribute value is set to format. Complete guide for using asciidoc in linux its foss. An asciidoc processor parses the document and translates it into a backend format, such as html, epub, docbook or pdf. This section describes how to specify the output format. Asciidoc is a text document format for writing notes, documentation, articles. Note that it would have been better to call usrlocalbinasciidoctorpdf. Well demonstrate how to generate html5 or pdf from an asciidoc document. Document conversion d, destinationdirdir destination output directory.
Asciidoctor pdf is a native pdf converter for asciidoc. Latex is a typesetting program especially well suited for scientific publications. The asciidoctor processor is typically used to parse an asciidoc document and convert it to a variety of formats, such as html, docbook, or pdf. Asciidoc document in a github repository or a gist is automatically converted to html and rendered in the web interface. The asciidoctorpdf1 command converts the asciidoc source files file to pdf. The easiest way to convert asciidoc document to pdf is as follows. The default behavior is to use text in place of icons. This option is only applicable to html based output formats.