#asciidoctor-pdf for MoonBit

• Runs on the native and wasm targets.
• Self-contained: asciidoctor-pdf's themes and the fonts they use (Noto Serif, M+ 1mn, Noto Sans, M+ 1p Fallback, Noto Emoji) and the icon fonts prawn-icon draws with (Font Awesome 5, Foundation Icons, PaymentFont) are bundled; no Ruby, gem or font files are needed.

#Command line

moonx bobzhang/asciidoctor-pdf/cmd/asciidoctor-pdf doc.adoc

moon -C pdf build --target native --release
pdf/_build/native/release/build/bobzhang/asciidoctor-pdf/cmd/asciidoctor-pdf/asciidoctor-pdf.exe doc.adoc

asciidoctor-pdf doc.adoc                       # writes doc.pdf next to doc.adoc
asciidoctor-pdf -o out.pdf doc.adoc            # -o - writes the PDF to standard output
asciidoctor-pdf -D build -a toc doc.adoc       # writes build/doc.pdf
asciidoctor-pdf --theme default-sans doc.adoc  # or -a pdf-theme=my-theme.yml -a pdf-themesdir=themes
asciidoctor-pdf -d book -S safe doc.adoc
cat doc.adoc | asciidoctor-pdf - > doc.pdf     # standard input to standard output
asciidoctor-pdf --help                         # all options

#Library

///|
test "convert a document to PDF" {
  @asciidoctor_pdf.register()
  let doc = @asciidoctor.load(
    (
      #|= Hello, PDF
      #|
      #|A paragraph with *strong* text.
    ),
    options=@core.Options::new(backend="pdf", standalone=true),
  )
  let pdf = @asciidoctor_pdf.convert(doc)
  assert_eq(pdf[0:5].to_owned(), b"%PDF-")
}

///|
test "a theme with fonts of another package" {
  @asciidoctor_pdf.register(fonts=[@bundled.default_fonts(), @sans.fonts()])
  let doc = @asciidoctor.load(
    "Set in Noto Sans.",
    options=@core.Options::new(backend="pdf", standalone=true, attributes=[
      ("pdf-theme", Str("default-sans")),
    ]),
  )
  assert_eq(@asciidoctor_pdf.convert(doc)[0:5].to_owned(), b"%PDF-")
}

#What is supported

• the gate (36 documents covering every feature above): 36 / 36 identical within the thresholds;
• the conversions of asciidoctor-pdf's own RSpec suite: 1978 / 2329 pass (the rest are listed with their reason in the repository's tests/pdf_golden/known_failures.txt);
• a corpus of 2,840 real-world documents: 2772 pass.

#Known differences from Ruby asciidoctor-pdf

• No source highlighting: source-highlighter (Rouge, Pygments, CodeRay) is ignored and listings are set in plain text.
• AsciiDoc table cells (a|), video poster images, GIF/BMP/TIFF and PDF images (image::x.pdf[]) are not rendered; image icons (icons other than font) show their alt text.
• A few theme keys are ignored: abstract_padding, caption backgrounds, heading_min_height_after: auto, footnotes-title.
• SVG text in a font the theme's catalog does not have is set in the base font.
• No Ruby extensions, converter subclasses or custom templates (-r, -T); -r asciidoctor-pdf is accepted (it is built in). No asciidoctor-pdf-optimize.
• The PDF's Producer names this port (Asciidoctor PDF 0.1.0 (MoonBit), based on pagelayout).

#License