use std::path::Path; use std::{cmp::Ordering, collections::BTreeMap}; use mdbook_core::utils::special_escape; use handlebars::{ Context, Handlebars, Helper, HelperDef, Output, RenderContext, RenderError, RenderErrorReason, }; // Handlebars helper to construct TOC #[derive(Clone, Copy)] pub struct RenderToc { pub no_section_label: bool, } impl HelperDef for RenderToc { fn call<'reg: 'rc, 'rc>( &self, _h: &Helper<'rc>, _r: &'reg Handlebars<'_>, ctx: &'rc Context, rc: &mut RenderContext<'reg, 'rc>, out: &mut dyn Output, ) -> Result<(), RenderError> { // get value from context data // rc.get_path() is current json parent path, you should always use it like this // param is the key of value you want to display let chapters = rc.evaluate(ctx, "@root/chapters").and_then(|c| { serde_json::value::from_value::>>(c.as_json().clone()) .map_err(|_| { RenderErrorReason::Other("Could not decode the JSON data".to_owned()).into() }) })?; let fold_enable = rc .evaluate(ctx, "@root/fold_enable")? .as_json() .as_bool() .ok_or_else(|| { RenderErrorReason::Other("Type error for `fold_enable`, bool expected".to_owned()) })?; let fold_level = rc .evaluate(ctx, "@root/fold_level")? .as_json() .as_u64() .ok_or_else(|| { RenderErrorReason::Other("Type error for `fold_level`, u64 expected".to_owned()) })?; // If true, then this is the iframe and we need target="_parent" let is_toc_html = rc .evaluate(ctx, "@root/is_toc_html")? .as_json() .as_bool() .unwrap_or(false); out.write("
    ")?; let mut current_level = 1; for item in chapters { let (_section, level) = if let Some(s) = item.get("section") { (s.as_str(), s.matches('.').count()) } else { ("", 1) }; // Expand if folding is disabled, or if levels that are larger than this would not // be folded. let is_expanded = !fold_enable || level - 1 < (fold_level as usize); match level.cmp(¤t_level) { Ordering::Greater => { while level > current_level { out.write("
  1. ")?; out.write("
      ")?; current_level += 1; } write_li_open_tag(out, is_expanded, false)?; } Ordering::Less => { while level < current_level { out.write("
    ")?; out.write("
  2. ")?; current_level -= 1; } write_li_open_tag(out, is_expanded, false)?; } Ordering::Equal => { write_li_open_tag(out, is_expanded, !item.contains_key("section"))?; } } // Spacer if item.contains_key("spacer") { out.write("
  3. ")?; continue; } // Part title if let Some(title) = item.get("part") { out.write("
  4. ")?; out.write(&special_escape(title))?; out.write("
  5. ")?; continue; } // Link let path_exists = match item.get("path") { Some(path) if !path.is_empty() => { out.write("" } else { "\">" })?; true } _ => { out.write("
    ")?; false } }; if !self.no_section_label { // Section does not necessarily exist if let Some(section) = item.get("section") { out.write("")?; out.write(section)?; out.write(" ")?; } } if let Some(name) = item.get("name") { out.write(&special_escape(name))? } if path_exists { out.write("")?; } else { out.write("
    ")?; } // Render expand/collapse toggle if let Some(flag) = item.get("has_sub_items") { let has_sub_items = flag.parse::().unwrap_or_default(); if fold_enable && has_sub_items { out.write("
    ")?; } } out.write("")?; } while current_level > 1 { out.write("
")?; out.write("")?; current_level -= 1; } out.write("")?; Ok(()) } } fn write_li_open_tag( out: &mut dyn Output, is_expanded: bool, is_affix: bool, ) -> Result<(), std::io::Error> { let mut li = String::from("
  • "); out.write(&li) }