typst-as-lib 0.15.5

Small wrapper for typst that makes it easier to use it as a templating engine
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

use std::path::PathBuf;

/// Configuration options for `typst-kit` font searching.
#[derive(Clone, Debug)]
pub struct TypstKitFontOptions {
    pub(crate) include_system_fonts: bool,
    pub(crate) include_dirs: Vec<PathBuf>,
    #[cfg(feature = "typst-kit-embed-fonts")]
    pub(crate) include_embedded_fonts: bool,
}

impl Default for TypstKitFontOptions {
    fn default() -> Self {
        Self {
            include_system_fonts: true,
            include_dirs: Default::default(),
            #[cfg(feature = "typst-kit-embed-fonts")]
            include_embedded_fonts: true,
        }
    }
}

impl TypstKitFontOptions {
    /// Creates new options with default settings.
    pub fn new() -> Self {
        TypstKitFontOptions::default()
    }
}

impl TypstKitFontOptions {
    /// Sets whether to include system fonts.
    ///
    /// # Example
    ///
    /// ```rust,no_run
    /// # use typst_as_lib::typst_kit_options::TypstKitFontOptions;
    /// let options = TypstKitFontOptions::new()
    ///     .include_system_fonts(true);
    /// ```
    pub fn include_system_fonts(mut self, include_system_fonts: bool) -> Self {
        self.include_system_fonts = include_system_fonts;
        self
    }

    /// Sets whether to include embedded fonts from `typst-assets`.
    ///
    /// # Example
    ///
    /// ```rust,no_run
    /// # use typst_as_lib::typst_kit_options::TypstKitFontOptions;
    /// let options = TypstKitFontOptions::new()
    ///     .include_embedded_fonts(true);
    /// ```
    #[cfg(feature = "typst-kit-embed-fonts")]
    pub fn include_embedded_fonts(mut self, include_embedded_fonts: bool) -> Self {
        self.include_embedded_fonts = include_embedded_fonts;
        self
    }

    /// Adds additional directories to search for fonts.
    ///
    /// # Example
    ///
    /// ```rust,no_run
    /// # use typst_as_lib::typst_kit_options::TypstKitFontOptions;
    /// let options = TypstKitFontOptions::new()
    ///     .include_dirs(["./fonts", "./custom-fonts"]);
    /// ```
    pub fn include_dirs<I, P>(mut self, include_dirs: I) -> Self
    where
        I: IntoIterator<Item = P>,
        P: Into<std::path::PathBuf>,
    {
        self.include_dirs = include_dirs.into_iter().map(Into::into).collect();
        self
    }
}