%% lato.tex
%% Copyright 2010 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[utf8x]{inputenc}
\usepackage[default]{lato}
\usepackage{microtype}
\usepackage{multirow}
\usepackage{path}
\usepackage{relsize}
\usepackage[colorlinks]{hyperref}

\hypersetup{%
  pdftitle={LaTeX support for Lato},%
  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 Lato\\\relsize{-1}Version~1.0}

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

\begin{document}

\maketitle

\tableofcontents

\section{Introduction}

Lato is a sanserif typeface family designed in the Summer 2010 by Warsaw-based
designer Łukasz \name{Dziedzic} for the tyPoland foundry. This font, which
includes five weights ({\flafamily\fontseries{ul}\selectfont hairline},
{\flafamily\fontseries{l}\selectfont light},
{\flafamily\fontseries{m}\selectfont regular},
{\flafamily\fontseries{b}\selectfont bold} and
{\flafamily\fontseries{eb}\selectfont black}), is available from the Google Font
Directory~\cite{lato} as TrueType files under the \acronym{OFL} version~1.1.

This package provides support for this font 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}.

\section{Installation}

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

Once the \path|lato.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 lato.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 Lato}

You can use the Lato font in a \LaTeX{} document by adding the command
\begin{verbatim}
\usepackage{lato}
\end{verbatim}
to the preamble. The package supplies the \code{\char`\\flafamily} command to
switch the current font to Lato.

\subsubsection{Options}

\paragraph{Lato as default (sans-serif) font}

You can set \LaTeX{} to use Lato as standard font throughout the whole document
by passing the \code{default} option to the package:
\begin{verbatim}
\usepackage[default]{lato}
\end{verbatim}
To set Lato as default sans-serif only:
\begin{verbatim}
\usepackage[defaultsans]{lato}
\end{verbatim}

\paragraph{Default weight}

The following options specify which weight of the font you prefer to use:
\begin{center}
  \begin{tabular}{ll}
    \toprule
    \code{regular}&{\flafamily\fontseries{m}\selectfont use regular face}\\
    \midrule
    \code{light}&{\flafamily\fontseries{l}\selectfont use light face}\\
    \bottomrule
  \end{tabular}
\end{center}
The \code{medium} option is enabled by default.

\paragraph{Default bold weight}

The following options specify which weight of the font you prefer to use for
bold texts:
\begin{center}
  \begin{tabular}{ll}
    \toprule
    \code{bold}&{\flafamily\fontseries{b}\selectfont use bold face}\\
    \midrule
    \code{black}&{\flafamily\fontseries{eb}\selectfont use black face}\\
    \bottomrule
  \end{tabular}
\end{center}
The \code{bold} option is enabled by default.

\paragraph{Font scaling}

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

\subsection{Encodings}

The following encodings are supported:
\begin{center}
  OT1, T1, TS1 (partial)
\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{lato}
\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&To Ta Té\\
    \midrule
    T1-encoded&\fontencoding{T1}\selectfont To Ta Té\\
    \bottomrule
  \end{tabular}
\end{center}
It is therefore advised to always use the Lota 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
    \multirow{3}{*}{fla}&\multirow{2}{*}{OT1, T1}&\multirow{2}{*}{m, b (bx), eb, l, ul}&n, it (sl)\\
    &&&sc, scit (scsl)\\
    \cmidrule{2-4}
    &TS1&m, b (bx), eb, l, ul&n, it (sl)\\
    \bottomrule
  \end{tabular}
\end{center}
Notice that the small capitals are faked ones (reduced to 80\%).

\section{Known bugs and improvements}

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

\subsection{Small dotless ``j''}

The Lato font files do not provide any dotless ``j'' glyph. This \LaTeX{}
support provides a faked one ({\flafamily\j}), available by typing
\code{\char`\\j}, and built using the \command{t1dotlessj} command (from
LCDF~Typetools~\cite{lcdf}).

\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 Open Font License version~1.1~\cite{ofl}.

\begin{thebibliography}{9}
\bibitem{lato} \url{http://code.google.com/webfonts/family?family=Lato}
\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{lcdf} \url{http://www.lcdf.org/type/}
\bibitem{lppl} \url{http://www.latex-project.org/lppl/lppl-1-3c.html}
\bibitem{ofl} \url{http://scripts.sil.org/OFL_web}
\end{thebibliography}

\end{document}
