summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/metapost/mpchess/README.md
blob: a9505b99acf763981413e879142b0a95178c1a53 (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
# MPchess

This package allows you to draw chess boards and positions. The appearance of
the drawings is modern and largely inspired by what is offered by the excellent
web site [Lichess.org](lichess.org). Relying on METAPOST probably
allows more graphic flexibility than the excellent LaTeX packages.

_This package is in beta version, do not hesitate to report bugs, as well as
requests for improvement_.

## Installation

MPchess is on the [ctan](ctan.org) and can be installed via the package manager of your
distribution [https://www.ctan.org/pkg/mpchess](https://www.ctan.org/pkg/mpchess).

### With TeX live under Linux or MacOS

To install MPchess with TeX live, you will have to create the directory texmf
directory in your home. 
```bash
user $> mkdir ~/texmf
```

Then, you will have to place the .mp files in the
`~/texmf/tex/metapost/mpchess/`.

MPchess consists of 7 files METAPOST :
* `mpchess.mp`;
* `mpchess-chessboard.mp`;
* `mpchess-pgn.mp`;
* `mpchess-fen.mp`;
* `mpchess-cburnett.mp`;
* `mpchess-mpchess.mp`;
* `mpchess-skak.mp`.

Once this is done, MPchess will be loaded with the classic
```metapost
input mpchess
```

### With MikTEX and Windows

These two systems are unknown to the author of MPchess, so we refer to their
documentation to add local packages:
[http://docs.miktex.org/manual/localadditions.html](http://docs.miktex.org/manual/localadditions.html)

## Dependencies

MPchess depends on the packages METAPOST: `hatching` and, if MPchess is not
used with LuaLaTeX and luamplib, `latexmp`.

## Documentation

* [English documentation](doc/mpchess-doc-en.pdf)
* [Documentation en français](doc/mpchess-doc-fr.pdf)

## Licenses

This projet is under LATEX Project Public License 1.3c but the file
`mpchess-cburnett` is under GPLv2+ as asked by the author.