<commit_before>= Asciidoctor PDF: A native PDF converter for AsciiDoc
<NAME> <https://github.com/mojavelinux[@mojavelinux]>; <NAME> <https://github.com/graphitefriction[@graphitefriction]>
// Settings:
:compat-mode!:
:experimental:
:idprefix:
:idseparator: -
:icons: font
:pagenums:
//ifdef::env-github[:relfileprefix: /blob/master/]
ifdef::env-browser[:toc: preamble]
//:pdf-page-size: [8.25in, 11.69in]
//:pdf-page-size: A4
// Aliases:
:project-name: Asciidoctor PDF
:project-handle: asciidoctor-pdf
// URIs:
:uri-project: https://github.com/asciidoctor/asciidoctor-pdf
:uri-project-repo: {uri-project}
:uri-project-issues: {uri-project-repo}/issues
:uri-project-list: http://discuss.asciidoctor.org
:uri-prawn: http://prawn.majesticseacreature.com
:uri-rvm: http://rvm.io
:uri-asciidoctor: http://asciidoctor.org

// FIXME See last line; Asciidoctor should only be using outfilesuffix defined in header
:original-outfilesuffix: {outfilesuffix}
:outfilesuffix: .adoc

_Lo and behold_, a native PDF converter for AsciiDoc built with {uri-asciidoctor}[Asciidoctor] and {uri-prawn}[Prawn]! +
_No more middleman._ +
_No more DocBook toolchain._ +
It's AsciiDoc straight to PDF!

[caption=Status]
CAUTION: {project-name} is currently _alpha_ software.
While the converter handles most AsciiDoc content, there's still work needed to fill in gaps where conversion is incomplete, incorrect or not implemented.
See the milestone v1.5.0 in the {uri-project-issues}[issue tracker] for details.

== Prawn, the majestic PDF generator

{uri-project}[{project-name}] is made possible by an amazing Ruby gem named Prawn.
And what a gem it is!

{uri-prawn}[Prawn] is a nimble PDF writer for Ruby.
More important, it's a hackable platform that offers both high level APIs for the most common needs and low level APIs for bending the document model to accomodate special circumstances.

With Prawn, you can write text, draw lines and shapes and place images _anywhere_ on the page and add as much color as you like.
In addition, it brings a fluent API and aggressive code re-use to the printable document space.

Here's an example that demonstrates how to use Prawn to create a basic PDF document.

.Create a basic PDF document using Prawn
[source,ruby]
----
require 'prawn'

Prawn::Document.generate 'output.pdf' do
  text 'Hello, PDF creation!'
end
----

It's that easy.
And that's just the beginning.
Skip ahead to <<getting-started,Getting started>> to start putting it use.

Prawn is the _killer library_ for PDF generation we've needed to close this critical gap in Asciidoctor.
It absolutely takes the pain out of creating printable documents.
Picking up from there, {project-name} takes the pain out of creating PDF documents _from AsciiDoc_.

== Features

=== Notable features

* Direct AsciiDoc to PDF conversion
* <<docs/theming-guide.adoc#,Configuration-driven style and layout>><commit_msg>Fixed typographical error, changed accomodate to accommodate in README.<commit_after>= Asciidoctor PDF: A native PDF converter for AsciiDoc
<NAME> <https://github.com/mojavelinux[@mojavelinux]>; <NAME> <https://github.com/graphitefriction[@graphitefriction]>
// Settings:
:compat-mode!:
:experimental:
:idprefix:
:idseparator: -
:icons: font
:pagenums:
//ifdef::env-github[:relfileprefix: /blob/master/]
ifdef::env-browser[:toc: preamble]
//:pdf-page-size: [8.25in, 11.69in]
//:pdf-page-size: A4
// Aliases:
:project-name: Asciidoctor PDF
:project-handle: asciidoctor-pdf
// URIs:
:uri-project: https://github.com/asciidoctor/asciidoctor-pdf
:uri-project-repo: {uri-project}
:uri-project-issues: {uri-project-repo}/issues
:uri-project-list: http://discuss.asciidoctor.org
:uri-prawn: http://prawn.majesticseacreature.com
:uri-rvm: http://rvm.io
:uri-asciidoctor: http://asciidoctor.org

// FIXME See last line; Asciidoctor should only be using outfilesuffix defined in header
:original-outfilesuffix: {outfilesuffix}
:outfilesuffix: .adoc

_Lo and behold_, a native PDF converter for AsciiDoc built with {uri-asciidoctor}[Asciidoctor] and {uri-prawn}[Prawn]! +
_No more middleman._ +
_No more DocBook toolchain._ +
It's AsciiDoc straight to PDF!

[caption=Status]
CAUTION: {project-name} is currently _alpha_ software.
While the converter handles most AsciiDoc content, there's still work needed to fill in gaps where conversion is incomplete, incorrect or not implemented.
See the milestone v1.5.0 in the {uri-project-issues}[issue tracker] for details.

== Prawn, the majestic PDF generator

{uri-project}[{project-name}] is made possible by an amazing Ruby gem named Prawn.
And what a gem it is!

{uri-prawn}[Prawn] is a nimble PDF writer for Ruby.
More important, it's a hackable platform that offers both high level APIs for the most common needs and low level APIs for bending the document model to accommodate special circumstances.

With Prawn, you can write text, draw lines and shapes and place images _anywhere_ on the page and add as much color as you like.
In addition, it brings a fluent API and aggressive code re-use to the printable document space.

Here's an example that demonstrates how to use Prawn to create a basic PDF document.

.Create a basic PDF document using Prawn
[source,ruby]
----
require 'prawn'

Prawn::Document.generate 'output.pdf' do
  text 'Hello, PDF creation!'
end
----

It's that easy.
And that's just the beginning.
Skip ahead to <<getting-started,Getting started>> to start putting it use.

Prawn is the _killer library_ for PDF generation we've needed to close this critical gap in Asciidoctor.
It absolutely takes the pain out of creating printable documents.
Picking up from there, {project-name} takes the pain out of creating PDF documents _from AsciiDoc_.

== Features

=== Notable features

* Direct AsciiDoc to PDF conversion
* <<docs/theming-guide.adoc#,Configuration-driven style and layout>>
{'fraction_non_alphanumeric': 0.10152632481564054, 'fraction_numerical': 0.003772937746527182, 'mean_word_length': 4.890909090909091, 'pattern_counts': {'":': 0, '<': 19, '<?xml version=': 0, '>': 19, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2516560', 'n_tokens_mistral': 1834, 'n_tokens_neox': 1781, 'n_words': 687}