summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/synthslant/README.md
blob: efc20fd37ee8a06d3e9f3e27692f750a105518bb (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
![distcheck status](https://github.com/cspiel/synthslant/actions/workflows/distcheck.yml/badge.svg)


#  SynthSlant – Synthetic slanting of glyphs

LaTeX package `synthslant` slants short pieces of text to the right or to the left.


##  Installation

The minimally necessary files to install synthslant are *synthslant.ins* and *synthslant.dtx*.
Running LaTeX on *synthslant.ins* in particular produces *synthslant.sty*:

        latex synthslant.ins

After extraction from *synthslant.dtx* place *synthslant.sty* in a directory mentioned in your
TEXINPUTS paths or copy it into one of the directories for your LaTeX installation's *sty*-files
and run **mktexlsr** or equivalent.

To build the documentation it is easier to use the GNU *Makefile*:

        make

LuaLaTeX users will want to override the default LaTeX command **pdflatex** with **lualatex** by
saying

        make LATEX=lualatex

To construct the manual *synthslant.pdf* a working [MetaPost](https://tug.org/metapost.html)
installation is required.  Moreover, besides the usual POSIX utilities
[**base64**](https://www.gnu.org/software/coreutils/manual/html_node/base64-invocation.html) is
needed to recover the graphics file stored as printable ASCII characters inside of
*synthslant.dtx*.  Cautious users can run

        make tool-check

ahead to verify that the required utilities are installed and working.
For an overview over the most important *Makefile* targets use

        make help


##  Usage

Load the package with the usual incantation

        \usepackage{synthslant}

See Section 2 of the package documentation for available options.


##  Documentation

The package documentation can be found
[online](https://cspiel.github.io/synthslant/).


##  Credits

Synthslant is written by Ch. L. Spiel <cspiel@users.sourceforge.org>.


##  License

Released under the
[LaTeX Project Public License v1.3c](https://www.latex-project.org/lppl.txt)
or later.