summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/droid/droid.tex
blob: 4c178595eaae485fd5386673b044c83163d53f1b (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
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
%% droid.tex
%% Copyright 2010, 2011 Mohamed El Morabity
% 
% This work may be distributed and/or modified under the conditions of the LaTeX
% Project Public License, either version 1.3 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.3 or later is part of all
% distributions of LaTeX version 2005/12/01 or later.
% 
% This work has the LPPL maintenance status `maintained'.
% 
% The Current Maintainer of this work is Mohamed El Morabity
% 
% This work consists of all files listed in manifest.txt.

\documentclass{article}

\usepackage[american]{babel}
\usepackage{booktabs}
\usepackage{droid}
\usepackage[utf8x]{inputenc}
\usepackage{microtype}
\usepackage{multirow}
\usepackage{path}
\usepackage{relsize}
\usepackage[colorlinks]{hyperref}

\hypersetup{%
  pdftitle={LaTeX support for Droid},%
  pdfauthor={Mohamed El Morabity}%
}%

\newcommand{\acronym}[1]{\textsc{\lowercase{#1}}}
\newcommand{\code}{\texttt}
\newcommand{\command}{\texttt}
\newcommand{\email}[1]{\href{mailto:#1}{\nolinkurl{#1}}}
\newcommand{\name}{}
\newcommand{\package}{\texttt}
\newcommand{\parameter}[1]{\textnormal{\textit{#1}}}
\newcommand{\program}{}

\title{\LaTeX{} support for Droid\\\relsize{-1}Version~1.2}

\author{Mohamed \name{El~Morabity}\\\email{melmorabity@fedoraproject.org}}

\begin{document}

\maketitle

\tableofcontents

\section{Introduction}

The Droid typeface family was designed in the fall of 2006 by Ascender's Steve
\name{Matteson}, as a commission from Google to create a set of system fonts for
its Android platform. The goal was to provide optimal quality and comfort on a
mobile handset when rendered in application menus, web browsers and for other
screen text. The Droid family of fonts consists of {\fdrfamily Droid Serif},
{\fdsfamily Droid Sans} and {\fdmfamily Droid Sans Mono}, licensed under the
Apache License version~2.0, and available in the Android \program{Git}
tree~\cite{droid} as TrueType files.

This package provides support for this font family in \LaTeX{}. It includes the
original TrueType fonts, as well as Type~1 versions, converted for this package
using \program{FontForge} for full support with \program{Dvips}.

Notice that this package does not support the Droid Pro family sold by
Ascender~\cite{droidpro}.

\section{Installation}

These directions assume that your \TeX{} distribution is
\acronym{TDS}-compliant.

Once the \path|droid.zip| archive extracted:
\begin{enumerate}
\item Copy \path|doc/|, \path|fonts/|, \path|source/|, and \path|tex/|
  directories to your \path|texmf/| directory (either your local or global
  \path|texmf/| directory).
\item Run \command{mktexlsr} to refresh the file name database and make \TeX{}
  aware of the new files.
\item Run \command{updmap --enable Map droid.map} to make \program{Dvips},
  \program{dvipdf} and \program{pdf\TeX} aware of the new fonts.
\end{enumerate}

Note that this package requires the \package{keyval}~\cite{keyval} and
\package{slantsc}~\cite{slantsc} (to handle italic/slanted small caps) ones to
work.

\section{Usage}

\subsection{Calling Droid}

Several macro packages are provided to use these font
families with \LaTeX:
\begin{center}
  \begin{tabular}{llll}
    \toprule
    font name&family&package&switch command\\
    \midrule
    Droid Serif&fdr&\package{droidserif}&\code{\char`\\fdrfamily}\\
    Droid Sans&fds&\package{droidsans}&\code{\char`\\fdsfamily}\\
    Droid Sans Mono&fdm&\package{droidmono}&\code{\char`\\fdmfamily}\\
    \bottomrule
  \end{tabular}
\end{center}
For each family package, the provided commands \code{\char`\\fdrfamily},
\code{\char`\\fdsfamily} and \code{\char`\\fdmfamily} will switch the current
font to Droid Serif, Droid Sans and Droid Sans Mono respectively. You need not
necessarily use all three font families together (even though this is supported,
see below).

\subsubsection{Using the Droid font families together}

To make the use of the three Droid fonts families together most easy, a further
macro package \package{droid} is provided:
\begin{verbatim}
\usepackage{droid}
\end{verbatim}
This will set Droid Serif, Droid Sans and Droid Sans Mono as the three main text
font families.

\subsubsection{Using each font family separately}

You can set \LaTeX{} to use Droid Serif only as standard font throughout the
whole document by passing the \code{default} option to the \package{droidserif}
package:
\begin{verbatim}
\usepackage[default]{droidserif}
\end{verbatim}

As well, you can set \LaTeX{} to use Droid Sans as standard font with the
\code{default} option to the \package{droidsans} package:
\begin{verbatim}
\usepackage[default]{droidsans}
\end{verbatim}
To set Droid Sans as default sans-serif only:
\begin{verbatim}
\usepackage[defaultsans]{droidsans}
\end{verbatim}

Finally, to set Droid Sans Mono as the default typewriter font:
\begin{verbatim}
\usepackage[defaultmono]{droidmono}
\end{verbatim}

\paragraph{Font scaling}

The font can be up- and downscaled by any factor. This can be used to make the
Droid fonts more friendly when used in company with other type faces, e.g., to
adapt the x-height. The package option \code{scaled=\parameter{ratio}} will
scale the font according to \parameter{ratio} (1.0 by default), for example:
\begin{verbatim}
\usepackage[scaled=0.95]{droidserif}
\usepackage[scaled=0.95]{droidsans}
\usepackage[scaled=0.95]{droidmono}
\end{verbatim}

\subsection{Encodings}

The following encodings are supported:
\begin{center}
  \begin{tabular}{ll}
    \toprule
    Latin&OT1, T1, TS1 (partial)\\
    \midrule
    Cyrillic&T2A, T2B, T2C, X2\\
    \midrule
    Greek&LGR\\
    \bottomrule
  \end{tabular}
\end{center}
To use one or another encoding, give the \LaTeX{} name to the \package{fontenc}
package as usual, as in
\begin{verbatim}
\usepackage[T1]{fontenc}
\usepackage{droid}
\end{verbatim}

Note that, as usual with OT1 encoded fonts, kerning with accented characters is
treated poorly, if at all. Note difference in kerning between e.g.
\begin{center}
  \begin{tabular}{ll}
    \toprule
    OT1-encoded&{\fdsfamily To Ta Té}\\
    \midrule
    T1-encoded&{\fontencoding{T1}\selectfont\fdsfamily To Ta Té}\\
    \bottomrule
  \end{tabular}
\end{center}
It is therefore advised to always use the Droid fonts in any encoding than OT1
when typing diacritics.

\subsection{Available weights and variants}

The following table lists the available font series and shapes with their
\acronym{NFSS} classification. Parenthesized combinations are provided via
substitutions.
\begin{center}
  \begin{tabular}{llll}
    \toprule
    family&encoding&series&shape\\
    \midrule
    \fdrfamily\multirow{4}{*}{fdr}&OT1, T1,&\multirow{3}{*}{m, b (bx)}&\multirow{2}{*}{n, it, sl, up}\\
    &T2A, T2B, T2C, X2,&&\multirow{2}{*}{sc, scit, scsl, scup}\\
    &LGR&&\\
    \cmidrule{2-4}
    &TS1&m, b (bx)&n, it, sl, up\\
    \midrule
    \multirow{4}{*}{fds}&OT1, T1,&\multirow{3}{*}{m, b (bx)}&\multirow{2}{*}{n, sl (it)}\\
    &T2A, T2B, T2C, X2,&&\multirow{2}{*}{sc, scsl (scit)}\\
    &LGR&&\\
    \cmidrule{2-4}
    &TS1&m, b (bx)&n, sl (it)\\
    \midrule
    \multirow{4}{*}{fdm}&OT1, T1,&\multirow{3}{*}{m}&\multirow{2}{*}{n, sl (it)}\\
    &T2A, T2B, T2C, X2,&&\multirow{2}{*}{sc, scsl (scit)}\\
    &LGR&&\\
    \cmidrule{2-4}
    &TS1&m&n, sl (it)\\
    \bottomrule
  \end{tabular}
\end{center}
Notice that the slanted shapes are faked ones for Droid Sans and Droid Sans
Mono, as well as the upright shape for Droid Serif and the small capitals for
all the families (reduced to 80\%).

\section{Known bugs and improvements}

Please send bug reports and suggestions about the Droid \LaTeX{} support to
\href{mailto:melmorabity@fedoraproject.org}{Mohamed \name{El~Morabity}}.

\section{License}

This package is released under the \LaTeX{} project public license, either
version~1.3c or above~\cite{lppl}. Anyway both the TrueType and Type~1 files are
delivered under the Apache License Version~2.0~\cite{asl}.

\begin{thebibliography}{9}
\bibitem{droid}
  \url{http://android.git.kernel.org/?p=platform/frameworks/base.git;a=tree;f=data/fonts}
\bibitem{droidpro} \url{http://www.DroidFonts.com/}
\bibitem{keyval}
  \url{http://www.ctan.org/tex-archive/macros/latex/required/graphics/}
\bibitem{slantsc}
  \url{http://www.ctan.org/tex-archive/macros/latex/contrib/slantsc/}
\bibitem{lppl} \url{http://www.latex-project.org/lppl/lppl-1-3c.html}
\bibitem{asl} \url{http://www.apache.org/licenses/LICENSE-2.0.html}
\end{thebibliography}

\end{document}