livetex 0.2.0

A TeX/LaTeX auto builder and server.
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

livetex
=

A TeX/LaTeX auto builder and deployer.

## Demonstration

[a.webm](https://gist.github.com/user-attachments/assets/acdbae7a-d38a-4397-95f6-91003feb4500)

## Usage Example

```shell
./livetex -r ~/latex -a 0.0.0.0:8000 -c xelatex --output-format=pdf --halt-on-error
```

After running the command above, PDF preview is available at `http://localhost:8000/<tex-filename>` (e.g. <http://localhost:8000/foo.tex>).
And, everytime the file `~/latex/*.tex` changes, the webpage will reload automatically.

## CLI Usage

<pre>A live integrated server that compiles TeX and serve its PDF automatically on source changes

<u style="text-decoration-style:solid"><b>Usage:</b></u> <b>livetex</b> [OPTIONS] <b>--root</b> &lt;ROOT&gt;

<u style="text-decoration-style:solid"><b>Options:</b></u>
  <b>-a</b>, <b>--addr</b> &lt;ADDR&gt;
          Server address [default: 0.0.0.0:8080]
  <b>-r</b>, <b>--root</b> &lt;ROOT&gt;
          Root directory to serve
  <b>-c</b>, <b>--build-command</b> &lt;BUILD_COMMAND&gt;...
          Command to build a TeX file. This argument should be present last
  <b>-h</b>, <b>--help</b>
          Print help</pre>

## Alternatives

I've discovered some other approaches to achieve automatic TeX compilation + PDF reloading. 

**Compilation**

- [autotex](https://crates.io/crates/autotex)
- `latexmk`

  ```shell
  latexmk -pdf -pvc -pdflatex='xelatex --halt-on-error' a.tex
  ```

**Previewing**

- [pdf-live-server](https://crates.io/crates/pdf-live-server)

However, none of them reflect compilation error on the PDF previewing side (they just remain unchanged). Plus, I want
auto-preview using the browser's native PDF viewer (it's simple: just use `<embed>`) instead of using something extra like `pdf.js`, so
finally I created my version of this little toolchain.