fulgur-cli-0.1.1 is not a library.

Fulgur

An HTML/CSS to PDF converter written in Rust.

Integrates Blitz (HTML parsing, CSS style resolution, layout) with Krilla (PDF generation) through a pagination-aware layout abstraction.

Features

HTML/CSS to PDF conversion
Automatic page splitting with CSS pagination control (break-before, break-after, break-inside, orphans/widows)
Text shaping via Parley
Background colors, borders, and padding
Image embedding (PNG / JPEG / GIF)
Custom font bundling
External CSS file injection
Page sizes (A4 / Letter / A3) with landscape support
PDF metadata (title, author)

Installation

cargo install --path crates/fulgur-cli

CLI Usage

# Convert from file
fulgur render -o output.pdf input.html

# Read from stdin
cat input.html | fulgur render --stdin -o output.pdf

# With options
fulgur render -o output.pdf -s Letter -l --title "My Document" input.html

# Custom fonts and CSS
fulgur render -o output.pdf -f fonts/NotoSansJP.ttf --css style.css input.html

Options

Option	Description	Default
`-o, --output`	Output PDF file path (required)	—
`-s, --size`	Page size (A4, Letter, A3)	A4
`-l, --landscape`	Landscape orientation	false
`--title`	PDF title metadata	—
`-f, --font`	Bundle font files (repeatable)	—
`--css`	External CSS files (repeatable)	—
`--stdin`	Read HTML from stdin	false

Library Usage

use fulgur_core::{Engine, PageSize, Margin};

// Convert with default settings
let pdf = fulgur_core::convert_html("<h1>Hello</h1>")?;

// Custom configuration
let engine = Engine::builder()
    .page_size(PageSize::A4)
    .margin(Margin::uniform_mm(20.0))
    .title("My Document")
    .build();

let pdf = engine.render_html(html)?;
engine.render_html_to_file(html, "output.pdf")?;

Architecture

HTML/CSS input
  ↓
Blitz (HTML parse → DOM → style resolution → Taffy layout)
  ↓
DOM → Pageable conversion (BlockPageable / ParagraphPageable / ImagePageable)
  ↓
Pagination (split Pageable tree at page boundaries)
  ↓
Krilla rendering (Pageable.draw() per page → PDF Surface)
  ↓
PDF bytes

Project Structure

crates/
├── fulgur-core/   # Core library (conversion, layout, rendering)
└── fulgur-cli/    # CLI tool

Development

# Build
cargo build

# Test
cargo test

# Run CLI directly
cargo run -p fulgur-cli -- render -o output.pdf input.html

fulgur-cli 0.1.1