vesti 0.15.0

A preprocessor that compiles into LaTeX
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

# vesti


A transpiler that compiles into LaTeX.

## Why need a LaTeX transpiler?


I used to make several documentations using LaTeX (or plainTeX, but TeX is quite cumbersome to write
a document, especially very complex tables or put an image, for example).
However, its markdown like syntax is not confortable to use it.
For example, there is a simple LaTeX document.

```tex
% coprime is my custom class. See https://github.com/e0328eric/coprime.
\documentclass[tikz, geometry]{coprime}

\settitle{My First Document}{Sungbae Jeong}{}
\setgeometry{a4paper, margin = 2.5cm}

\begin{document}
\section{Foo}
Hello, World!
\begin{figure}[ht]
    \centering
    \begin{tikzpicture}
        \draw (0,0) -- (1,1);
    \end{tikzpicture}
\end{figure}

Upper code is a figure using tikz.

\end{document}
```

What I am anoying about to use it is `\begin` and `\end` block. Is there a way to write much simpler? This
question makes me to start this project. Currently, below code is generated into upper LaTeX code
using vesti except comments.

```
% coprime is my custom class. See https://github.com/e0328eric/coprime.
docclass coprime (tikz, geometry)

\settitle{My First Document}{Sungbae Jeong}{}
\setgeometry{a4paper, margin = 2.5cm}

startdoc

\section{Foo}
Hello, World!
useenv figure [ht] {
    \centering
    useenv tikzpicture {
        \draw (0,0) -- (1,1);
    }
}

Upper code is a figure using tikz.
```

## Installation

### Prerequisits

Python 3.12 is need to use `vesti`.
Vesti can be installed using `cargo`.

```console
$ cargo install vesti
```

### tectonic backend compilation issue

For a higher version of the rust compiler, somewhat tectonic backend is not
compilable. See
[vesti-tectonic-git](https://github.com/e0328eric/vesti-tectonic-git) if one
want to use tectonic backend for vesti.

## config file

In default, it uses local `pdflatex` to compile vesti. If you want to change the default behavior, add `config.yaml` in `$CONFIG_PATH/vesti` and type like the following:
```yaml
engine:
  main:
    "tectonic"
```
This example defaults vesti to run `tectonic` backend. (You must download vesti using `tectonic-backend` to use `tectonic`). The full list for main engine is in `src/commands.rs`.

## Warning


This language is in beta version, so future break changes can be exist. Beware to use in the large
projects.