//! Render HELP.md as formatted egui widgets. use eframe::egui; use pulldown_cmark::{Event, HeadingLevel, Options, Parser, Tag, TagEnd}; pub fn show_help(ui: &mut egui::Ui, markdown: &str) { egui::ScrollArea::vertical().show(ui, |ui| { render_markdown(ui, markdown); }); } fn render_markdown(ui: &mut egui::Ui, markdown: &str) { let mut opts = Options::empty(); opts.insert(Options::ENABLE_TABLES); opts.insert(Options::ENABLE_STRIKETHROUGH); let parser = Parser::new_ext(markdown, opts); let mut in_code_block = false; let mut code_buf = String::new(); let mut para_buf = String::new(); let mut heading_buf = String::new(); let mut heading_level = HeadingLevel::H1; let mut in_heading = false; let mut list_depth = 0usize; let mut list_item_buf = String::new(); let mut in_list_item = false; let flush_para = |ui: &mut egui::Ui, buf: &mut String| { let text = buf.trim(); if text.is_empty() { buf.clear(); return; } ui.add(egui::Label::new(text).wrap().selectable(true)); ui.add_space(4.0); buf.clear(); }; let flush_code = |ui: &mut egui::Ui, buf: &mut String| { if buf.is_empty() { return; } egui::Frame::new() .fill(ui.visuals().extreme_bg_color) .inner_margin(8.0) .show(ui, |ui| { ui.add( egui::Label::new(egui::RichText::new(buf.trim_end()).monospace()) .wrap() .selectable(true), ); }); ui.add_space(6.0); buf.clear(); }; let flush_list_item = |ui: &mut egui::Ui, buf: &mut String, depth: usize| { let text = buf.trim(); if text.is_empty() { buf.clear(); return; } ui.horizontal(|ui| { ui.add_space((depth.saturating_sub(1)) as f32 * 12.0); ui.label("•"); ui.add(egui::Label::new(text).wrap().selectable(true)); }); ui.add_space(2.0); buf.clear(); }; for event in parser { match event { Event::Start(Tag::Heading { level, .. }) => { flush_para(ui, &mut para_buf); in_heading = true; heading_level = level; heading_buf.clear(); } Event::End(TagEnd::Heading(_)) => { let size = match heading_level { HeadingLevel::H1 => 22.0, HeadingLevel::H2 => 18.0, HeadingLevel::H3 => 16.0, HeadingLevel::H4 => 15.0, HeadingLevel::H5 => 14.0, HeadingLevel::H6 => 13.0, }; ui.add_space(8.0); ui.label( egui::RichText::new(heading_buf.trim()) .size(size) .strong(), ); heading_buf.clear(); in_heading = false; ui.add_space(6.0); } Event::Start(Tag::Paragraph) => {} Event::End(TagEnd::Paragraph) => { if in_list_item { flush_list_item(ui, &mut list_item_buf, list_depth); } else { flush_para(ui, &mut para_buf); } } Event::Start(Tag::List(_)) => { flush_para(ui, &mut para_buf); list_depth += 1; } Event::End(TagEnd::List(_)) => { if in_list_item { flush_list_item(ui, &mut list_item_buf, list_depth); in_list_item = false; } list_depth = list_depth.saturating_sub(1); } Event::Start(Tag::Item) => { in_list_item = true; list_item_buf.clear(); } Event::End(TagEnd::Item) => { flush_list_item(ui, &mut list_item_buf, list_depth); in_list_item = false; } Event::Start(Tag::CodeBlock(_)) => { flush_para(ui, &mut para_buf); in_code_block = true; code_buf.clear(); } Event::End(TagEnd::CodeBlock) => { flush_code(ui, &mut code_buf); in_code_block = false; } Event::Start(Tag::Link { dest_url, .. }) => { if !in_code_block && !in_heading { para_buf.push('['); } let _ = dest_url; } Event::End(TagEnd::Link) => { if !in_code_block && !in_heading { para_buf.push(']'); } } Event::Code(text) => { if in_code_block { code_buf.push_str(&text); } else if in_heading { heading_buf.push_str(&text); } else if in_list_item { list_item_buf.push('`'); list_item_buf.push_str(&text); list_item_buf.push('`'); } else { para_buf.push('`'); para_buf.push_str(&text); para_buf.push('`'); } } Event::Text(text) => { if in_code_block { code_buf.push_str(&text); } else if in_heading { heading_buf.push_str(&text); } else if in_list_item { list_item_buf.push_str(&text); } else { para_buf.push_str(&text); } } Event::SoftBreak | Event::HardBreak => { if in_code_block { code_buf.push('\n'); } else if in_list_item { list_item_buf.push(' '); } else { para_buf.push('\n'); } } Event::Rule => { flush_para(ui, &mut para_buf); ui.separator(); ui.add_space(4.0); } Event::Start(Tag::Strong) => { if !in_code_block { para_buf.push_str("**"); } } Event::End(TagEnd::Strong) => { if !in_code_block { para_buf.push_str("**"); } } Event::Start(Tag::Emphasis) => { if !in_code_block { para_buf.push('*'); } } Event::End(TagEnd::Emphasis) => { if !in_code_block { para_buf.push('*'); } } _ => {} } } if in_list_item { flush_list_item(ui, &mut list_item_buf, list_depth); } flush_code(ui, &mut code_buf); flush_para(ui, &mut para_buf); }