xberg 1.1.4

High-performance document intelligence library for Rust. Extract text, metadata, and structured data from PDFs, Office documents, images, and 107 formats and 371 programming languages via tree-sitter code intelligence with async/sync APIs.
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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

//! Render an `InternalDocument` to HTML5 via comrak.

use comrak::{Arena, format_html};

use crate::types::annotations::PdfAnnotation;
use crate::types::internal::InternalDocument;

use super::common::{annotation_display_text, annotation_type_label, escape_html_text};
use super::comrak_bridge::build_comrak_ast;
use super::markdown::comrak_options;

/// Render an `InternalDocument` to HTML5.
pub(crate) fn render_html(doc: &InternalDocument) -> String {
    let arena = Arena::new();
    let root = build_comrak_ast(doc, &arena);

    let mut options = comrak_options();
    options.render.r#unsafe = true;
    options.render.github_pre_lang = true;
    options.render.full_info_string = true;

    let mut output = String::new();
    format_html(root, &options, &mut output).expect("comrak HTML formatting should not fail");

    if let Some(annotations) = doc.annotations.as_deref() {
        output.push_str(&render_annotations_html(annotations));
    }

    output
}

/// Render the document-level PDF annotations (issue #63) as an HTML section:
/// an `<h2>` heading followed by a `<ul>` list, one `<li>` per annotation.
///
/// Returns an empty string when `annotations` is empty.
fn render_annotations_html(annotations: &[PdfAnnotation]) -> String {
    if annotations.is_empty() {
        return String::new();
    }

    let mut out = String::from("<h2>Annotations</h2>\n<ul>\n");
    for annotation in annotations {
        out.push_str("<li><strong>");
        out.push_str(annotation_type_label(annotation.annotation_type));
        out.push_str("</strong> (page ");
        out.push_str(&annotation.page_number.to_string());
        out.push(')');

        if let Some(author) = annotation.author.as_deref().filter(|s| !s.is_empty()) {
            out.push_str(" by ");
            out.push_str(&escape_html_text(author));
        }

        if let Some(text) = annotation_display_text(annotation) {
            out.push_str(": ");
            out.push_str(&escape_html_text(text));
        }

        out.push_str("</li>\n");
    }
    out.push_str("</ul>\n");
    out
}