summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/psnfssx/lucidabr/lucida-sample.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2021-02-05 03:01:00 +0000
committerNorbert Preining <norbert@preining.info>2021-02-05 03:01:00 +0000
commit6dd01829674e94f8b6b4829e703e6e0686f07a25 (patch)
tree2d7666cb4df65d2e581d1c20dc5df6b826a2ac63 /macros/latex/contrib/psnfssx/lucidabr/lucida-sample.tex
parentc18f29fc8bbdc114e808b53b99e9244054483190 (diff)
CTAN sync 202102050301
Diffstat (limited to 'macros/latex/contrib/psnfssx/lucidabr/lucida-sample.tex')
-rw-r--r--macros/latex/contrib/psnfssx/lucidabr/lucida-sample.tex234
1 files changed, 137 insertions, 97 deletions
diff --git a/macros/latex/contrib/psnfssx/lucidabr/lucida-sample.tex b/macros/latex/contrib/psnfssx/lucidabr/lucida-sample.tex
index ec6911ade0..6a76b8bc06 100644
--- a/macros/latex/contrib/psnfssx/lucidabr/lucida-sample.tex
+++ b/macros/latex/contrib/psnfssx/lucidabr/lucida-sample.tex
@@ -1,4 +1,4 @@
-% Copyright 2005, 2006 TeX Users Group.
+% Copyright 2005-2012 TeX Users Group.
%
% Copying and distribution of this file, with or without modification,
% are permitted in any medium, without royalty.
@@ -18,19 +18,21 @@
\reversemarginpar
\addtolength\marginparwidth{20pt}
-% live url's if pdf.
-\usepackage{ifpdf}
+\usepackage{ifpdf} % live url's if pdf.
\ifpdf
\usepackage[breaklinks,colorlinks,linkcolor=black,citecolor=black,
- pagecolor=black,urlcolor=black]{hyperref}
+ urlcolor=black]{hyperref}
\else
\usepackage{url}
\fi
\newcommand*\pkg[1]{\textsf{#1}}
-\newcommand*\opt[1]{\texttt{#1}}
-\newcommand*\cs[1]{\texttt{\char`\\#1}}
+% define \code for url-like breaking of typewriter fragments.
+\ifx\nolinkurl\undefined \def\code{\url}\else \def\code{\nolinkurl}\fi
+\DeclareRobustCommand\cs[1]{\mbox{\texttt{\char`\\#1}}}
+% avoid a lot of whitespace above the title, and put something in the header.
+\usepackage{titling} \setlength{\droptitle}{-110pt}
\pagestyle{headings}
\newcommand\demotext{%
@@ -39,18 +41,19 @@
% !`THE DAZED BROWN FOX QUICKLY GAVE 12345--67890 JUMPS!
--- ?`But aren't Kafka's Schlo\ss{} and
\AE sop's \OE uvres often na\"\i ve vis-\`a-vis the d\ae monic
- ph\oe nix's official r\^ole in fluffy souffl\'es?}
+ ph\oe nix's official r\^ole in fluffy \rlap{souffl\'es?}}
\newcommand*\demotextsc{\textsc{Sphinx of black quartz, judge my vow}.}
\newcommand*\demotextosf{\oldstylenums{0123456789}.}
-\newcommand*\raggedmarginpar[1]{\marginpar{\raggedright\hspace{0pt}#1}}
+\newcommand*\raggedmarginpar[1]{%
+ \marginpar{\small \raggedright\hspace{0pt}#1}}
\newcommand*\demo[2]{%
\par\leavevmode\raggedmarginpar{#1}%
\begin{minipage}[t]{\linewidth}%
- \normalfont#2\demotext
+ \raggedright\normalfont#2\demotext
\end{minipage}%
}
@@ -68,7 +71,7 @@
}
-\title{Using the Lucida fonts with \LaTeX}
+\title{Using the Lucida Type 1 fonts with \LaTeX}
\author{\TeX\ Users Group\\[2pt]\url{http://tug.org/lucida}}
\begin{document}
\maketitle
@@ -83,50 +86,45 @@ Bigelow \& Holmes Inc.\ registered in the U.S. Patent \& Trademark
Office and other jurisdictions.}
}
-This document contains examples of the Lucida fonts available through
-TUG. They are divided into two sets, \textit{basic} and
-\textit{complete}, as displayed in the following sections.
+This document contains examples of the Lucida fonts in Type~1 format
+available from TUG. TUG also offers a (slightly different) set of
+Lucida fonts in OpenType format. For more information and an order form
+for any of the fonts, please see \url{http://tug.org/lucida}.
-For more information about Lucida and \TeX, and an order form for the
-fonts, please see \url{http://tug.org/lucida}.
-
-\section{\LaTeX\ macro support for Lucida}
+\section{\LaTeX\ macro support for Lucida Type 1}
The Lucida support primarily consists of two packages: \pkg{lucidabr}
-and \pkg{lucbmath}. The former changes both running text and math to use
-Lucida, whereas the latter only changes the math font setup in case you
+and \pkg{lucbmath}. The former changes both running text and math to use
+Lucida, whereas the latter only changes the math font setup, in case you
want to use a different text font with the Lucida math fonts.
-You may already have the macro packages installed as they are part of
-most \TeX{} distributions---try running the example below.
-
-If it complains that \texttt{lucidabr.sty} is not found, you must
-install the package; it's available on CTAN in
-\url{http://www.ctan.org/tex-archive/macros/latex/contrib/psnfssx/lucidabr},
-and (of course) also included in the TUG distribution when you order the
-fonts.
+Naturally, the packages are included in the TUG distribution you receive
+when you order the fonts. They are also available from CTAN, in the
+directory
+\url{http://mirror.ctan.org/macros/latex/contrib/psnfssx/lucidabr}. If
+you run the example below and it complains that \code{lucidabr.sty} is
+not found, you must install the packages.
\subsection{Basic example}
The packages do \emph{not} support \LaTeX's (and \TeX's) default
-encoding (OT1). Supported encodings are T1, LY1, and TS1 (partial).
-What this means is that you have to use the \pkg{fontenc} package to
-switch the default.
-
-Here's a small example:
+encoding (OT1). Supported text encodings are T1 and LY1, and the text
+companion encoding TS1 is partially supported. Thus, you must use the
+\pkg{fontenc} package (part of standard \LaTeX) to switch from the
+default encoding. Here's a small example:
\begin{verbatim}
\documentclass{article}
-\usepackage[T1]{fontenc}
-\usepackage{textcomp}
-\usepackage{lucidabr}
+\usepackage[T1]{fontenc} % or LY1
+\usepackage{textcomp} % unnecessary with LY1
+\usepackage[altbullet]{lucidabr}
\begin{document}
Here's some text. And here's some math:
\[
\phi(x)=\int_{-\infty}^{x} e^{-x^{2}/2}
\]
-Euro and copyright symbols are available:
+Euro, copyright, and bullet symbols are available:
\texteuro \textcopyright \textbullet.
\end{document}
\end{verbatim}
@@ -144,45 +142,79 @@ Euro, copyright, and bullet symbols are available:
If the example runs ok, but produces no output, try refreshing the
``filename database'' (e.g., run \texttt{mktexlsr}). Also, of course,
-you must actually purchase the fonts! (All the metrics and support
-files are on CTAN, but not the \texttt{.pfb} files containing the actual
+you must actually purchase the fonts! (The metrics and support files
+are on CTAN, but not the \texttt{.pfb} files containing the actual
outlines.)
-It's best to load the \pkg{textcomp} package with \pkg{lucidabr}, or
-some symbols, notably \cs{textcopyright}, will be synthesized instead of
-coming from the fonts. We don't load \pkg{textcomp} automatically,
-since loading such fundamental packages behind the scenes can cause
-hard-to-debug trouble.
+When the T1 encoding is used, it's best to load the \pkg{textcomp}
+package along with \pkg{lucidabr}, or some symbols, notably
+\cs{textcopyright}, will be synthesized instead of coming from the
+fonts. We don't load \pkg{textcomp} automatically since loading such
+fundamental packages behind the scenes can cause hard-to-debug trouble.
Furthermore, the default \cs{textbullet} is quite small; the more normal
-one above is generated by specifying the \opt{altbullet} option when
-loading \pkg{lucidabr}.
-
-By default, oldstyle figures from the \pkg{textcomp} package, accessed
-with the \verb|\oldstylenums| command, are disabled for the Lucida fonts
-since they do not exist in all shapes. In order for \verb|\oldstylenums|
-to work, you must add the line
+one above is used when the \code{altbullet} option to the \pkg{lucidabr}
+package is given.
+
+\subsection{Old style figures}
+
+Old style figures ($\oldstylenums{0123456789}$) are produced with the
+\LaTeX\ command \verb|\oldstylenums{...}|. They are provided in the
+Lucida Bright fonts (not sans or typewriter), but unfortunately their
+treatment is slightly complicated and depends on the encoding you use.
+
+\def\descitem#1{\hbox to 21pt{\hfil#1}}
+\begin{description}
+\item[\descitem{T1}]
+When using T1 + \pkg{textcomp}, you can get old style figures
+automatically in math mode via the usual command \verb|\oldstylenums|,
+e.g., \verb|$\oldstylenums{0123456789}$|. To be able to also get them
+in text, you must add this line:\\[2pt]
+\verb| \DeclareEncodingSubset{TS1}{hlh}{1}|\\[2pt]
+to your preamble \emph{after} loading the \pkg{textcomp} package.
+
+\item[\descitem{LY1}]
+For LY1, old style figures are the ordinary numbers of the small caps
+font; so, using \verb|\textsc| or \verb|\scshape| automatically yields
+the old style figures. This is in accordance with the long-established
+typographical tradition.
+
+While the command \verb|\oldstylenums| works automatically in math mode
+as in the previous case, for it to work with ordinary text, and to get
+the bold old style figures in bold text, its \LaTeX\ definition has to
+be changed, by specifying the font the figures will come from. So you
+must include this code in your preamble:
\begin{verbatim}
-\DeclareEncodingSubset{TS1}{hlh}{1}
+\makeatletter
+\def\oldstylenums#1{\begingroup
+ \spaceskip\fontdimen\tw@\font
+ \usefont{OML}{hlcm}{\f@series}{it}%
+ \mathgroup\symletters #1%
+ \endgroup}
+\makeatother
\end{verbatim}
-to your preamble \emph{after} loading the \pkg{textcomp} package. The
-font family \texttt{hlhj} provides the oldstyle figures by default but
-there exists no bold italic version of these figures and the italic
-versions are only available if you buy the complete font set.
+\end{description}
+
+After making the appropriate changes, you can get old style figures as
+desired:
-Now, let's take a more systematic look at the fonts.
+\medskip
+\begin{tabular}{ll}
+\verb|\oldstylenums{0123456789}| & \oldstylenums{0123456789} \cr
+\verb|\textit{\oldstylenums{0123456789}}|&\textit{\oldstylenums{0123456789}}\cr
+\verb|\textbf{\oldstylenums{0123456789}}|&\textbf{\oldstylenums{0123456789}}\cr
+\end{tabular}
-\section{The \textsf{basic} font set}
+\section{Font samples}
-The basic set of fonts contains all the math fonts (shown in the
-accompanying \texttt{lucida-amsmath} document), a set of text fonts with
-accompanying small caps, and a monospaced font for code examples. The
-idea is that this is sufficient for mathematical papers and typical text
-usage.
+The Lucida Type~1 font set contains math fonts (shown in the
+accompanying \texttt{lucida-amsmath} document), and the following text
+fonts:
-The roman text font is Lucida Bright. It comes with small caps and
-oldstyle figures only in the upright shapes:
+The basic text family is Lucida Bright, with the usual four
+variants---regular, italic, bold, and bold italic; small caps and
+oldstyle figures are available in the upright shapes:
\begin{quote}
\demoscosf{LucidaBright}{}
@@ -196,8 +228,8 @@ oldstyle figures only in the upright shapes:
\demo{LucidaBright-DemiItalic}{\bfseries\itshape}
\end{quote}
-\noindent The basic set also contains Lucida Sans Typewriter in various
-shapes and series:
+\bigskip\noindent The monospaced \code{LucidaSans-Typewriter} family is
+available in the same four variants (no small caps or oldstyle figures):
\begin{quote}
\demo{LucidaSans-Typewriter}{\ttfamily\raggedright}
@@ -209,11 +241,9 @@ shapes and series:
{\ttfamily\bfseries\slshape\raggedright}
\end{quote}
-\section{The \textsf{complete} font set}
-
-The complete font set includes (naturally) all the basic fonts, and
-assorted other text font variations, starting with the full sans serif
-variant, Lucida Sans:
+\bigskip\noindent The sans serif, \code{LucidaSans}, is again
+available in the same four variants (also with no small caps or
+oldstyle):
\begin{quote}
\demo{LucidaSans}{\sffamily}
@@ -225,8 +255,8 @@ variant, Lucida Sans:
{\sffamily\bfseries\itshape}
\end{quote}
-LucidaSans also exists in an ultra bold version, which you have to select
-manually with \verb|\fontseries{ub}\selectfont|.
+\bigskip\noindent LucidaSans also exists in an ultra bold version, which
+you have to select manually with \verb|\fontseries{ub}\selectfont|.
\begin{quote}
\demo{LucidaSans-Bold}{\sffamily\fontseries{ub}\selectfont}
@@ -235,11 +265,10 @@ manually with \verb|\fontseries{ub}\selectfont|.
\end{quote}
-A second, seriffed, typewriter font is included as well. By default the
-\pkg{lucidabr} package chooses Lucida Sans Typewriter for typewriter but
-you can change that by giving the option \opt{seriftt}, as in:\\
-\verb|\usepackage[seriftt]{lucidabr}|
-
+\bigskip\noindent A second, seriffed, typewriter font is included as
+well. By default the \pkg{lucidabr} package selects Lucida Sans
+Typewriter for typewriter; you can change that by giving the option
+\code{seriftt}:\\ \verb|\usepackage[seriftt]{lucidabr}|
\begin{quote}
\demo{Lucida Typewriter}{\fontfamily{hlct}\selectfont\raggedright}
@@ -252,9 +281,11 @@ you can change that by giving the option \opt{seriftt}, as in:\\
{\fontfamily{hlct}\selectfont\slshape\bfseries\raggedright}
\end{quote}
-Lucida Fax is a complete text font. By giving the option \opt{fax} to
-\pkg{lucidabr} this becomes the default roman font. There are no small
-caps or oldstyle figures for this font.
+
+\bigskip\noindent Lucida Fax is an alternative text font, heavier than
+usual, available in the same four variants. By giving the option
+\code{fax} to \pkg{lucidabr} this becomes the default roman font. There
+are no small caps or oldstyle figures for this font.
\begin{quote}
\demo{LucidaFax}{\fontfamily{hlx}\selectfont}
@@ -267,9 +298,9 @@ caps or oldstyle figures for this font.
{\fontfamily{hlx}\selectfont\itshape\bfseries}
\end{quote}
-Lucida Casual exists in two versions only: medium upright and
-medium italic. You can still make it the default text font by giving the
-option \opt{casual} to \pkg{lucidabr}.
+\bigskip\noindent The Lucida Casual variant exists in two versions only:
+medium upright and medium italic. You can make it the default text
+font by giving the option \code{casual} to \pkg{lucidabr}.
\begin{quote}
\demo{LucidaCasual}{\fontfamily{hlcn}\selectfont}
@@ -278,26 +309,35 @@ option \opt{casual} to \pkg{lucidabr}.
\end{quote}
-Finally, three more esoteric fonts are included. Lucida Calligraphy
-contains italic oldstyle figures, which are used if available when
-selecting \verb|\oldstylenums| for Lucida Bright. If you choose the
-option \opt{calligraphic} for \pkg{lucidabr}, Lucida Calligraphy will be
-the default roman font. A similar option \opt{handwriting} makes Lucida
-Handwriting the default roman font.
-
+\bigskip\noindent Finally, three more specialized fonts are included. If
+you specify the \code{calligraphic} option for \pkg{lucidabr}, Lucida
+Calligraphy will be the default italic font. A similar option
+\code{handwriting} makes Lucida Handwriting the default italic font.
\begin{quote}
-\demo{LucidaCalligraphy-Italic}
- {\fontfamily{hlce}\selectfont}
+\demo{Lucida Calligraphy-Italic}
+ {\fontfamily{hlce}\selectfont 0123456789. }
-\demo{LucidaHandwriting-Italic}
+\demo{Lucida Handwriting-Italic}
{\fontfamily{hlcw}\selectfont}
\demo{Lucida Blackletter}
{\fontfamily{hlcf}\selectfont}
\end{quote}
-This is all the Lucida fonts available with \TeX\ support. For more
-information about Lucida and \TeX, and an order form for the fonts,
-please see \url{http://tug.org/lucida}, and thanks.
+The above are all the Lucida Type~1 fonts available with \TeX\ support.
+There are no plans to extend the selection; work now is focused on the
+Lucida OpenType fonts.
+
+\section{Closing}
+
+If you have questions or problems regarding installation or use, please
+email \code{lucida@tug.org}; this is an open and publicly archived list
+for Lucida discussion; you can subscribe on the web at
+\url{http://lists.tug.org/lucida}. On the other hand, questions or
+problems related to ordering or licensing should go to
+\code{lucida-admin@tug.org}.
+
+Finally, the home page for Lucida and \TeX, with an order form for the
+fonts, is \url{http://tug.org/lucida}.
\end{document}