bookforge-pdf 1.8.0

PDF ingestion for BookForge: poppler-based layout extraction and deterministic reconstruction into a translatable EPUB.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

//! PDF ingestion for BookForge (ROADMAP §9b).
//!
//! Layout extraction is delegated to poppler's command-line tools;
//! everything after the `pdftohtml -xml` output is deterministic Rust:
//! line merging, column detection, reading order, paragraph clustering,
//! heading detection, and synthetic-EPUB assembly. The produced EPUB
//! flows through the ordinary BookForge pipeline — this crate is an
//! ingestion front-end, not a parallel translation path.

pub mod convert;
pub mod epub;
pub mod model;
pub mod parse;
pub mod reconstruct;
pub mod report;
pub mod tools;

pub use convert::{ConvertOptions, ConvertOutcome, convert_pdf};
pub use model::{ColumnMode, DocBlock, Line, Page, Span};
pub use parse::parse_pdf2xml;
pub use reconstruct::reconstruct;
pub use report::ConversionReport;
pub use tools::{PopplerTools, ToolError};

#[derive(Debug, thiserror::Error)]
pub enum PdfError {
    #[error("poppler tooling: {0}")]
    Tool(#[from] tools::ToolError),

    #[error("pdftohtml XML parse: {0}")]
    Xml(#[from] quick_xml::Error),

    #[error("invalid pdftohtml output: {0}")]
    InvalidInput(String),

    #[error(transparent)]
    Io(#[from] std::io::Error),

    #[error("zip: {0}")]
    Zip(#[from] zip::result::ZipError),
}

pub type Result<T> = std::result::Result<T, PdfError>;