summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/fonts/inconsolata/inconsolata.tex
blob: a985b9f85f4642585f094924490ff5b46ec6b44b (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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
% Public domain.
\documentclass[11pt]{article}

\usepackage{graphicx}
\usepackage{pdfpages}
\usepackage{url}

% Don't require entries in the system map files (but do require pdftex).
\pdfmapfile{+fi4.map}
\usepackage{inconsolata}

\title{Inconsolata: \TeX\ support\thanks{This documentation is released
to the public domain.}}

\author{Karl Berry ({\tt karl@freefriends.org})}

\begin{document}

\maketitle

Inconsolata is a monospaced (``typewriter'') font designed by Raph
Levien.  (It is used for the typewriter material throughout this
document.)  The location on CTAN for this packaging of the font with
\TeX\ support is \url{http://mirror.ctan.org/fonts/inconsolata}.

Raph's web page for it is
\url{http://levien.com/type/myfonts/inconsolata.html}.  Raph discussed
its design principles and his working methods in an interview, which is
available online at \url{http://tug.org/interviews}.  Its development is
ongoing.

Please send questions and suggestions about the \TeX\ support to Karl
(address above), not Raph.  Raph only distributes the OpenType and
Type~1 font files themselves.

\section{Encodings}

Inconsolata has good support for Latin, including commonly-used \TeX\
encodings.  Unfortunately there are a plethora of naming conventions
surrounding encodings.  This package follows the Latin Modern
(\url{http://mirror.ctan.org/tex-archive/fonts/lm}) names for the TFM
files.

This table shows the TFM name, corresponding \LaTeX\ encoding name, and
a description.

\smallskip
\halign{\tt#\quad\hfil &\tt#\quad\hfil &#\hfil\cr
ec-inconsolata.tfm       & T1  & Cork \cr
ei1-inconsolata.tfm      & EI1 & experimental/extra glyphs \cr
qx-inconsolata.tfm       & QX  & Polish \cr
rm-inconsolata.tfm       & OT1 & Computer Modern typewriter \cr
texnansi-inconsolata.tfm & LY1 & Windows ANSI \cr
ts1-inconsolata.tfm      & TS1 & text symbols (incomplete) \cr
}

To use one or another encoding, give the \LaTeX\ name to the
\texttt{fontenc} package as usual, as in:

\begin{verbatim}
\usepackage[T1]{fontenc}
\usepackage{inconsolata}
\end{verbatim}

The \texttt{EI1} encoding deserves a few words of explanation.  Raph
designed various glyphs which do not appear in any of the usual \TeX\
encodings above; \texttt{EI1} provides access to these.  There are no
named commands for them, just use \verb|\char| and enjoy.  For the glyph
names, see the file \url{fi4-ei1.enc}.


\section{\LaTeX\ usage}

Here is a minimal \LaTeX\ document showing the use of Inconsolata:

\begin{verbatim}
\documentclass{article}
\usepackage{inconsolata}
\begin{document}
\texttt{This is Inconsolata.}
\end{document}
\end{verbatim}

Thus, loading \url{inconsolata.sty} redefines the \verb|\tt| font.
The optional \texttt{[nott]} argument prevents this redefinition, say
for testing.  Then there is no way to access the font with the usual
\LaTeX\ commands.

The other package option is \texttt{[scaled=R]}, which scales the font
according to $R$; the default is 1.0 for no scaling (this document
itself does not specify any scaling).  Here's an example:

\begin{verbatim}
\usepackage[scaled=.95]{inconsolata}
\end{verbatim}

The \url{inconsolata.sty} package loads the \url{textcomp} and
\url{xkeyval} packages, if they are not already loaded.  The former is
what makes \verb|\texteuro| and the like work, and the latter is how
\url{inconsolata} parses its options.


\section{Plain \TeX\ usage}

The TFM names were given in the preceding table.  So, for example:

\begin{verbatim}
\font\tentt = rm-inconsolata  % use inconsolata instead of cmtt
{\tt This is Inconsolata.}
\end{verbatim}

As usual with plain \TeX, any other (re)definitions are strictly up to
you.  This package makes no attempt to hook into any of the various font
packages for plain, such as plnfss
(\url{http://tug.ctan.org/pkg/plnfss}).

\section{X usage}

If you want to use Inconsolata in X, such as in xterm windows, and your
system does not provide a package for it, it is straightforward to set
up yourself:

\begin{verbatim}
cp Inconsolata.otf /some/dir
mkfontscale /some/dir  # create fonts.scale
mkfontdir /some/dir    # create fonts.dir from fonts.scale
xset +fp /some/dir     # tell the X server to use it
xlsfonts | grep inconsolata  # see if it's there
\end{verbatim}


\section{Dotless \j\ and LY1}

For reasons I don't want to go into here, the \verb|\j| command does not
work with the LY1 encoding.  Perhaps it will be fixed one day.
Meanwhile, the glyph itself is available at the standard position (in
LY1) of \texttt{0x11} in \texttt{texnansi-inconsolata.tfm}.


\section{Font tables}

The rest of this document are the font tables for the various encodings,
generated by the file \url{test.tex} in this distribution.  The type
size is somewhat large simply for ease of inspection of the characters.

Happy typesetting.

% too bad we can't say "all pages but the last".
\includepdf[pages=-6]{test.pdf}

\end{document}