INSTALL

   1 The installation of PyX is pretty straightforward if you have installed the
   2 Python distutils package.
   3
   4 First, you have to decide which C extension modules you want to build. This can
   5 be done by setting the respective flags in the setup.cfg config file. The
   6 default settings build the t1strip extension module, which enables partial font
   7 downloading (i.e. only the glyphs of a font that are used are included in the
   8 eps file). The only requisites for building this module are the Python headers
   9 and a C compiler.
  10
  11 The second extension module provides Python binding for the kpathsea library,
  12 which enables fast searching for files in the TeX/LaTeX directory hierarchy. By
  13 default it is not built, because you need the header files of this libary,
  14 which are not included in many standard TeX distributions. Besides that,
  15 the fallback, which uses the kpsewhich program, works equally well, although
  16 it is not as efficient as using the library directly. If you want
  17 to build the c extension module, you may also have to specify the location
  18 of the kpathsea header files and the library in the setup.cfg file.
  19
  20 After you have adapted the setup.cfg file to your needs, you can either build
  21 PyX locally by just running
  22
  23    python setup.py build_ext -i
  24
  25 On the other hand, a system wide installation can be performed with help of
  26
  27     python setup.py install
  28
  29 or an appropriate variant thereof.