docxide-pdf 0.18.4

Library and CLI for converting DOCX files to PDF, matching Microsoft Word's output as closely as possible
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

use std::io::{Read, Seek};

use super::{WML_NS, read_zip_text, twips_attr, wml, wml_attr, wml_bool};

pub(super) struct DocumentSettings {
    pub even_and_odd_headers: bool,
    pub mirror_margins: bool,
    pub default_tab_stop: f32,
    pub gutter_at_top: bool,
    pub east_asia_lang: Option<String>,
    /// `w:themeFontLang @bidi`: picks the theme's complex-script font.
    pub bidi_lang: Option<String>,
    pub default_lang: Option<String>,
    /// §17.15.1.15 `w:characterSpacingControl` is `compressPunctuation` or
    /// `compressPunctuationAndJapaneseKana`: Word may squeeze full-width East
    /// Asian punctuation to keep one more character on a line.
    pub compress_punctuation: bool,
    /// `w:compat/w:compatSetting[@w:name="compatibilityMode"]`: 15 = Word 2013+
    /// layout, 14 = Word 2010, lower or 0 (absent) = older.
    pub compat_mode: u32,
    /// §17.15.1.57 `w:linkStyles` with no `w:attachedTemplate`: Word refreshes
    /// the styles from its own Normal.dotm when it opens the file. A named
    /// template lives on the author's machine and can't be loaded.
    pub styles_from_normal_template: bool,
    /// `w:compat/w:doNotExpandShiftReturn`: a justified line ending in a
    /// manual break keeps its natural width.
    pub do_not_expand_shift_return: bool,
    /// `w:compat/w:adjustLineHeightInTable`: table cell lines snap to the
    /// document grid too (§17.15.3.1).
    pub adjust_line_height_in_table: bool,
}

impl Default for DocumentSettings {
    fn default() -> Self {
        Self {
            even_and_odd_headers: false,
            mirror_margins: false,
            default_tab_stop: 36.0, // 0.5 inches = 720 twips = 36pt
            gutter_at_top: false,
            east_asia_lang: None,
            bidi_lang: None,
            default_lang: None,
            compress_punctuation: false,
            compat_mode: 0,
            styles_from_normal_template: false,
            do_not_expand_shift_return: false,
            adjust_line_height_in_table: false,
        }
    }
}

pub(super) fn parse_settings<R: Read + Seek>(zip: &mut zip::ZipArchive<R>) -> DocumentSettings {
    let Some(xml_text) = read_zip_text(zip, "word/settings.xml") else {
        return DocumentSettings::default();
    };
    let Ok(doc) = roxmltree::Document::parse(&xml_text) else {
        return DocumentSettings::default();
    };
    let root = doc.root_element();

    let default_tab_stop = wml(root, "defaultTabStop")
        .and_then(|n| twips_attr(n, "val"))
        .unwrap_or(36.0);

    let theme_font_lang = wml(root, "themeFontLang");
    let lang = |attr| {
        theme_font_lang
            .and_then(|n| n.attribute((WML_NS, attr)))
            .map(str::to_string)
    };
    let east_asia_lang = lang("eastAsia");
    let default_lang = lang("val");
    let bidi_lang = lang("bidi");

    let compat = wml(root, "compat");
    let compat_flag = |name| compat.and_then(|c| wml_bool(c, name)).unwrap_or(false);

    DocumentSettings {
        even_and_odd_headers: wml_bool(root, "evenAndOddHeaders").unwrap_or(false),
        mirror_margins: wml_bool(root, "mirrorMargins").unwrap_or(false),
        default_tab_stop,
        gutter_at_top: wml_bool(root, "gutterAtTop").unwrap_or(false),
        east_asia_lang,
        bidi_lang,
        default_lang,
        compress_punctuation: wml_attr(root, "characterSpacingControl")
            .is_some_and(|v| v.starts_with("compressPunctuation")),
        compat_mode: compat
            .into_iter()
            .flat_map(|c| c.children())
            .find(|n| n.attribute((WML_NS, "name")) == Some("compatibilityMode"))
            .and_then(|n| n.attribute((WML_NS, "val")))
            .and_then(|v| v.parse().ok())
            .unwrap_or(0),
        styles_from_normal_template: wml_bool(root, "linkStyles").unwrap_or(false)
            && wml(root, "attachedTemplate").is_none(),
        do_not_expand_shift_return: compat_flag("doNotExpandShiftReturn"),
        adjust_line_height_in_table: compat_flag("adjustLineHeightInTable"),
    }
}