lontar-cli 0.1.1

Command-line interface for the Lontar document generation library.
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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

# Lontar CLI

[![Crates.io](https://img.shields.io/crates/v/lontar-cli.svg)](https://crates.io/crates/lontar-cli)
[![License](https://img.shields.io/crates/l/lontar-cli.svg)](https://github.com/lontar-rs/lontar#license)

**Command-line interface for the Lontar document generation library.**

Convert documents between multiple formats using the Lontar library from the command line.

## Installation

```bash
cargo install lontar-cli
```

## Usage

```bash
# Convert Markdown to DOCX
lontar input.md --format docx -o output.docx

# Convert template to PDF
lontar template.tera --format pdf -o output.pdf

# Convert to multiple formats
lontar input.md --format docx,pdf,html -o output
```

## Supported Formats

### Input
- Markdown
- Tera templates
- JSON (document AST)

### Output
- **DOCX**: Microsoft Word documents
- **PPTX**: Microsoft PowerPoint presentations
- **PDF**: Portable Document Format
- **XLSX**: Microsoft Excel spreadsheets
- **HTML**: Self-contained HTML with inline CSS
- **Markdown**: CommonMark-compatible Markdown
- **LaTeX**: XeLaTeX/LuaLaTeX source files
- **TXT**: Plain text with ASCII art tables

## Features

All features from the `lontar` library are available:

- Multi-format output
- Unicode and complex script support
- Citations and bibliography
- Cross-references
- Diagrams with auto-layout
- Template-based generation

## Examples

### Basic Conversion

```bash
lontar document.md --format docx -o output.docx
```

### With Bibliography

```bash
lontar paper.md --format pdf --bibliography refs.bib -o paper.pdf
```

### Template Rendering

```bash
lontar report.tera --data data.json --format docx -o report.docx
```

### Multiple Outputs

```bash
lontar input.md --format docx,pdf,html -o output
# Generates: output.docx, output.pdf, output.html
```

## Command-Line Options

```
lontar [OPTIONS] <INPUT>

Arguments:
  <INPUT>  Input file

Options:
  -f, --format <FORMAT>        Output format(s): docx, pptx, pdf, xlsx, md, html, txt, tex
  -o, --output <OUTPUT>        Output file or directory
  -b, --bibliography <FILE>    Bibliography file (.bib or .json)
  -d, --data <FILE>            Template data file (JSON)
  -h, --help                   Print help
  -V, --version                Print version
```

## Library

This CLI is built on the [lontar](https://crates.io/crates/lontar) library. For programmatic document generation, use the library directly:

```toml
[dependencies]
lontar = { version = "0.1", features = ["docx", "pdf"] }
```

## Minimum Supported Rust Version (MSRV)

Rust **1.88** or later.

## License

Licensed under either of:

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

## Links

- [Lontar Library](https://crates.io/crates/lontar)
- [Documentation](https://docs.rs/lontar)
- [Repository](https://github.com/lontar-rs/lontar)
- [Issue Tracker](https://github.com/lontar-rs/lontar/issues)