mdbook-bib 0.5.3

mdbook plugin allowing to load and present a bibliography in BibLaTex format in your books and cite its references
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
123
124
125
126
127

//! Integration tests for full book processing.
//!
//! This module covers:
//! - Complete test book builds
//! - CSL style book builds (IEEE, Chicago, Nature)
//! - Output verification

use super::common::find_str_in_file;
use crate::Bibliography;
use mdbook_driver::MDBook;
use std::path::PathBuf;

// =============================================================================
// Example Book Integration Tests
// =============================================================================

#[test]
fn process_basic_example_book() {
    let mut manual_src_path = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
    manual_src_path.push("example_books/basic/");
    let mut md = MDBook::load(manual_src_path).unwrap();
    let mdbook_bib_prepro = Bibliography;
    md.with_preprocessor(mdbook_bib_prepro);
    match md.build() {
        Ok(_) => (),
        Err(err) => panic!("there was an error building the book: {err:?}"),
    }

    // Check both, root level and nested html files get placeholders substituted with
    // bib references with relative paths
    let mut book_dest_path = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
    book_dest_path.push("example_books/basic/public");

    let bib_reference = "bibliography.html#mdBook";

    let mut non_nested_html = book_dest_path.clone();
    non_nested_html.push("intro.html");
    match find_str_in_file(bib_reference, non_nested_html) {
        Ok(_) => (),
        Err(_) => panic!(),
    }

    let mut nested_html = book_dest_path.clone();
    nested_html.push("chapter_1/intro.html");
    match find_str_in_file(bib_reference, nested_html) {
        Ok(_) => (),
        Err(_) => panic!(),
    }
}

// =============================================================================
// CSL Style Integration Tests
// =============================================================================

#[test]
fn process_csl_ieee_example_book() {
    // Integration test for CSL IEEE example book
    let mut path = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
    path.push("example_books/csl_ieee/");

    let mut md = MDBook::load(path).unwrap();
    let mdbook_bib_prepro = Bibliography;
    md.with_preprocessor(mdbook_bib_prepro);

    match md.build() {
        Ok(_) => (),
        Err(err) => panic!("Error building CSL IEEE test book: {err:?}"),
    }

    // Verify output contains CSL-formatted citations
    let mut output_path = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
    output_path.push("example_books/csl_ieee/book");

    // Check that the bibliography page exists
    let mut bib_path = output_path.clone();
    bib_path.push("bibliography.html");
    assert!(bib_path.exists(), "Bibliography page should exist");

    // Verify CSL entry class is present
    match find_str_in_file("csl-entry", bib_path) {
        Ok(_) => (),
        Err(_) => panic!("CSL entry class not found in bibliography"),
    }
}

#[test]
fn process_csl_chicago_example_book() {
    // Integration test for CSL Chicago example book
    let mut path = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
    path.push("example_books/csl_chicago/");

    let mut md = MDBook::load(path).unwrap();
    let mdbook_bib_prepro = Bibliography;
    md.with_preprocessor(mdbook_bib_prepro);

    match md.build() {
        Ok(_) => (),
        Err(err) => panic!("Error building CSL Chicago test book: {err:?}"),
    }
}

#[test]
fn process_csl_nature_example_book() {
    // Integration test for CSL Nature example book
    let mut path = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
    path.push("example_books/csl_nature/");

    let mut md = MDBook::load(path).unwrap();
    let mdbook_bib_prepro = Bibliography;
    md.with_preprocessor(mdbook_bib_prepro);

    match md.build() {
        Ok(_) => (),
        Err(err) => panic!("Error building CSL Nature test book: {err:?}"),
    }

    // Nature uses superscript - verify <sup> tags in output
    let mut output_path = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
    output_path.push("example_books/csl_nature/book/biology.html");

    if output_path.exists() {
        match find_str_in_file("<sup>", output_path) {
            Ok(_) => (),
            Err(_) => panic!("Superscript tags not found in Nature style output"),
        }
    }
}