asciidoctor-pdf | :page_with_curl: Asciidoctor PDF: A native PDF converter for AsciiDoc based on Asciidoctor and Prawn | Document Editor library

by asciidoctor Ruby Version: v2.3.7 License: MIT

X-Ray Key Features Code Snippets Community Discussions(5)Vulnerabilities Install Support

kandi X-RAY | asciidoctor-pdf Summary

asciidoctor-pdf is a Ruby library typically used in Editor, Document Editor applications. asciidoctor-pdf has no bugs, it has no vulnerabilities, it has a Permissive License and it has medium support. You can download it from GitHub.

Asciidoctor PDF is an Asciidoctor extension that 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, this converter supports all the features of AsciiDoc that are supported by the built-in converters. However, there are certain limits imposed by the PDF format and the PDF library this extension uses. Under the covers, Asciidoctor PDF uses the Prawn gem and its extensions (e.g., prawn-svg and prawn-table) to generate the PDF document. 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. Prawn takes the pain out of creating (basic) PDF documents. Likewise, Asciidoctor PDF takes the pain out of creating PDF documents directly from AsciiDoc. Skip ahead to Getting started to start putting Asciidoctor PDF use. But don’t miss the Highlights to get a preview of what’s possible.

Support

Quality

Security

License

Reuse

Support

asciidoctor-pdf has a medium active ecosystem.

It has 1078 star(s) with 491 fork(s). There are 57 watchers for this library.

It had no major release in the last 12 months.

There are 14 open issues and 1457 have been closed. On average issues are closed in 123 days. There are no pull requests.

It has a neutral sentiment in the developer community.

The latest version of asciidoctor-pdf is v2.3.7

Quality

asciidoctor-pdf has 0 bugs and 0 code smells.

Security

asciidoctor-pdf has no vulnerabilities reported, and its dependent libraries have no vulnerabilities reported.

asciidoctor-pdf code analysis shows 0 unresolved vulnerabilities.

There are 0 security hotspots that need review.

License

asciidoctor-pdf is licensed under the MIT License. This license is Permissive.

Permissive licenses have the least restrictions, and you can use them in most projects.

Reuse

asciidoctor-pdf releases are available to install and integrate.

Installation instructions, examples and code snippets are available.

asciidoctor-pdf saves you 11277 person hours of effort in developing the same functionality from scratch.

It has 23144 lines of code, 468 functions and 113 files.

It has high code complexity. Code complexity directly impacts maintainability of the code.

Top functions reviewed by kandi - BETA

kandi has reviewed asciidoctor-pdf and discovered the below as its top functions. This is intended to give you an instant insight into asciidoctor-pdf implemented functionality, and help decide if they suit your requirements.

Render a fragment .
Applies the fragments to the images .
If a path is added to the path .

Get all kandi verified functions for this library.

asciidoctor-pdf Key Features

No Key Features are available at this moment for asciidoctor-pdf.

asciidoctor-pdf Examples and Code Snippets

No Code Snippets are available at this moment for asciidoctor-pdf.

Community Discussions

Trending Discussions on asciidoctor-pdf

Convert a folder containing asciidocs and pictures to pdf

Asciidoctor: store git commit hash in pdf

Asciidoctor fails to parse formatted text: "

How to convert an asciidoc with cyrillic symbols to pdf?

asciidoc: How to operate mathematically with page-number et al?

QUESTION

Convert a folder containing asciidocs and pictures to pdf

Asked 2022-Mar-04 at 08:23

I would like to convert this book Mastering the Lightning Network, which is freely available through GitHub to a pdf for personal use.

Unfortunately, I have only figured out how to "translate" single files using asciidoc or asciidoctor-pdf. The options for folders don't seem to work with the configuration of the repository.

There has to be an easy way to translate everything, including all files and pictures. Would be very thankful if somebody could help me out.

...

ANSWER

Answered 2022-Feb-10 at 15:43

You could try using imagemagick: magick *.jpg out.pdf

Source https://stackoverflow.com/questions/71067819

QUESTION

Asciidoctor: store git commit hash in pdf

Asked 2021-Aug-25 at 14:16

I'd like to generate a PDF from an .adoc file with asciidoctor using

asciidoctor-pdf Doku.adoc

How can I print the current git sha1-hash into the PDF?

...

ANSWER

Answered 2021-Aug-25 at 14:16

Use DocumentAttributes

asciidoctor-pdf -acommitHash=$(git rev-parse HEAD) Doku.adoc

You can now use the document attribute commitHash within your document by writing:

{commitHash}

Use ifdef to test if the variable is set.

Source https://stackoverflow.com/questions/68924233

QUESTION

Asciidoctor fails to parse formatted text: "

Asked 2020-Dec-20 at 21:13

I'm running asciidoctor with the following command:

...

ANSWER

Answered 2020-Dec-20 at 21:13

Asciidoctor with backend PDF does only have limited support for passthrough syntax as the documentation states.

Asciidoctor PDF does not support arbitrary passthrough content. While the basebackend for the PDF converter is html, it only recognizes a limited subset of inline HTML elements that can be mapped to PDF (e.g., a, strong, em, code, ). Therefore, if your content contains passthrough blocks or inlines, you most likely have to use a conditional preprocessor to skip them (and make other arrangements).

While the a tag is mentioned above a small test shows that only basic syntax is supported.

Using the below adoc file...

Source https://stackoverflow.com/questions/65372649

QUESTION

How to convert an asciidoc with cyrillic symbols to pdf?

Asked 2020-Nov-30 at 14:43

I have created an .adoc file and want to convert it to PDF.

I am using Linux Debian and GEdit for writing the .adoc. I followed all the steps to install asciidoc-pdf, RVM, etc. from here. And it actually works, but for some reason it doesnt want to convert my file.

I downloaded a readme for Asciidoctor PDf converter and tried to convert it to pdf to see if all is working correctly and it converted with no problem.

When I try to convert my file, it only converts the title and that's it. When I try to convert it to HTML, I get a bit more - the line with the name of the author (my name). And I can't understand what's wrong.

I even tried to write the same file from scratch with no result.

Here is a sample of my file:

...

ANSWER

Answered 2020-Nov-30 at 14:43

This ifdef

Source https://stackoverflow.com/questions/65074146

QUESTION

asciidoc: How to operate mathematically with page-number et al?

Asked 2020-Aug-25 at 10:27

Setup

I export a PDF with the following footer:

...

ANSWER

Answered 2020-Aug-25 at 10:27

As suggested in this comment I added an inline macro. It's kind of well documented how to register macros (and/or extensions, for that matter), but not exactly where to register them. So here we go:

Include the extension file in build.gradle, pass the offset if required:

Source https://stackoverflow.com/questions/63374516

Community Discussions, Code Snippets contain sources that include Stack Exchange Network

Vulnerabilities

No vulnerabilities reported

Install asciidoctor-pdf

You can get Asciidoctor PDF by installing the published gem. You can also run the code from source if you want to use a development version or participate in development.
To install Asciidoctor PDF, first make sure you have satisfied the prerequisites. Then, install the gem from RubyGems.org using the following command:.

Support

Asciidoctor can process the full range of characters in the UTF-8 character set. That means you can write your document in any language, save the file with UTF-8 encoding (that’s important!), and expect Asciidoctor to convert the text properly. But you still need a font that provides the glyphs for those characters. When converting a document with Asciidoctor PDF, you may notice that some glyphs for certain languages, such as Chinese, are missing from the PDF. PDF is a “bring your own font” kind of system. In other words, the font you provide must provide glyphs for all the characters used. There’s no one font that supports all the world’s languages (though some, like Noto Serif, certainly come close). Even if there were such a font, bundling that font with the main gem would make it enormous. It would also severely limit the style choices in the default theme, which targets Latin-based languages. Therefore, we’re taking the strategy of creating separate dedicated theme gems that target each language family, such as CJK. Read on to find out how to use these themes.

Find more information at: