somedoc 0.2.10

A very simple document model and markup generator.
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

use crate::model::block::caption::HasCaption;
use crate::model::block::{BlockContent, Caption};
use crate::model::block::{HasLabel, Label};
use crate::model::inline::Math;
#[cfg(feature = "fmt_json")]
use serde::{Deserialize, Serialize};

// ------------------------------------------------------------------------------------------------
// Public Types
// ------------------------------------------------------------------------------------------------

///
/// A math block wraps an inline `Math` so that it forms a stand-alone block within the document.
///
#[derive(Clone, Debug)]
#[cfg_attr(feature = "fmt_json", derive(Serialize, Deserialize))]
pub struct MathBlock {
    #[cfg_attr(feature = "fmt_json", serde(skip_serializing_if = "Option::is_none"))]
    #[cfg_attr(feature = "fmt_json", serde(default))]
    label: Option<Label>,
    math: Math,
    #[cfg_attr(feature = "fmt_json", serde(skip_serializing_if = "Option::is_none"))]
    #[cfg_attr(feature = "fmt_json", serde(default))]
    caption: Option<Caption>,
}

// ------------------------------------------------------------------------------------------------
// Implementations
// ------------------------------------------------------------------------------------------------

label_impl!(MathBlock);

block_impls!(MathBlock);

has_captioned_impls!(MathBlock);

impl From<Math> for MathBlock {
    fn from(inner: Math) -> Self {
        Self {
            label: None,
            math: inner,
            caption: None,
        }
    }
}

impl MathBlock {
    /// Create a new instance from the inline `Math` instance and a `Caption`.
    pub fn with_caption(math: Math, caption: Caption) -> Self {
        Self {
            label: None,
            math,
            caption: Some(caption),
        }
    }

    /// Create a new instance from the inline `Math` instance and a caption string.
    pub fn with_caption_str(math: Math, caption: &str) -> Self {
        Self::with_caption(math, caption.into())
    }

    /// Return a reference to the inner `Math` instance.
    pub fn inner(&self) -> &Math {
        &self.math
    }
}