summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/xcolor/README.md
blob: dd8e528ccd499f202e366328a30d2ddef95d98c3 (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
## Package `xcolor` by Dr. Uwe Kern

Version 2022-06-12 v2.14

Maintained by the LaTeX Project https://github.com/latex3/xcolor/issues

`xcolor` provides easy driver-independent access to several kinds of
colors, tints, shades, tones, and mixes of arbitrary colors by means of
color expressions like \color{red!50!green!20!blue}.
It allows to select a document-wide target color model and offers tools
for automatic color schemes, conversion between nine color models,
alternating table row colors, color blending and masking, color
separation, and color wheel calculations.

## Copyright (C)
- 2003-2021    Dr. Uwe Kern 
- 2021-2022    The LaTeX Project 

## License
LaTeX Project Public License, version 1.3c or later.

## Installation instructions

* Extract all package files:
  
  ~~~~
  latex xcolor.ins
  ~~~~

* Put the generated files to their respective locations
within the TeX installation:

  ~~~~
  *.sty -> /tex/latex/xcolor/
  *.def -> /tex/latex/xcolor/
  *.pro -> /dvips/xcolor/
  ~~~~

* Create the documentation:

  ~~~~ 
  latex xcolor.dtx
  latex xcolor.dtx
  makeindex -s gind.ist xcolor.idx
  latex xcolor.dtx
  latex xcolor.dtx
  ~~~~
  
* Run the test files (N=1,2,...):

  ~~~~
  latex xcolorN.tex
  latex xcolorN.tex
  ~~~~

## Notes

- `xcolor1.tex` should run with both LaTeX and pdfLaTeX, it yields a
  50-page document with several systematic color conversion examples
- `xcolor2.tex` is a 3-page `pstricks` example document that won't run
  with pdfLaTeX
- `xcolor3.tex` is a 2-page example for demonstrating several display
  and logging facilities
- `xcolor4.tex` is a 1-page driver test file;
  uncomment the relevant code line in the header and run it with the
  appropriate program, e.g., `latex xcolor4` or any other processor;
  apply any desired post-processing like dvips, dvipdfm, etc.
- If the file `xcolor.ins` is missing, run `latex xcolor.dtx` once
  and quit the LaTeX compiler as soon as the first error message
  appears.

## History

See file `ChangeLog`.