mdcat-ng 0.2.1

cat for markdown: show markdown documents in terminals
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

// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.

//! HTML block rendering.
//!
//! When the parser yields an HTML block we emit it literally with the block
//! style. We split multi-line content on newlines so each line gets the
//! correct indent (the first line uses `initial_indent`; subsequent lines use
//! `indent`).

use std::io::Write;

use crate::error::RenderResult as Result;

use pulldown_cmark::CowStr;
use syntect::util::LinesWithEndings;

use super::state::{HtmlBlockAttrs, StateAndData, StateStack};
use super::write::{write_indent, write_styled};
use super::StateData;
use crate::Settings;

/// Render `Text` inside an HTML block, indenting each line.
pub(super) fn handle_text<'a, W: Write>(
    writer: &mut W,
    settings: &Settings,
    stack: StateStack,
    attrs: HtmlBlockAttrs,
    text: CowStr<'a>,
    data: StateData<'a>,
) -> Result<StateAndData<StateData<'a>>> {
    let HtmlBlockAttrs {
        indent,
        initial_indent,
        style,
    } = attrs;
    for (n, line) in LinesWithEndings::from(&text).enumerate() {
        let line_indent = if n == 0 { initial_indent } else { indent };
        write_indent(writer, line_indent)?;
        write_styled(writer, &settings.terminal_capabilities, &style, line)?;
    }
    stack
        .current(
            HtmlBlockAttrs {
                initial_indent: indent,
                indent,
                style,
            }
            .into(),
        )
        .and_data(data)
        .ok()
}

/// Render `Html` (a single inline HTML element) inside an HTML block.
///
/// Each line is independently indented — previously, multi-line HTML dropped
/// indentation on the 2nd+ lines (upstream TODO at former render.rs:820).
pub(super) fn handle_html<'a, W: Write>(
    writer: &mut W,
    settings: &Settings,
    stack: StateStack,
    attrs: HtmlBlockAttrs,
    html: CowStr<'a>,
    data: StateData<'a>,
) -> Result<StateAndData<StateData<'a>>> {
    let HtmlBlockAttrs {
        indent,
        initial_indent,
        style,
    } = attrs;
    for (n, line) in LinesWithEndings::from(&html).enumerate() {
        let line_indent = if n == 0 { initial_indent } else { indent };
        write_indent(writer, line_indent)?;
        write_styled(writer, &settings.terminal_capabilities, &style, line)?;
    }
    stack
        .current(
            HtmlBlockAttrs {
                initial_indent: indent,
                indent,
                style,
            }
            .into(),
        )
        .and_data(data)
        .ok()
}