Debian Codegraph @

texmf-dist/doc/latex/xcolor/README.md

raw
1 ## Package `xcolor` by Dr. Uwe Kern
2
3 Version 2024-09-29 v3.02
4
5 Maintained by the LaTeX Project https://github.com/latex3/xcolor/issues
6
7 `xcolor` provides easy driver-independent access to several kinds of
8 colors, tints, shades, tones, and mixes of arbitrary colors by means of
9 color expressions like \color{red!50!green!20!blue}.
10 It allows to select a document-wide target color model and offers tools
11 for automatic color schemes, conversion between nine color models,
12 alternating table row colors, color blending and masking, color
13 separation, and color wheel calculations.
14
15 ## Copyright (C)
16 - 2003-2021 Dr. Uwe Kern
17 - 2021-2024 The LaTeX Project
18
19 ## License
20 LaTeX Project Public License, version 1.3c or later.
21
22 ## Installation instructions
23
24 * Extract all package files:
25
26 ~~~~
27 latex xcolor.ins
28 ~~~~
29
30 * Put the generated files to their respective locations
31 within the TeX installation:
32
33 ~~~~
34 *.sty -> /tex/latex/xcolor/
35 *.def -> /tex/latex/xcolor/
36 *.pro -> /dvips/xcolor/
37 ~~~~
38
39 * Create the documentation:
40
41 ~~~~
42 latex xcolor.dtx
43 latex xcolor.dtx
44 makeindex -s gind.ist xcolor.idx
45 latex xcolor.dtx
46 latex xcolor.dtx
47 ~~~~
48
49 * Run the test files (N=1,2,...):
50
51 ~~~~
52 latex xcolorN.tex
53 latex xcolorN.tex
54 ~~~~
55
56 ## Notes
57
58 - `xcolor1.tex` should run with both LaTeX and pdfLaTeX, it yields a
59 50-page document with several systematic color conversion examples
60 - `xcolor2.tex` is a 3-page `pstricks` example document that won't run
61 with pdfLaTeX
62 - `xcolor3.tex` is a 2-page example for demonstrating several display
63 and logging facilities
64 - `xcolor4.tex` is a 1-page driver test file;
65 uncomment the relevant code line in the header and run it with the
66 appropriate program, e.g., `latex xcolor4` or any other processor;
67 apply any desired post-processing like dvips, dvipdfm, etc.
68 - If the file `xcolor.ins` is missing, run `latex xcolor.dtx` once
69 and quit the LaTeX compiler as soon as the first error message
70 appears.
71
72 ## History
73
74 See file `ChangeLog`.