5 use crate::syntax::feature_gate::UnstableFeatures;
6 use crate::syntax::edition::Edition;
7 use crate::html::markdown::{IdMap, ErrorCodes, Markdown};
9 use std::cell::RefCell;
11 #[derive(Clone, Debug)]
12 pub struct ExternalHtml {
13 /// Content that will be included inline in the <head> section of a
14 /// rendered Markdown file or generated documentation
15 pub in_header: String,
16 /// Content that will be included inline between <body> and the content of
17 /// a rendered Markdown file or generated documentation
18 pub before_content: String,
19 /// Content that will be included inline between the content and </body> of
20 /// a rendered Markdown file or generated documentation
21 pub after_content: String
25 pub fn load(in_header: &[String], before_content: &[String], after_content: &[String],
26 md_before_content: &[String], md_after_content: &[String], diag: &errors::Handler,
27 id_map: &mut IdMap, edition: Edition)
28 -> Option<ExternalHtml> {
29 let codes = ErrorCodes::from(UnstableFeatures::from_environment().is_nightly_build());
30 load_external_files(in_header, diag)
32 load_external_files(before_content, diag)
36 load_external_files(md_before_content, diag)
38 format!("{}{}", bc, Markdown(&m_bc, &[], RefCell::new(id_map),
42 load_external_files(after_content, diag)
43 .map(|ac| (ih, bc, ac))
45 .and_then(|(ih, bc, ac)|
46 load_external_files(md_after_content, diag)
48 format!("{}{}", ac, Markdown(&m_ac, &[], RefCell::new(id_map),
61 pub enum LoadStringError {
66 pub fn load_string<P: AsRef<Path>>(file_path: P, diag: &errors::Handler)
67 -> Result<String, LoadStringError>
69 let file_path = file_path.as_ref();
70 let contents = match fs::read(file_path) {
73 diag.struct_err(&format!("error reading `{}`: {}", file_path.display(), e)).emit();
74 return Err(LoadStringError::ReadFail);
77 match str::from_utf8(&contents) {
78 Ok(s) => Ok(s.to_string()),
80 diag.struct_err(&format!("error reading `{}`: not UTF-8", file_path.display())).emit();
81 Err(LoadStringError::BadUtf8)
86 fn load_external_files(names: &[String], diag: &errors::Handler) -> Option<String> {
87 let mut out = String::new();
89 let s = match load_string(name, diag) {
91 Err(_) => return None,