summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/sourcesanspro/sourcesanspro.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-01-02 22:55:28 +0000
committerKarl Berry <karl@freefriends.org>2013-01-02 22:55:28 +0000
commitcf728e5f5be451f9219e15a4acc2337d9ebc65f3 (patch)
treeef4e9a2c2d655fd9e384eace0ac87c3557b8bc10 /Master/texmf-dist/doc/latex/sourcesanspro/sourcesanspro.tex
parent120aa6671f32d669b6b002d2a1537b9bbe2356fb (diff)
sourcesanspro (2jan13)
git-svn-id: svn://tug.org/texlive/trunk@28694 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/sourcesanspro/sourcesanspro.tex')
-rw-r--r--Master/texmf-dist/doc/latex/sourcesanspro/sourcesanspro.tex157
1 files changed, 123 insertions, 34 deletions
diff --git a/Master/texmf-dist/doc/latex/sourcesanspro/sourcesanspro.tex b/Master/texmf-dist/doc/latex/sourcesanspro/sourcesanspro.tex
index 666b3863f78..4a3a7cb875d 100644
--- a/Master/texmf-dist/doc/latex/sourcesanspro/sourcesanspro.tex
+++ b/Master/texmf-dist/doc/latex/sourcesanspro/sourcesanspro.tex
@@ -1,7 +1,7 @@
\documentclass[11pt,a4paper,english]{article}
\usepackage{geometry,dtklogos,hyperref,babel,mdwlist,array,multicol}
-\usepackage[default,osf]{sourcesanspro-otf}
-\usepackage[scaled=.95]{sourcecodepro-otf}
+\usepackage[default,osf]{sourcesanspro}
+\usepackage[scaled=.95]{sourcecodepro}
\hypersetup{
colorlinks,
@@ -17,60 +17,110 @@
\Large Adobe's Source Sans Pro typeface for \LaTeX
}
\author{Silke Hofstra, \href{mailto:silke@slxh.nl}{silke@slxh.nl}}
+\date{Documentation for sourcesanspro v2.0.\\ \today}
\begin{document}
\maketitle
\begin{multicols}{2}
This package provides the Source Sans Pro font in an easy to use way. For \XeLaTeX\ and \LuaLaTeX\ users the original OpenType fonts are used. The entire font family is included. It can also be downloaded from \href{https://github.com/adobe/source-sans-pro}{Github}.
-\section{Packages}
-The packages that can be used are:
-\begin{itemize*}
- \item \textbf{sourcesanspro}:\\
- Loads either \texttt{sourcesanspro-otf} or \texttt{sourcesanspro-type1} depending on your engine.
- \item \textbf{sourcesanspro-otf}:\\
- Loads the original fonts (only for \XeLaTeX\ and \LuaLaTeX\ users).
- \item \textbf{sourcesanspro-type1}:\\
- Loads generated Type1 fonts.
-\end{itemize*}
-
\section{Options}
-The packages have the following options:
+The package has the following options:
\begin{itemize*}
- \item \textbf{oldstyle, osf}: use old style numbers.
- \item \textbf{lining, nf}: use lining numbers.
- \item \textbf{tabular}: use fixed-width numbers.
- \item \textbf{proportional}: use normal numbers.
- \item \textbf{black}: \texttt{\textbackslash bfseries} is black.
- \item \textbf{semibold}: \texttt{\textbackslash bfseries} is semibold.
- \item \textbf{bold}: \texttt{\textbackslash bfseries} is bold.
- \item \textbf{light}: \texttt{\textbackslash mdseries} is light.
- \item \textbf{extralight}: \texttt{\textbackslash mdseries} is extra light.
- \item \textbf{regular}: \texttt{\textbackslash mdseries} is regular.
- \item \textbf{scaled}: Scaling factor, eg: \texttt{scaled=.5}
- \item \textbf{default}: Default font family is sans-serif.
+ \item \textbf{oldstyle, osf}: use old style numbers.
+ \item \textbf{lining, nf, lf}: use lining numbers.
+ \item \textbf{tabular}: use fixed-width numbers.
+ \item \textbf{proportional}: use normal numbers.
+ \item \textbf{black}: \texttt{\textbackslash bfseries} is black.
+ \item \textbf{semibold}: \texttt{\textbackslash bfseries} is semibold.
+ \item \textbf{bold}: \texttt{\textbackslash bfseries} is bold.
+ \item \textbf{light}: \texttt{\textbackslash mdseries} is light.
+ \item \textbf{extralight}: \texttt{\textbackslash mdseries} is extra light.
+ \item \textbf{regular}: \texttt{\textbackslash mdseries} is regular.
+ \item \textbf{scale, scaled}: Change the scaling with a factor. For example: \texttt{scale=.5}
+ \item \textbf{default}: Source Sans Pro is set as the default font family and as the sans serif family.
+ \item \textbf{type1, t1}: Override automatic detection and use the Type 1 fonts.
+ \item \textbf{opentype, otf}: Override automatic detection and use OpenType fonts.
\end{itemize*}
-The following options are enabled by default: \texttt{lining, proportional, bold, regular}.
+The following options are enabled by default: lining, proportional, bold and regular.
\section{Commands}
-Commands for all variants are also provided in the \texttt{sourcesanspro-otf} package:
+Commands for all weights are also provided for \XeTeX\ and \LuaTeX\ users.
\begin{itemize*}
\item \texttt{\bfseries \textbackslash sourcesanspro}
- -- the regular and bold (plus both italic) variants.
+ -- the regular and bold weights.
\item \texttt{\bfseries \textbackslash sourcesansprolight}
- -- the light and semibold (plus both italic) variants.
+ -- the light and semibold weights.
\item \texttt{\bfseries \textbackslash sourcesansproextreme}
- -- the extra light and black (plus both italic) variants.
+ -- the extra light and black weights.
\end{itemize*}
\section{Licence}
-Adobe's Source Sans Pro typeface is available under the \href{http://scripts.sil.org/OFL}{SIL Open Font License 1.1}.
+Adobe's Source Sans Pro typeface is available under the \href{http://scripts.sil.org/OFL}{SIL Open Font License 1.1}.\\
+All \LaTeX\ code is available under the \href{http://www.latex-project.org/lppl/}{\LaTeX\ project public license} v1.3 or later.
\section{Specimen}
-Simple specimen follow. Full specimen can be \href{http://store1.adobe.com/type/browser/pdfs/1959.pdf}{acquired from Adobe}.
+Simple specimen can be found on page \pageref{sec:specimen}. Full specimen can be \href{http://store1.adobe.com/type/browser/pdfs/1959.pdf}{acquired from Adobe}.
+
+\section{OpenType}
+The OpenType fonts have many features, including old style numerals (1 6 9), ligatures (ff fi fl ft {\addfontfeature{Style=Alternate}fl}) and stylistic alternatives ({\addfontfeature{Style=Alternate} l a g I}).
+
+\subsection{Features}
+A complete list of available font features is available on page \pageref{sec:otfinfo}. More information on how to use font features can be found in the \href{http://mirror.ctan.org/macros/latex/contrib/fontspec/fontspec.pdf}{fontspec documentation}.
+
+\subsection{Files}
+\begin{itemize*}
+ \item SourceSansPro-ExtraLight.otf
+ \item SourceSansPro-ExtraLightIt.otf
+ \item SourceSansPro-Light.otf
+ \item SourceSansPro-LightIt.otf
+ \item SourceSansPro-Regular.otf
+ \item SourceSansPro-RegularIt.otf
+ \item SourceSansPro-Semibold.otf
+ \item SourceSansPro-SemiboldIt.otf
+ \item SourceSansPro-Bold.otf
+ \item SourceSansPro-BoldIt.otf
+ \item SourceSansPro-Black.otf
+ \item SourceSansPro-BlackIt.otf
+\end{itemize*}
+
+\section{Type1}
+The following Type1 font families are included:
+\begin{itemize*}
+ \item SourceSansPro-LF
+ \item SourceSansPro-TLF
+ \item SourceSansPro-OsF
+ \item SourceSansPro-TOsF
+\end{itemize*}
+With series ‘el’, ‘l’, ‘m’, ‘sb’, ‘b’, ‘k’ and shapes ‘n’, ‘i’ and ‘sc’.
+
+\section{Version history}
+\subsection*{2.0}
+\begin{itemize*}
+ \item Merged all \texttt{.sty} files into \texttt{sourcesanspro.sty}.
+ \item \texttt{default} option now sets the default font family to \texttt{Source Sans Pro}, not \texttt{\textbackslash sfdefault}.
+ \item \texttt{type1}, \texttt{t1}, \texttt{opentype} and \texttt{otf} option added to override automatic detection.
+ \item Added \texttt{OT1} to \texttt{fontspec} options.
+\end{itemize*}
+\subsection*{1.02}
+\begin{itemize*}
+ \item Changed the order of \texttt{T1} and \texttt{LY1}.
+ \item Changed \texttt{lining}/\texttt{nf} behaviour.
+ \item Redefined \texttt{\textbackslash oldstylenums}.
+\end{itemize*}
+
+\section{Known issues}
+\begin{itemize*}
+ \item Using \texttt{\textbackslash liningnums} when the default numbers are oldstyle results in an ‘font feature does not exist’ error and no lining numbers due to lack of the ‘lnum’ font feature.
+ \item For Type1 users the weight options are set globally.
+\end{itemize*}
+
+\newpage
\end{multicols}
+\section{Specimen}
+\label{sec:specimen}
\subsection{OpenType}
\begin{figure}[ht]
\centering
@@ -84,4 +134,43 @@ This table can also be found in \file{sourcesanspro-otf-specimen}.
\includegraphics{sourcesanspro-type1-specimen}
\end{figure}
This table can also be found in \file{sourcesanspro-type1-specimen}.
-\end{document} \ No newline at end of file
+
+\newpage
+\section{Opentype features}
+\label{sec:otfinfo}
+
+\begin{figure}[ht]
+ \centering
+ \begin{tabular}{>{\ttfamily}l l}
+ aalt & Access All Alternates \\
+ c2sc & Small Capitals From Capitals \\
+ case & Case-Sensitive Forms \\
+ ccmp & Glyph Composition/Decomposition \\
+ dnom & Denominators \\
+ frac & Fractions \\
+ kern & Kerning \\
+ liga & Standard Ligatures \\
+ mark & Mark Positioning \\
+ mkmk & Mark to Mark Positioning \\
+ numr & Numerators \\
+ onum & Oldstyle Figures \\
+ ordn & Ordinals \\
+ pnum & Proportional Figures \\
+ salt & Stylistic Alternates \\
+ sinf & Scientific Inferiors \\
+ size & Optical Size \\
+ smcp & Small Capitals \\
+ ss01 & Stylistic Set 1 - alternate l \\
+ ss02 & Stylistic Set 2 - alternate a \\
+ ss03 & Stylistic Set 3 - alternate g \\
+ ss04 & Stylistic Set 4 - alternate I \\
+ %ss05 & Stylistic Set 5 \\
+ subs & Subscript \\
+ sups & Superscript \\
+ zero & Slashed Zero
+ \end{tabular}
+\end{figure}
+\textit{(list generated with otfinfo)}
+
+\end{document}
+