//! An HTML renderer that takes an iterator of [`Event`]s and emits HTML.
//!
//! The HTML can be written to either a [`std::fmt::Write`] or a [`std::io::Write`] object.
//!
//! # Examples
//!
//! Push to a [`String`] (implements [`std::fmt::Write`]):
//!
//! ```
//! # use jotdown::Render;
//! # let events = std::iter::empty();
//! let mut html = String::new();
//! jotdown::html::Renderer.push(events, &mut html);
//! ```
//!
//! Write to standard output with buffering ([`std::io::Stdout`] implements [`std::io::Write`]):
//!
//! ```
//! # use jotdown::Render;
//! # let events = std::iter::empty();
//! let mut out = std::io::BufWriter::new(std::io::stdout());
//! jotdown::html::Renderer.write(events, &mut out).unwrap();
//! ```
use crate::Alignment;
use crate::Container;
use crate::Event;
use crate::LinkType;
use crate::ListKind;
use crate::OrderedListNumbering::*;
use crate::Render;
use crate::SpanLinkType;
pub struct Renderer;
impl Render for Renderer {
fn push<'s, I: Iterator
{ self.list_tightness.push(*tight); match kind { ListKind::Unordered | ListKind::Task => { self.out.write_str("{ self.out.write_str("
1 { write!(self.out, r#" start="{}""#, start)?; } if let Some(ty) = match numbering { Decimal => None, AlphaLower => Some('a'), AlphaUpper => Some('A'), RomanLower => Some('i'), RomanUpper => Some('I'), } { write!(self.out, r#" type="{}""#, ty)?; } } } } Container::ListItem | Container::TaskListItem { .. } => { self.out.write_str("
\n")?; } self.out.write_char('\n')?; Ok(()) } fn write_escape(&mut self, mut s: &str, escape_quotes: bool) -> std::fmt::Result { let mut ent = ""; while let Some(i) = s.find(|c| { match c { '<' => Some("<"), '>' => Some(">"), '&' => Some("&"), '"' if escape_quotes => Some("""), _ => None, } .map_or(false, |s| { ent = s; true }) }) { self.out.write_str(&s[..i])?; self.out.write_str(ent)?; s = &s[i + 1..]; } self.out.write_str(s) } fn write_text(&mut self, s: &str) -> std::fmt::Result { self.write_escape(s, false) } fn write_attr(&mut self, s: &str) -> std::fmt::Result { self.write_escape(s, true) } }- self.out.write_str("
self.out.write_str("
- { assert!(self.footnote_number.is_none()); self.footnote_number = Some((*number).try_into().unwrap()); if !self.encountered_footnote { self.encountered_footnote = true; self.out .write_str("
\n ")?, Container::Div { .. } => self.out.write_str("")?, Container::Paragraph => { if matches!(self.list_tightness.last(), Some(true)) { continue; } if self.footnote_number.is_none() { self.out.write_str("")?; } else { self.close_para = true; } } Container::Heading { level, .. } => write!(self.out, "", level)?, Container::TableCell { head: false, .. } => self.out.write_str("")?, Container::TableCell { head: true, .. } => self.out.write_str("")?, Container::Caption => self.out.write_str("")?, Container::DescriptionTerm => self.out.write_str("")?, Container::CodeBlock { .. } => self.out.write_str("")?, Container::Span => self.out.write_str("")?, Container::Link(..) => self.out.write_str("")?, Container::Image(src, ..) => { if self.img_alt_text == 1 { if !src.is_empty() { self.out.write_str(r#"" src=""#)?; self.write_attr(&src)?; } self.out.write_str(r#"">"#)?; } self.img_alt_text -= 1; } Container::Verbatim => self.out.write_str("")?, Container::Math { display } => { self.out.write_str(if display { r#"\]"# } else { r#"\)"# })?; } Container::RawBlock { .. } | Container::RawInline { .. } => { self.raw = Raw::None; } Container::Subscript => self.out.write_str("")?, Container::Superscript => self.out.write_str("")?, Container::Insert => self.out.write_str("")?, Container::Delete => self.out.write_str("")?, Container::Strong => self.out.write_str("")?, Container::Emphasis => self.out.write_str("")?, Container::Mark => self.out.write_str("")?, } } Event::Str(s) => match self.raw { Raw::None if self.img_alt_text > 0 => self.write_attr(&s)?, Raw::None => self.write_text(&s)?, Raw::Html => self.out.write_str(&s)?, Raw::Other => {} }, Event::FootnoteReference(_tag, number) => { if self.img_alt_text == 0 { write!( self.out, r##"{}"##, number, number, number )?; } } Event::Symbol(sym) => write!(self.out, ":{}:", sym)?, Event::LeftSingleQuote => self.out.write_str("‘")?, Event::RightSingleQuote => self.out.write_str("’")?, Event::LeftDoubleQuote => self.out.write_str("“")?, Event::RightDoubleQuote => self.out.write_str("”")?, Event::Ellipsis => self.out.write_str("…")?, Event::EnDash => self.out.write_str("–")?, Event::EmDash => self.out.write_str("—")?, Event::NonBreakingSpace => self.out.write_str(" ")?, Event::Hardbreak => self.out.write_str("
\n\n")?; } write!(self.out, "
- ", number)?; continue; } Container::Table => self.out.write_str("
\n")?, Event::Softbreak => self.out.write_char('\n')?, Event::Escape | Event::Blankline => unreachable!("filtered out"), Event::ThematicBreak(attrs) => { self.out.write_str("\n
")?; } } self.first_line = false; } if self.encountered_footnote { self.out.write_str("\n