summaryrefslogtreecommitdiff
path: root/fonts/junicode/doc/junicode-package.tex
diff options
context:
space:
mode:
Diffstat (limited to 'fonts/junicode/doc/junicode-package.tex')
-rw-r--r--fonts/junicode/doc/junicode-package.tex106
1 files changed, 73 insertions, 33 deletions
diff --git a/fonts/junicode/doc/junicode-package.tex b/fonts/junicode/doc/junicode-package.tex
index 221c9171ff..8bfd429b4f 100644
--- a/fonts/junicode/doc/junicode-package.tex
+++ b/fonts/junicode/doc/junicode-package.tex
@@ -1,47 +1,66 @@
\documentclass{article}
-\usepackage[medium,semiexpanded]{Junicode}
+\usepackage[
+ medium,
+ semiexpanded,
+ SmCondLightFeatures={
+ Language=English,
+ StylisticSet=8
+ }
+]{junicode}
\usepackage{microtype}
\usepackage{multicol}
\usepackage{supertabular}
+\usepackage{metalogo}
+s\setmonofont{Fira Mono}[Scale=MatchLowercase,Numbers=Lowercase]
+\setsansfont{Fira Sans}[Scale=MatchLowercase,Numbers=Lowercase]
+\newcommand{\fspec}{{\sffamily fontspec}}
\linespread{1.1}
+\tolerance=1500
\title{Junicode}
\author{Peter S. Baker}
-\date{}
+\date{\today}
\begin{document}
\maketitle
\section{Introduction}
This package supports the Junicode static fonts (version 2.204 or higher)
-for XeLaTeX and LuaLaTeX. The current version of the Junicode font should
-be installed in your system. If the font is included in your TeX installation,
-it is an obsolete version: you should remove it if possible. This package loads
-fontspec, so it is not necessary to load it separately, even if you are using
+for {\XeLaTeX} and {\LuaLaTeX}. If your {\TeX} installation has an older version of
+Junicode (probably version 1.002), you should upgrade to the latest version.
+This package loads
+\fspec, so it is not necessary to load it separately, even if you are using
other fonts alongside Junicode.
\section{Loading Junicode}
-Load Junicode in the usual way, with {\small\verb|\usepackage{Junicode}|}. Several options are available:
+Load Junicode in the usual way, with {\verb|\usepackage{junicode}|}. Several options are available:
\begin{description}
-\item[fonttype] The type of font to look for, CFF or TrueType. These font types differ in the
-way they draw outlines, and their hinting technologies are very different. Values may be otf
-(the default) or ttf, e.g.\\
-\hspace*{1in}{\small\verb|\usepackage[fonttype=ttf]{Junicode}|}
-\item[light] The weight of the type for the main text is Light instead of Regular.
-\item[medium] The weight of the type for the main text is Medium, somewhat heavier than Regular.
+%\item[fonttype] The type of font to look for, \textbf{otf} (the default) or \textbf{ttf}.
+%These font types differ in the
+%way they draw outlines, and their hinting technologies are very different. They may look subtly
+%different on a computer screen. Example:\\
+%\hspace*{1in}{\verb|\usepackage[fonttype=ttf]{junicode}|}
+\item[light] The weight of the type for the main text is light instead of regular.
+\item[medium] The weight of the type for the main text is medium, somewhat heavier than regular.
+The main text in this document is set in Junicode Medium.
\item[semibold] The weight of bold type is somewhat lighter than the usual bold. This may be a
-good choice if you have selected the light option.
+good choice if you have selected the \textbf{light} option.
\item[condensed] The width of the type is narrow. Note that bold type cannot be condensed: when
this option is selected, any bold type in the text will have normal width.
\item[semicondensed] The width of the type is wider than condensed but narrower than the default.
Note that bold type cannot be semicondensed: when this option is selected, any bold type in the
text will have normal width.
\item[expanded] The width of the type is wide. Note that light type cannot be expanded: using
-both the light and the expanded options will produce an error.
+both the \textbf{light} and the \textbf{expanded} options will produce an error.
\item[semiexpanded] The width of the type is wider than the default but narrower than expanded.
-Note that light type cannot be semiexpanded: using both the light and the semiexpanded options
+Note that light type cannot be semiexpanded: using both the \textbf{light} and the \textbf{semiexpanded} options
will produce an error.
+\item[proportional] Numbers in the document will be proportionally spaced. This is the default.
+\item[tabular] Numbers will be tabular (or monospaced).
+\item[oldstyle] Numbers will be old-style, harmonizing with lowercase letters.
+\item[lining] Numbers will be lining, harmonizing with uppercase letters.
+\item[style options] These will be discussed in the next section.
\end{description}
\section{Selecting Alternate Styles}
@@ -125,37 +144,58 @@ if you keep these abbreviations in mind: Sm = Semi, Cond = Condensed, Exp = Expa
\textbackslash jSmExpSmbold
- \textbackslash jSmExpSmboldItalic
+ \textbackslash jSmExpSmboldItalic
\end{multicols}
+\noindent You can customize these styles by passing options when you load the package.
+The name of each option is based on the corresponding stylename, but without the
+prefixed “j” or any suffixed “Italic” (since each of these options
+affects both the roman and the matching italic face), and with “Features” suffixed.
+The content of the option must be one or more of the {\fspec} features appropriate to
+Junicode. For example, this is the {\verb|\usepackage|} command from the preamble to
+this document:
+
+\begin{verbatim}
+ \usepackage[
+ medium,
+ semiexpanded,
+ SmCondLightFeatures={
+ Language=English,
+ StylisticSet=8
+ }
+ ]{junicode}
+\end{verbatim}
+
+\noindent After the options for setting the main text, the \textbf{SmCondLightFeatures}
+option sets the language to English and turns on Stylistic Set 8 (“Contextual Long s”)
+for the semicondensed light face:
+{\jSmCondLight \textcv[4]{\jcvf}{self\char"200Clessness}}.
+
\section{Other Commands}
-These commands do nothing more than wrap fontspec commands, which can still be
-used with the Junicode package and are actually needed if you want to take full
-advantage of the Junicode font’s features. Some of these commands are more mnemonic
-than the corresponding fontspec commands, and others are more compact. Each command
+This package's other commands are offered as conveniences---shorter and more
+mnemonic than the {\fspec} commands they invoke (though of course all {\fspec} commands
+remain available). Each of these commands
also has a corresponding “text” command that works like
-{\small\verb|\textit{}|}—that is, it takes
+{\verb|\textit{}|}—that is, it takes
as its sole argument the text to which the command will be applied. Each “text” command
consists of the main command with “text” prefixed—for example,
-{\small\verb|\textInsularLetterForms{}|}
-corresponding to {\small\verb|\InsularLetterForms|}. For a fuller account of the OpenType features
-applied by these commands, see Chapter 4, Feature Reference.
+{\verb|\textInsularLetterForms{}|}
+corresponding to {\verb|\InsularLetterForms|}. For a fuller account of the OpenType features
+applied by these commands, see Chapter 4 of the \textit{Junicode Manual}, “Feature Reference.”
\begin{center}
\tablehead{\hline}
\tabletail{\hline}
\begin{supertabular}{| l | p{2.75in} |}
\textbackslash AltThornEth & Applies ss01, Alternate thorn and eth.\\\hline
-\textbackslash InsularLetterForms & Applies ss02, Insular letter-forms.
-This has an effect only with English and Irish text.\\\hline
+\textbackslash InsularLetterForms & Applies ss02, Insular letter-forms.\\\hline
\textbackslash IPAAlternates & Applies ss03, IPA alternates.\\\hline
\textbackslash HighOverline & Applies ss04, High Overline.\\\hline
\textbackslash MediumHighOverline & Applies ss05, Medium-high Overline.\\\hline
\textbackslash EnlargedMinuscules & Applies ss06, Enlarged minuscules.\\\hline
\textbackslash Underdotted & Applies ss07, Underdotted.\\\hline
-\textbackslash ContextualLongS & Applies ss08, Contextual long s. This should be used only in English or
-French text. With other languages it simply converts all instances of s to ſ.\\\hline
+\textbackslash ContextualLongS & Applies ss08, Contextual long s.\\\hline
\textbackslash AlternateFigures & Applies ss09, Alternate Figures.\\\hline
\textbackslash EntitiesAndTags & Applies ss10, Entities and Tags.\\\hline
\textbackslash EarlyEnglishFuthorc & Applies ss12, Early English Futhorc.\\\hline
@@ -172,13 +212,13 @@ French text. With other languages it simply converts all instances of s to ſ.\\
\end{center}
\noindent The syntax of \textbackslash jcv
-is {\small\verb|\jcv[num]{num}|}, where the second (required) argument is the number of the Character Variant feature,
+is {\verb|\jcv[num]{num}|}, where the second (required) argument is the number of the Character Variant feature,
and the first (optional) argument is an index into the variants provided by that feature (starting with zero, the default).
-\textbackslash textcv takes an additional required argument ({\small\verb|\textcv[num]{num}{text}|}—the text to which the
+\textbackslash textcv takes an additional required argument ({\verb|\textcv[num]{num}{text}|}—the text to which the
feature should be applied.
Character Variant features can also be selected with mnemonics, listed below. For example, a feature for
-lowercase \textbf{a} can be expressed as {\small\verb|\textcv[2]{\jcva}{a}|}, yielding \textbf{\textcv[2]{\jcva}{a}}.
+lowercase \textbf{a} can be expressed as {\verb|\textcv[2]{\jcva}{a}|}, yielding \textbf{\textcv[2]{\jcva}{a}}.
\begin{multicols}{3}
\jCond\textbackslash jcvA
@@ -380,4 +420,4 @@ lowercase \textbf{a} can be expressed as {\small\verb|\textcv[2]{\jcva}{a}|}, yi
\textbackslash jcvYogh
\end{multicols}
-\end{document}
+\end{document} \ No newline at end of file