summaryrefslogtreecommitdiff
path: root/support/latex-make/README
blob: 2d9d568cda93cfe45d48c197f1807588aff79e83 (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
              +------------------------------+
              |    The LaTeX-Make system     |
              +------------------------------+

VERSION: 2.4.3

DESCRIPTION
===========

This package provides several tools that aim to simplify the
compilation of LaTeX documents:
* LaTeX.mk: a Makefile snippet to help compiling LaTeX documents in
  DVI, PDF, PS, ... format. Dependencies are automatically tracked: one
  should be able to compile documents with a one-line Makefile
  containing 'include LaTeX.mk'. Complex documents (with multiple
  bibliographies, indexes, glossaries, ...) should be correctly managed.

* figlatex.sty: a LaTeX package to easily insert xfig figures (with
  \includegraphics{file.fig}). It can interact with LaTeX.mk so that the
  latter automatically invokes transfig if needed.

* And various helper tools for LaTeX.mk

Homepage: https://gitlab.inria.fr/latex-utils/latex-make
License type: gpl

INSTALLATION:
=============

Once generated, the following files need to be installed:
* *.sty, *.cfg
  Main LaTeX package files. Should be installed into
  TEXMF/tex/latex/latex-make/ where TEXMF is a base of a TeX Directory
  Structure for your TeX installation;
* *.py
  Helper scripts used by LaTeX.mk. They should be installed into
  TEXMF/scripts/latex-make/
* LaTeX.mk:
  This is the Makefile snipset to include into your main Makefile.
  To avoid the need to hardcode the path of LaTeX.mk in the 'include' directive
  of the Makefile, LaTeX.mk must be installed in a default search directory of
  GNUMake such as PREFIX/include, /usr/local/include, /usr/include/, etc.
  See your GNUMake documentation for the list of such search directories;
    In order to be able to also use the 'LaTeX-Make-local-install' target,
  LaTeX.mk must also be installed into TEXMF/scripts/latex-make/
  *and* the two lines with "FIXME" at the end of this file must be updated
  with the TEXMF installation path.
* *.pdf
  Documentation that can be installed into
  TEXMF/doc/latex/latex-make/

REQUIREMENTS:
=============

  In order to work, LaTeX Make requires:
  - GNU Make (>= 3.81)
    type "make --version" to check
  - a relatively recent LaTeX distribution (teTeX 3.0 should work,
    TeXLive >= 2005 also)
  
  If using figlatex, LaTeX Make also needs:
  - inkscape (>= 0.48.2) for converting svg files
  - transfig (>= 3.2.4) for the fig2dev command
    type "transfig -V" to check
  - ghostscript that is called by fig2dev
    type "gs --version" to check