summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/xkcdcolors/README.md
blob: 2b1d7a85283a2c20705c635ea02a0de5285e8a52 (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
## Package `xkcdcolors` for LaTeX

In the year 2010, Randall Munroe on [posted a really fun and nice article](https://blog.xkcd.com/2010/05/03/color-survey-results/)  on the iconic web of [xkcd](https://xkcd.com/).
He did a very curious experiment: showing colors to a lot of people and asking to name each one.

Afterward, he processed the data and sorted the names for each color by popularity --- that means, how many people gave the same name to the same color (no guidance here! Read the post linked above for details).

He obtained a nice list of around 950 color names. It's not at all surprising that a lot of people forged `CloudyBlue`, but some color is really surprising, like for example `BabyPoopGreen` or `DullPink`...

### DOCUMENTATION

See the included file `xkcdcolors-manual.tex`; you can compile it running (twice) `pdflatex` on it. If you want to have a look, you can find a compiled copy on the [release page](https://github.com/Rmano/xkcdcolors/releases) or on [CTAN](https://www.ctan.org/pkg/xkcdcolors).

If you have already installed the package in your TeX distribution, use `texdoc xkcdcolors`; it should show you the manual of the installed version of the package.

To search for a color in a fast way, at least on Unix or on a compatible `bash` shell, you can use the following command:

```bash
[romano:~] % grep -i duck  $(kpsewhich xkcdcolors.sty)
    DuckEggBlue,C3FBF4;%
```

### Links

A very interesting link about "ordering" the 900+ colors here is [this one on Wolfram Community](https://community.wolfram.com/groups/-/m/t/434022?sortMsg=Flat); well worth a look.

### AUTHOR

Romano Giannetti `romano.giannetti@gmail.com`

### LICENSE

This package use Randall Munroe's file [rgb.txt](https://xkcd.com/color/rgb.txt) which is distributed under [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/). You can use that license or [LPPL 1.3c](https://www.latex-project.org/lppl/lppl-1-3c/)

### SOURCE REPO

The source is hosted on [GitHub](https://github.com/Rmano/xkcdcolors).
If you clone the repository, you can use

    make local-install

to install the package on [your local TEXMF tree](https://tex.stackexchange.com/questions/1137/where-do-i-place-my-own-sty-or-cls-files-to-make-them-available-to-all-my-te).