citum-schema-style 0.65.0

Citum style schema types and styling 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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

/*
SPDX-License-Identifier: MIT OR Apache-2.0
SPDX-FileCopyrightText: © 2023-2026 Bruce D'Arcus and Citum contributors
*/

use std::sync::LazyLock;

use crate::{tc_contributor, tc_date, tc_variable, template::TemplateComponent};

const APA_BIBLIOGRAPHY_TEMPLATE_YAML: &str = r#"
- contributor: author
  form: long
  suffix: "."
  name-order: family-first
- date: issued
  form: year
  wrap:
    punctuation: parentheses
  prefix: " "
- title: primary
  emph: true
- delimiter: "; "
  wrap:
    punctuation: brackets
  prefix: " "
  group:
    - variable: genre
      text-case: capitalize-first
    - variable: medium
      text-case: capitalize-first
- number: edition
  wrap:
    punctuation: parentheses
  prefix: " "
- delimiter: ""
  wrap:
    punctuation: parentheses
  prefix: " "
  group:
    - term: volume
      form: short
      suffix: " "
    - number: volume
- contributor: translator
  form: long
  name-order: given-first
  label: {term: translator, form: short, placement: suffix}
  wrap:
    punctuation: parentheses
  prefix: " "
- contributor: editor
  form: long
  name-order: given-first
  label: {term: editor, form: short, placement: suffix}
  prefix: ". In "
- title: parent-monograph
  emph: true
  prefix: ", "
- delimiter: ", "
  group:
    - title: parent-serial
      emph: true
    - delimiter: ""
      group:
        - number: volume
          emph: true
        - number: issue
          wrap:
            punctuation: parentheses
- number: pages
  prefix: ", "
  suffix: "."
- variable: publisher
  prefix: ". "
  suffix: "."
- variable: doi
  prefix: "https://doi.org/"
- variable: url
  prefix: " "
- group:
    - variable: archive-name
    - variable: archive-location
      wrap:
        punctuation: parentheses
      prefix: " "
  delimiter: ""
  prefix: ". "
"#;

static APA_CITATION: LazyLock<Vec<TemplateComponent>> = LazyLock::new(|| {
    vec![
        tc_contributor!(Author, Short),
        tc_date!(Issued, Year),
        tc_variable!(Locator),
    ]
});

static APA_BIBLIOGRAPHY: LazyLock<Vec<TemplateComponent>> = LazyLock::new(|| {
    #[allow(clippy::expect_used, reason = "Embedded APA template must parse")]
    serde_yaml::from_str(APA_BIBLIOGRAPHY_TEMPLATE_YAML)
        .expect("embedded APA bibliography template should parse")
});

/// Embedded citation template for APA style.
///
/// Renders as: (Author, Year)
/// Example: (Smith & Jones, 2024)
pub fn citation() -> Vec<TemplateComponent> {
    APA_CITATION.clone()
}

/// Embedded bibliography template for APA style.
///
/// Renders the full bibliographic entry in APA format:
/// Author, A. A., & Author, B. B. (Year). Title of work. *Journal Title*, *Volume*(Issue), Pages. <https://doi.org/xxx>
///
/// # Panics
///
/// Panics if the embedded YAML template literal becomes invalid.
pub fn bibliography() -> Vec<TemplateComponent> {
    APA_BIBLIOGRAPHY.clone()
}