summaryrefslogtreecommitdiff
path: root/fonts/boondox/doc/boondox-doc.tex
blob: b08d8f2fb10bde3a8ee594bd3ef62411d82653bf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
% !TEX TS-program = pdflatexmk
\documentclass[11pt]{article}
%SetFonts
% newtxtext+newtxmath
\usepackage{newtxtext} %loads helv for ss, txtt for tt
\usepackage{amsmath}
\usepackage[bigdelims]{newtxmath}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
%SetFonts
\usepackage[margin=1.4in]{geometry} 
%\geometry{landscape}                % Activate for for rotated page geometry
\usepackage[parfill]{parskip}    % Activate to begin paragraphs with an empty line rather than an indent
\usepackage{url}\usepackage{graphicx}

\usepackage{hyperref}
\title{BOONDOX math alphabets}
\author{Michael Sharpe\\
msharpe at ucsd dot edu}
\date{}

\begin{document}
\maketitle
The BOONDOX fonts are PostScript versions of subsets of the STIX fonts corresponding to regular and bold weights of three alphabets---calligraphic, fraktur and double struck, \textsc{aka} blackboard bold. Support files are provided so that they can be called up from \LaTeX\ math mode using the commands \verb|\mathcal|, \verb|\mathbcal|, \verb|\mathfrak|, \verb|\mathbfrak|, \verb|\mathbb| and \verb|\mathbbb|. The font family name derives from the fact that, at least in the US, the phrase ``in the boondox'' implies ``in the stix.''

The base PostScript fonts were constructed from \textsf{STIXGeneral.otf} and \textsf{STIXGeneralBol.otf} using a \textsf{FontForge} script, resulting in 
\begin{verbatim}
zxxrl8a.pfb % BOONDOXDoubleStruck-Regular
zxxbl8a.pfb % BOONDOXDoubleStruck-Bold
zxxrw8a.pfb % BOONDOXCalligraphic-Regular
zxxbw8a.pfb % BOONDOXCalligraphic-Bold
zxxrf8a.pfb % BOONDOXFraktur-Regular
zxxbf8a.pfb % BOONDOXFraktur-Bold
\end{verbatim}
together with the corresponding {\tt.afm} files. (The names are almost Berry conformant: the initial {\tt z} warns that they break the rules, and the font id {\tt xx} is completely unblessed by any authority. The remaining parts are nearly OK, except that the font lack many glyphs normally in {\tt 8a} encoding, but all glyphs are in the correct slots.)

Using \textsf{afm2tfm}, the afm files were transformed to raw tfm files (kern information discarded)
\begin{verbatim}
zxxrl7z.tfm
zxxbl7z.tfm
zxxrw7z.tfm
zxxbw7z.tfm
zxxrf7z.tfm
zxxbf7z.tfm
zxxrow7z.tfm % same as zxxrw7z, less oblique
zxxbow7z.tfm % same as zxxbw7z, less oblique
\end{verbatim}
which serve as the basis for further virtual math fonts. Finally, using \textsf{FontForge} scripts and manual adjustments to the metrics to suit my personal taste, produces (no pretense of using Berry names):
\begin{verbatim}
BOONDOX-r-cal.tfm
BOONDOX-b-cal.tfm
BOONDOX-r-calo.tfm
BOONDOX-b-calo.tfm
BOONDOX-r-frak.tfm
BOONDOX-b-frak.tfm
BOONDOX-r-ds.tfm
BOONDOX-b-ds.tfm
\end{verbatim}
and the corresponding {\tt.vf} files. 

There are two ways to use these. The traditional method is based on  {\tt.sty} and {\tt.fd} files for each pair: {\tt BOONDOX-cal}, {\tt BOONDOX-calo}, {\tt BOONDOX-frak} and {\tt BOONDOX-ds}. For example,
\begin{verbatim}
\usepackage[scaled=.95]{BOONDOX-ds}
\end{verbatim}
defines the output from \verb|\mathbb| and \verb|\mathbbb| to come from {\tt BOONDOX-r-ds} and {\tt BOONDOX-b-ds} respectively, scaled to 95\% of normal size, and 
\begin{verbatim}
\usepackage{BOONDOX-calo}
\end{verbatim}
defines the output from \verb|\mathcal| and \verb|\mathbcal| to come from {\tt BOONDOX-r-calo} and {\tt BOONDOX-b-calo} respectively. (These are \emph{less} oblique versions of the {\tt BOONDOX} calligraphic fonts.)

The second method uses a different interface not depending on the {\tt.sty} and {\tt.fd} files at all. The package \textsf{mathalfa	} permits you to say
\begin{verbatim}
\usepackage[bb=boondox,bbscaled=.95,cal=boondoxo]{mathalfa}
\end{verbatim}
to accomplish the same effect as the above.

See the \textsf{mathalfa} documentation for font samples of these and many other math alphabets.

\section*{Added 2017-02-23}
A new BOONDOX alphabet was added, based on STIX-MathScr, but with the slant removed and glyphs reworked to have smaller swashes and smaller tails that intrude less into the space inhabited by subscripts. To call this alphabet as \verb|\mathscr|, use e.g.,
\begin{verbatim}
\usepackage[scaled=.98]{BOONDOX-uprscr}
\end{verbatim}
This alphabet is also available through {\tt mathalfa}. Because using it in these ways adds an extra math family, it may be desirable to load it not as a math font. See the documentation to {\tt TXUprCal} for details of such usage.
\end{document}