%% 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}
