#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

moonx bobzhang/asciidoctor-pdf/cmd/asciidoctor-pdf-pygments 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-")
}

#Source highlighting

@pygments.register() // package bobzhang/asciidoctor-pdf/pygments

#What is supported

• the gate (38 documents covering every feature above): 38 / 38 identical within the thresholds;
• the conversions of asciidoctor-pdf's own RSpec suite: 2097 / 2415 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 CodeRay highlighting, and only the Rouge lexers listed above (see Source highlighting).
• AsciiDoc table cells (a|), video poster images and GIF/BMP/TIFF images are not rendered; image icons (icons other than font) show their alt text.
• A PDF page imported as an image keeps its drawing but not its links or other annotations. Ruby gives the pages after a PDF front cover that cannot be imported, or after a PDF background on the first page, Prawn's default 36pt margins; this port keeps the theme's.
• 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.2.1 (MoonBit), based on pagelayout).

#Changes

#0.2.1

• Images that 0.2.0 drew wrongly, or left out with an UNSUPPORTED image warning, are embedded (pdflite 0.3.7):
  • greyscale and CMYK JPEGs in their own colour space (they were written as RGB), progressive JPEGs and JPEGs without a JFIF header (left out);
  • 16-bit PNGs with an alpha channel and palette PNGs with transparency (left out), and the transparent colour of a greyscale or truecolour PNG (drawn opaque).
• Characters beyond the Basic Multilingual Plane (emoji, CJK extensions) are set with the glyphs of a font that has them, such as the fallback font's emoji (they were empty boxes).
• Layout: bobzhang/prawn 0.2.0. With the standard (AFM) fonts, as in the base theme, pairs with an accented letter (Té, Vé, Yó) kern as in Ruby; they were not kerned, which moved the rest of the line.
• Fidelity: asciidoctor-pdf's spec suite replays as before, 2097 of 2415 records identically. The two emoji examples now render as Ruby's do; they still count as different, because Ruby's PDF gives the emoji other characters when its text is extracted.

#0.2.0

• Source highlighting:
  • Rouge, through a port of Rouge 3.30 (its lexer engine, themes and 56 lexers, checked token by token against Ruby Rouge), as asciidoctor-pdf's convert_code uses it: linenums, highlight line ranges, callouts, PHP start_inline, the highlighter's background and colours, and line numbering that wraps as asciidoctor-pdf's SourceWrap does.
  • Pygments too, through bobzhang/pygments, when registered (bobzhang/asciidoctor-pdf/pygments).
• Commands: cmd/asciidoctor-pdf highlights with Rouge only. The larger cmd/asciidoctor-pdf-pygments registers Pygments as well.
• PDF files as block images (page=, pages=), front and back covers and page backgrounds, imported as vector graphics (pdflite 0.3.2 / pagelayout 0.7.1). An unreadable PDF fails the conversion with TemplateError (a background warns instead).
• Layout: the layout moved to its own module, bobzhang/prawn. This breaks code that imports bobzhang/asciidoctor-pdf/svg, which is now bobzhang/prawn/svg. FontCatalog, IconSet, default_font_files and default_icon_font_files are re-exported, so register(catalog=...) and convert_document are used as before.
• Fidelity: asciidoctor-pdf's spec suite replays 2097 of 2415 records identically (0.1.0: 1978 of 2329, before the harvest also recorded the highlighting examples).

#0.1.0

• First release.

#License