tack 0.1.1-alpha

A minimal syntax highlighter that outputs HTML
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
90
91
92
93
94
95
96
97

# tack

[![crates.io](https://img.shields.io/crates/v/tack.svg)](https://crates.io/crates/tack)
[![Released API docs](https://docs.rs/tack/badge.svg)](https://docs.rs/tack)
[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)

Tack is a minimal syntax highlighter that outputs HTML.

**Note: this library is alpha and subject to breaking API changes.** 
**More languages are on the way!**

Features:
 - class-based
 - minimal HTML

Supported languages:
 - CSS

 For a more fully-featured syntax highlighter, use [`syntect`](https://github.com/trishume/syntect).


## Examples

```css
body {
  display: flex;
  flex-direction: column;
  min-height: 100%;
}
```

Tack usage:
```rust
fn main() {
    let s = "
body {
display: flex;
min-height: 100%;
}".to_string();

    let html = tack::coloured_html(s);
    println!("{}", html);
}
```

Tack output:
```html
<span class="tag">body</span> {
  <span class="property">display</span>: <span class="string">flex</span>;
  <span class="property">min-height</span>: <span class="numeric">100%</span>;
}
```

`syntect` usage:
```rust
use syntect::{
    html::{ClassStyle, ClassedHTMLGenerator},
    parsing::SyntaxSet,
    util::LinesWithEndings,
};

fn main() {
    let ss = SyntaxSet::load_defaults_newlines();

    let s = "
body {
    display: flex;
    min-height: 100%;
}";

    let syntax_ref = ss.find_syntax_by_extension("css").unwrap();
    let mut html_generator =
        ClassedHTMLGenerator::new_with_class_style(syntax_ref, &ss, ClassStyle::Spaced);
    for line in LinesWithEndings::from(s) {
        html_generator.parse_html_for_line_which_includes_newline(line);
    }
    let html = html_generator.finalize();
    println!("{}", html);
}
```

`syntect` output:
```html
<span class="source css">
  <span class="meta selector css"><span class="entity name tag css">body</span> </span><span
    class="meta property-list css"><span class="punctuation section property-list css">{</span>
    <span class="meta property-name css"><span class="support type property-name css">display</span></span><span
      class="punctuation separator key-value css">:</span><span class="meta property-value css"> </span><span
      class="meta property-value css"><span class="support constant property-value css">flex</span></span><span
      class="punctuation terminator rule css">;</span>
    <span class="meta property-name css"><span class="support type property-name css">min-height</span></span><span
      class="punctuation separator key-value css">:</span><span class="meta property-value css"> </span><span
      class="meta property-value css"><span class="constant numeric css">100<span
          class="keyword other unit css">%</span></span></span><span class="punctuation terminator rule css">;</span>
  </span><span class="punctuation section property-list css">}</span></span>
```