%% Copyright 2011 Pavel Farar
%
% 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 Pavel Farar


\documentclass[oneside]{scrartcl}

\usepackage[utf8]{inputenc}
\usepackage[czech, english]{babel}
\usepackage[IL2, T1]{fontenc}
\usepackage{PTSerif}
\usepackage{textcomp}
\usepackage[colorlinks]{hyperref}
\hypersetup{pdfauthor={Pavel Farar}}

\setkomafont{sectioning}{\rmfamily\bfseries}

\title{Support package for PT Serif}
\author{Pavel Farář\\
\href{mailto:pavel.farar@centrum.cz}{pavel.farar@centrum.cz}}

\begin{document}

\selectlanguage{english}%

\maketitle

\tableofcontents

\section{Introduction}

This package contains the LaTeX support for the font PT Serif developed by
ParaType for the project \emph{Public Types of Russian Federation} and
released under an open user license. The font was designed by Alexandra
Korolkova, Olga Umpeleva and Vladimir Yefimov. For more information see the
web-site of \href{http://www.paratype.com}{ParaType}.


PT Serif has four basic styles:
regular, \textbf{bold}, \textit{italic}, \textbf{\textit{bold italic}}
and two caption styles:
{\usefont{T1}{PTSerifCaption-TLF}{m}{n}caption} and
{\usefont{T1}{PTSerifCaption-TLF}{m}{it}caption italic}.
The font covers standard Western, Central European and Cyrillic code
pages and contains also characters of all title languages of Russian
Federation.

This package supports encodings T1, OT1, IL2, TS1, T2A, T2B, T2C and X2.
If there is some important encoding missing, let me know and I will try
to add it to some future release.

The fonts are included in the original TrueType format and in the converted
Type 1 format.

Font PT Serif can be used together with the font PT Sans.


\section{License}

The font PT Serif is licensed under Paratype Free Font License (the license
is included).

The fonts in TrueType format are original files provided by ParaType. The
fonts in Type 1 format are not original files. They were converted by me
using FontForge and may be distributed for \TeX\ only. The distribution of
these converted fonts was kindly allowed by ParaType.

All the support files are licensed under \LaTeX Project Public License,
either version 1.3 of this license or (at  your option) any later version.


\section{Implementation}

The package was created using \emph{fontools} but with some changes.
The prefix of the encoding files was changed from \emph{a\_} to
\emph{ptserif\_} to avoid name clashes.
The style files are very different and font definition files include
also font substitutions.

There are two map-files that you can use for the installation of the fonts
with \emph{updmap}: \emph{PTSerif-truetype.map} and \emph{PTSerif-type1.map}.
You should use just one of them. The file \emph{PTSerif-type1.map} is a safe
choice and you will get the full power of \TeX. If you just want to create PDF
files with pdf\TeX\ or pdf\LaTeX\ you can use the file
\emph{PTSerif-truetype.map} and the original TrueType fonts will be used.


\section{Using the Package}

There are two families PTSerif-TLF and PTSerifCaption-TLF
that you can set with packages PTSerif and PTSerifCaption. You
must explicitly use the package \emph{fontenc} or \emph{textcomp} (if needed).
For example:
\begin{verbatim}
\usepackage[T1]{fontenc}
\usepackage{PTSerif}
\end{verbatim}

If you want to use this font together with another font with somewhat different
proportions, you may use the option \emph{scaled}:
\begin{verbatim}
\usepackage[scaled=0.9]{PTSerif}
\end{verbatim}

You might also want to change the default font family of the document:
\begin{verbatim}
\renewcommand{\familydefault}{\sfdefault}
\end{verbatim}

You can typeset some text in a desired font like this:
\begin{verbatim}
{\usefont{T1}{PTSerifCaption-TLF}{m}{it}Text in caption italic font}
\end{verbatim}


\section{Notes for Czech and Slovak Users}

The width of these letters in the encoding IL2 was changed: Lcaron
in PT Serif Bold and PT Serif Bold Italic and tcaron in PT Serif Bold.
Now all letters dcaron, tcaron, lcaron and Lcaron have the same width
as the unaccented letter. The encoding T1 was left untouched. You can
see the differences in the following samples (first line is in T1 and
second in IL2).


\selectlanguage{czech}
V kódování IL2 byla změněna šířka znaku Ľ ve fontech PT Serif Bold a
PT Serif Bold Italic, dále šířka znaku ť ve fontu PT Serif Bold. Nyní mají
všechny znaky ď, ť, ľ a Ľ stejnou šířku jako tytéž znaky bez háčku. Kódování
T1 bylo ponecháno beze změny. Rozdíly je možno vidět v následujících ukázkách
(první řádka je pro kódování T1, druhá pro IL2).

{\Huge%
\begin{tabular}{llllll}%
{\usefont{T1}{PTSerif-TLF}{b}{n}Ľubomír} &
{\usefont{T1}{PTSerif-TLF}{b}{it}Ľubomír} &
{\usefont{T1}{PTSerif-TLF}{b}{n}šťovík} &
{\usefont{T1}{PTSerif-TLF}{b}{n}laťka}\\
{\usefont{IL2}{PTSerif-TLF}{b}{n}Ľubomír} &
{\usefont{IL2}{PTSerif-TLF}{b}{it}Ľubomír} &
{\usefont{IL2}{PTSerif-TLF}{b}{n}šťovík} &
{\usefont{IL2}{PTSerif-TLF}{b}{n}laťka}
\end{tabular}}


\selectlanguage{english}


\section{Known Bugs}

The caption styles are independent font family. It is your choice 
where you will use them.

I put letters \emph{Cyrillic letter short I with tail} and \emph{Cyrillic
letter EM with tail} to the slots where the same letters but with descender
should be. They are somewhat similar and some languages should use exactly
these letters. I think it is better than leaving the slots empty.

Please \href{mailto:pavel.farar@centrum.cz}{send me} bug reports and
suggestions about this package.

\end{document}
