taskc 0.1.0

Scan markdown task markers and generate a beautiful static task catalog page.
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
98
99
100
101
102

# taskc

[![Crates.io](https://img.shields.io/crates/v/taskc.svg)](https://crates.io/crates/taskc)
[![Docs.rs](https://img.shields.io/docsrs/taskc)](https://docs.rs/taskc)
![CI](https://img.shields.io/badge/CI-GitHub%20Actions-2ea44f)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Rust Version](https://img.shields.io/badge/rust-1.85%2B-blue.svg)](https://www.rust-lang.org)

`taskc` scans markdown files in a directory tree, finds task sections marked with `<!-- Task -->`, and generates a static `tasks.html` catalog.

## Features

- Recursively scans all `.md` files from the current directory.
- Excludes `.git`, `target`, `node_modules`, and hidden directories.
- Extracts sections where:
  - a line is exactly `<!-- Task -->` (trimmed)
  - the next non-empty line is an ATX header (`#`..`######`)
- Captures section body until the next header with level `<=` the task header.
- Groups tasks by source file in the generated page.
- Dark mode by default with light/dark toggle.
- Task cards collapsed by default, with expand/collapse-all control.

## Installation

```bash
cargo install taskc
```

## Usage

Run in any directory:

```bash
taskc
```

Output:

- Generates `./tasks.html`
- Prints summary: task count, scanned markdown file count, output path
- Prints non-fatal read/walk warnings when relevant

## Task Marker Format

```md
<!-- Task -->
## Build parser

Task details...
### Nested details stay inside the task

## Next section (same level) ends current task capture
```

## Local Development

Install cargo-make once:

```bash
cargo install cargo-make
```

Run common tasks:

```bash
cargo make ci
cargo make test
cargo make publish-dry-run
```

Available useful tasks:

- `cargo make fmt`
- `cargo make fmt-check`
- `cargo make clippy`
- `cargo make test`
- `cargo make doc`
- `cargo make package`
- `cargo make ci` (full local CI gate)
- `cargo make publish-dry-run`
- `cargo make publish`
- `cargo make run-fixture`

Equivalent raw cargo commands:

```bash
cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test
cargo package --allow-dirty
```

Manual fixture:

```bash
cd examples/manual-e2e-fixture
cargo run --manifest-path ../../Cargo.toml --
```

## License

MIT, see [LICENSE](LICENSE).