summaryrefslogtreecommitdiff
path: root/graphics/metapost/contrib/macros/wordcloud/README.md
blob: 2fb8d968f45bf3cc54ca76a1921a4fccc4e2fefc (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
# wordcloud

This package (MetaPost, Lua, and LaTeX) allows you to draw wordclouds.

_This package is in beta version, do not hesitate to report bugs, as well as
requests for improvement. There is lots to do!_

## Github

To allow for easier feedback and bug reporting, this repository has a mirror
repository on github:
[https://github.com/chupinmaxime/wordcloud](https://github.com/chupinmaxime/wordcloud) 

## Installation

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

### With TeX live under Linux or MacOS

To install `wordcloud` 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/wordcloud/`.

`wordcloud` consists of 3 files:
* `wordcloud.mp` (MetaPost) that should be in `~/texmf/metapost/wordcloud/`;
* `wordcloud.tex` (LaTeX) that should be in `~/texmf/tex/latex/wordcloud/`;
* `wordcloud.lua` (Lua) that should be in `~/texmf/scripts/wordcloud/`.

### With MikTEX and Windows

These two systems are unknown to the author of Wordcloud, 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

* metapost-colorbrewer 
* latexmp 
* luamplib 
* xcolor
## Documentation

* [English documentation](doc/wordcloud-doc-en.pdf)

## Contact

Maxime Chupin, `notezik(at)gmail.com`

## Licenses

This projet is under LATEX Project Public License 1.3c.