blob: c23758daaa5971d061823ba078137fb07f317f11 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
= Asciidoctor PDF Documentation
:navtitle: Introduction
:description: The documentation for Asciidoctor PDF, a converter for Asciidoctor that converts AsciiDoc directly to PDF using the Prawn PDF generation library.
Asciidoctor PDF is a native PDF converter for AsciiDoc that plugs into the `pdf` backend.
It bypasses the requirement to generate an intermediary format such as DocBook, Apache FO, or LaTeX.
Instead, you can use Asciidoctor PDF to convert your documents directly from AsciiDoc to PDF.
The aim of this library is to take the pain out of creating PDF documents from AsciiDoc.
NOTE: You're viewing the documentation for Asciidoctor PDF {page-component-display-version}.
If you're looking for the documentation for Asciidoctor PDF 1.6, refer to the {url-project-repo}/tree/v1.6.x#readme[README] in the v1.6.x branch.
Asciidoctor PDF 1.6 is no longer being developed and will reach EOL later this year.
You are encouraged to migrate to Asciidoctor PDF 2 as soon as possible.
== Overview
Asciidoctor PDF converts an AsciiDoc document directly to a PDF document.
The style and layout of the PDF is controlled by a dedicated theme file.
To the degree possible, Asciidoctor PDF supports all the features of AsciiDoc that are supported by Asciidoctor.
It also provides xref:features.adoc[additional PDF-specific features].
However, there are xref:features.adoc#limitations[certain limits] imposed by the PDF format and the underlying PDF library this extension uses.
Asciidoctor PDF uses the Prawn gem and Prawn's extensions, such as prawn-svg and prawn-table, to generate a PDF document.
{url-prawn}[Prawn^] is a general purpose PDF generator for Ruby that features high-level APIs for common needs like setting up the page and inserting images and low-level APIs for positioning and rendering text and graphics.
|
