summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pgf-cmykshadings/README.md
blob: 81c05b45e67aeb6b415cefbd881a9ba726227ea7 (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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
# pgf-cmykshadings — Support for CMYK and grayscale shadings in PGF/TikZ

The `pgf-cmykshadings` package provides support for CMYK and grayscale shadings
for the `pgf` package. By default `pgf` only supports RGB shadings. Horizontal,
vertical, radial, and functional shadings are supported for pdfLaTeX, LuaLaTeX,
and XeLaTeX. `pgf-cmykshadings` attempts to produce shadings consistent with
the currently selected `xcolor` colour model. The `rgb`, `cmyk`, and `gray`
colour models from the `xcolor` package are supported.

## Installation from TeXLive or MiKTeX

`pgf-cmykshadings` is in TeXLive and MiKTeX and can be installed in the usual
way through your distribution. e.g., in TeXLive by running:

```
tlmgr install pgf-cmykshadings
```

## Installation from CTAN

Download and unpack `pgf-cmykshadings.zip` from CTAN at
https://ctan.org/pkg/pgf-cmykshadings

Change to the `pgf-cmykshadings` directory, then run:

```
tex pgf-cmykshadings.ins
```

to generate `pgf-cmykshadigns.sty`, `pgfsys-cmykshadings-pdftex.def`,
`pgfsys-cmykshadings-xetex.def`, `pgfsys-cmykshadings-luatex.def`, and
`pgfsys-cmykshadings-dvipdfmx.def`.

Copy these generated files to `$TEXMFHOME/tex/latex/pgf-cmykshadings/` and
`pgf-cmykshadings.pdf` to `$TEXMFHOME/doc/latex/pgf-cmykshadings/`.

You can find `$TEXMFHOME` by running:

```
kpsewhich -var-value=TEXMFHOME
```

## Installation from Git Source

`pgf-cmykshadings` uses the `l3build` system.

Clone the git repository using:

```
git clone https://github.com/dcpurton/pgf-cmykshadings.git
```

Change to the `pgf-cmykshadings` directory, and then the package can be
installed by running:

```
l3build install
```

Documentation (`pgf-cmykshadings.pdf`) can be compiled by running:

```
l3build doc
```

To install the documentation, copy `pgf-cmykshadings.pdf` to
`$TEXMFHOME/doc/latex/pgf-cmykshadings/`.

You can find `$TEXMFHOME` by running:

```
kpsewhich -var-value=TEXMFHOME
```

## Licence

```
Copyright (c) 2018 David Purton <dcpurton@marshwiggle.net>

This work may be distributed and/or modified under the conditions of
the LaTeX Project Public License, either version 1.3c of this license
or (at your option) any later version. The latest version of this
license is in
   http://www.latex-project.org/lppl.txt
and version 1.3c or later is part of all distributions of LaTeX
version 2005/12/01 or later.

This work is "maintained" (as per the LPPL maintenance status)
by David Purton.

This work consists of the files pgf-cmykshadings.ins,
pgf-cmykshadings.dtx, README.md, and the derived files
  - pgf-cmykshadings.sty
  - pgfsys-cmykshadings-pdftex.def
  - pgfsys-cmykshadgins-xetex.def
  - pgfsys-cmykshadings-luatex.def
  - pgfsys-cmykshadings-dvipdfmx.def
  - pgf-cmykshadings.pdf


Substantial parts of the code for this package are taken from the pgf
package files pgfcoreshade.code.tex, pgfsys-pdftex.def,
pgfsys-luatex.def, and pgfsys-dvipdfmx.def copyright (c) 2006 Till
Tantau and then slightly modified to support CMYK and grayscale
shadings.
```