summaryrefslogtreecommitdiff
path: root/support/tikztosvg/README.md
blob: 97678fddfa535d2cf605ee57c260e1712f7d91c6 (plain)
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
# tikztosvg(1)

The `tikztosvg(1)` command renders TikZ diagrams to SVG, using
[TeXLive](https://tug.org/texlive/) and
[pdf2svg](https://github.com/dawbarton/pdf2svg).

## Usage

``` sh
$ tikztosvg [OPTION]... INPUT_PATH
```

If *INPUT\_PATH* is set to *-* the input will be read from stdin.

### Options

**-o, \-\-output**=*OUTPUT\_PATH*  
Write output to file *OUTPUT\_PATH*. If set to *-* the output will be written
to stdout. Defaults to the base name of the input file suffixed with the *.svg*
extension. The file is resolved relative to the working directory.

**-p, \-\-package**=+*PACKAGE*  
Include `\usepackage{PACKAGE}` when rendering the diagram. The tikz, tikz-cd,
pgfplots, amsmath and amssymb packages are always included by default.

**-l, \-\-library**=+*LIBRARY*
Include `\usetikzlibrary{LIBRARY}` when rendering the diagram.

**-q, \-\-quiet**  
Silence application log messages and script warnings.

**\-\-lualatex**
Use [LuaTeX](http://luatex.org/) as the TeX engine. LuaTeX is already the
default, so this option doesn't really do much.

**\-\-xelatex**
Use [XeTeX](http://xetex.sourceforge.net/) as the TeX engine.

**\-\-pdflatex**
Use [pdfTeX](https://www.tug.org/applications/pdftex/) as the TeX engine.

**-h, \-\-help**  
Print a help message.

**-v, \-\-version**  
Print version information.

## Example

Let’s say you want to convert the file `example.tikz` to SVG

``` latex
\begin{tikzcd}
                  G \arrow{r}{\varphi} \arrow[two heads]{d} & H \\
  \mathlarger{\sfrac{G}{\ker \varphi}} \arrow[dotted]{ru}   &
\end{tikzcd}
```

You could achieve this by running
``` sh
$ # xfrac and relsize are only there so that we can 
$ # call \sfrac and \mathlarger
$ tikztosvg -p xfrac -p relsize example.tikz
```

The results will be stored in the file `example.svg`.

## Dependencies

* A regular TeXLive installation: you'll need LuaTeX and optionally XeTeX and
  pdfTeX
* pdf2svg

## Installation

The `tikztosvg(1)` command and it’s man page can be installed in Unix systems
via Git by running
``` sh
$ git clone https://git.sr.ht/~pablo-pie/tikztosvg
$ cd tikztosvg
$ sudo make install
```

The `BIN_TARGET` Make variable (defaults to `/usr/bin/`) controls the
directory the binary is installed in, while the `MAN_TARGET` Make variable
(defaults to `/usr/share/man/man1/`) controls the directory the man page
is installed in.

## Resources

**Git source repository on sourcehut:** <https://git.sr.ht/~pablo-pie/tikztosvg>

**Bug tracker:** <https://todo.sr.ht/~pablo-pie/tikztosvg>

**CTAN package:** <https://www.ctan.org/pkg/tikztosvg>

**TeXLive** <https://tug.org/texlive/>

**LuaTeX** <http://luatex.org/>

**XeTeX** <http://xetex.sourceforge.net/>

**pdfTeX** <https://www.tug.org/applications/pdftex/>

## Authors

**tikztosvg** was written by [Pablo](mailto:pablo-escobar@riseup.net).

**pdf2svg** was written by [David Barton](mailto:davebarton@cityinthesky.co.uk)
and [Matthew Flaschen](mailto:matthew.flaschen@gatech.edu).

## License

© 2021 Pablo.

Free use of this software is granted under the terms of the GPL-3.0 License.