summaryrefslogtreecommitdiff
path: root/Build/source/texk/dvisvgm/dvisvgm-0.8.7/README
blob: e1652b6d9e03c2daee20856addda5a3406dee17a (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
117
118
119
120
dvisvgm -- A DVI to SVG converter

DESCRIPTION

 dvisvgm is a utility for TeX/LaTeX users. It converts
 DVI files to the XML-based scalable vector graphics format SVG.


DEPENDENCIES

 dvisvgm relies on the following free libraries:
   * FreeType 2 (http://www.freetype.org)
     This library is used to extract glyph outlines
     from PFB files.

   * Ghostscript (http://pages.cs.wisc.edu/~ghost)
     The PostScript special handler requires the Ghostscript
     library libgs.so (Linux) or gsdll32.dll (Windows) to be
     installed. If the configure script finds the corresponing 
     Ghostscript development files on the system, it directly 
     links against libgs.so. Otherwise, the library is looked up 
     at runtime and PostScript support is enabled only if libgs.so 
     could be found. 
     Due to incompatible changes of the Ghostscript API, dvisvgm 
     requires Ghostscript 8.31 or later.

   * kpathsea
     This library is part of the Web2C package and is
     usually installed in conjunction with a TeX distribution.
     kpathsea provides functions for searching files in the
     large texmf tree.

   * potracelib (http://potrace.sourceforge.net)
     Peter Selinger's bitmap tracing library is utilized to
     vectorize Metafont's bitmap output.
     potracelib is now part of the dvisvgm source tarball, so
     you don't need to create the library seperately any longer.

   * zlib (http://www.zlib.org)
     Compressed SVG files are produced by using functions
     of this library and the Gzstream wrapper classes
     (http://www.cs.unc.edu/Research/compgeom/gzstream)
     which are licensed under LGPL version 2.1 (or optionally any 
     later version) and should be included with this package.

 If you want to build and run the testsuite located in the tests
 subdirectory, you also need the googletest libraries
 (http://code.google.com/p/googletest).


COMPILATION

 Quick installation info:
   * type "./configure"
   * type "make"
   * type "make install" as root (or "sudo make install")

 For generic configuration instructions see the file INSTALL.

 The configure script should recognize all necessary parameters.
 If a library is installed but not detected, specify its location
 as commandline parameter of configure, e.g.
   ./configure --with-freetype=/usr/local/freetype
 (all available options can be displayed with ./configure --help)

 The tracer module calls Metafont in case of lacking TFM or PFB files
 via a system call. Please ensure that Metafont is installed and
 reachable through the search path.
 
 To build Windows binaries I recommend MinGW in conjunction
 with MSYS (http://www.mingw.org). If executed within MSYS
 the configure script assumes that you want to build dvisvgm
 for MiKTeX. In this case the necessary import libraries for
 the MiKTeX DLLs will be created and linked. If not already done,
 add the MiKTeX bin directory to your search path, otherwise the
 required DLLs won't be found while running dvisvgm.

 If you don't like compiling the sources yourself, you can
 download precompiled executables for Windows and MiKTeX
 from sourceforge.net instead (see below).


USAGE
 Information about the command-line interface and the available options
 can be found in the manual page.


ADDITIONAL INFORMATION
 This packacke is available from CTAN (dviware/dvisvgm) and can
 be downloaded from the project website at sourceforge.net as well:

    http://dvisvgm.sourceforge.net

 Here you can find the sources, precompiled binaries and further additional
 information about the converter and related topics.

 If you've found a bug please let me know. You can either send me an
 email or preferably use the bug reporting facilities at sourceforge.net
 (see http://sourceforge.net/projects/dvisvgm).


COPYRIGHT

 Copyright (C) 2005-2009 Martin Gieseking <martin.gieseking@uos.de>

 This program is free software; you can redistribute it and/or modify it 
 under the terms of the GNU General Public License as published by the 
 Free Software Foundation; either version 3 of the License, or (at your 
 option) any later version.

 This program is distributed in the hope that it will be useful, but 
 WITHOUT ANY WARRANTY; without even the implied warranty of 
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General 
 Public License for more details.

 You should have received a copy of the GNU General Public License along 
 with this program; if not, see <http://www.gnu.org/licenses/>. 

 See the file COPYING for details.