wiki-tui 0.8.0

A simple and easy to use Wikipedia Text User Interface
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

use crate::config;
use crate::ui::panel::WithPanel;
use crate::ui::scroll_view::Scrollable;
use crate::ui::utils::display_error;
use crate::ui::{
    self,
    article::ArticleView,
    views::{RootLayout, SelectView},
};
use crate::view_with_theme;
use crate::wiki::article::Section;
use anyhow::Result;

use cursive::view::{Nameable, Resizable};
use cursive::Cursive;

/// Adds a table of contents to a given layout
pub fn display_toc<'a>(
    siv: &mut Cursive,
    layout: &mut RootLayout,
    sections: impl Iterator<Item = &'a Section>,
) -> Result<()> {
    let layer_len = siv.screen_mut().len();

    let toc_view_name = format!("toc_view-{}", layer_len);
    debug!("toc_view name '{}'", toc_view_name);

    let mut toc_view = SelectView::<String>::new().on_submit(|siv, anchor| {
        debug!("jumping to '{}'", anchor);

        let layer_len = siv.screen_mut().len();
        let article_view_name = format!("article_view-{}", layer_len);

        // select the header in the article view
        if let Some(mut view) = siv.find_name::<ArticleView>(&article_view_name) {
            view.select_anchor(anchor);
            debug!("selected the header in the article view");
        }

        // focus the article view
        if let Err(error) = siv.focus_name(&article_view_name) {
            let err = anyhow!(error).context(format!("couldn't find '{}'", article_view_name));
            display_error(siv, err);
            return;
        }
        debug!("focussed the article view");
    });
    debug!("created the toc view");

    // add the items to the table of contents
    for section in sections {
        // add the item to the select_view
        let label = format!("{} {}", section.number(), section.text());
        debug!("added the item: '{}' to the toc_view", label);
        toc_view.add_item(label, section.anchor().to_string());
    }
    debug!("added the items to the table of contents");

    // add the toc to the layout
    layout.add_child(
        view_with_theme!(
            config::CONFIG.theme.toc_view,
            toc_view
                .with_name(toc_view_name)
                .scrollable()
                .scroll_x(config::CONFIG.settings.toc.scroll_x)
                .scroll_y(config::CONFIG.settings.toc.scroll_y)
                .full_height()
                .with_panel()
                .title("Content")
        )
        .min_width(config::CONFIG.settings.toc.min_width)
        .max_width(config::CONFIG.settings.toc.max_width),
    );
    debug!("added the toc_view to the article_layout");

    Ok(())
}