Skip to content

Commit

Permalink
Added index of OT features; a few formatting changes.
Browse files Browse the repository at this point in the history
  • Loading branch information
psb1558 committed Jan 8, 2024
1 parent bf0f9c3 commit e8bca2b
Show file tree
Hide file tree
Showing 10 changed files with 275 additions and 240 deletions.
6 changes: 4 additions & 2 deletions docs/EnlargeAxis.tex
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ \chapter{The Enlarge Axis}\hypertarget{enlarge}{}
in the Private Use Area, posing accessibility and searchability problems, as explained in the introduction to the
“Feature Reference” chapter of this manual.

Junicode provides a solution to these problems via the OpenType feature Stylistic Set 6 (ss06, “Enlarged minuscules”).
Junicode provides a solution to these problems via the OpenType feature Stylistic Set 6
(\textSourceText{ss06},\index{ss06} “Enlarged minuscules”).
This feature also works in Junicode VF, the variable version of Junicode, which in addition offers a far more flexible
way of representing enlarged minuscules—the Enlarge axis.

Expand All @@ -31,7 +32,8 @@ \chapter{The Enlarge Axis}\hypertarget{enlarge}{}
too heavy, but a letter scaled via the Enlarged axis will have its original weight at the lower end of the axis and the
same weight as a capital at the top).

The Enlarge axis runs from 0 to 100. You can choose any number in that range: to match the effect of ss06 precisely, choose 32.
The Enlarge axis runs from 0 to 100. You can choose any number in that range:
to match the effect of ss06\index{ss06} precisely, choose 32.
To ensure that the xheight of all letters matches, choose 47 or less: above that value, the xheight of letters like \textex{e}
increases at a higher rate than that of letters like \textex{b}.

Expand Down
366 changes: 188 additions & 178 deletions docs/Feature_Reference.tex

Large diffs are not rendered by default.

Binary file modified docs/JunicodeManual.pdf
Binary file not shown.
10 changes: 8 additions & 2 deletions docs/JunicodeManual.sty
Original file line number Diff line number Diff line change
Expand Up @@ -43,11 +43,16 @@
]
\setfontface\sampleheader{JunicodeVF}[
Renderer = HarfBuzz,
SizeFeatures = {{Size={5-}, RawFeature={axis={wght=350,wdth=90}}}}
SizeFeatures = {{Size={5-}, RawFeature={axis={wght=350,wdth=95}}}}
]
\setmonofont{Fira Mono}[Scale=MatchLowercase,Numbers=Lowercase]
\setsansfont{Fira Sans}[Scale=MatchLowercase,Numbers=Lowercase]

\usepackage{imakeidx}
\usepackage{idxlayout}
%\renewcommand{\indexname}{Index of OpenType Features}
\makeindex[title=Index of OpenType Features,intoc]

\usepackage{fancyhdr}
\usepackage{realscripts}
\usepackage{graphicx}
Expand All @@ -63,6 +68,7 @@
\definecolor{myLightBlue}{RGB}{203,228,249}
\definecolor{myLightGreen}{RGB}{234,255,244}
\definecolor{myLightPurple}{RGB}{214,205,234}
\definecolor{GunMetalGray}{RGB}{42,52,57}
\usepackage{multicol}
\usepackage{array}
\usepackage{tabto}
Expand Down Expand Up @@ -149,7 +155,7 @@
% Headers
\usepackage{titlesec}
\titleformat{\chapter}[hang]{\huge\jSmCondLight\color{RViolet}}{\thechapter.}{1em}{}
\titleformat{\section}[hang]{\Large\jSmCond\color{SlateGray}}{\thesection.}{1em}{}
\titleformat{\section}[hang]{\Large\jSmCond\color{GunMetalGray}}{\thesection.}{1em}{}
\titleformat{\subsection}[hang]{\large\color{BrickRed}}{\thesubsection.}{1em}{}
% List styles
\newcommand\liststyleLi{%
Expand Down
5 changes: 4 additions & 1 deletion docs/JunicodeManual.tex
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
\huge \centering the font for medievalists \\[1cm]
\Huge\centering {\color{myRed}} \\[1cm]
\huge\centering {\jItalic specimens and user manual} \\[1ex]
\Large\centering{\jRegular for version 2.205}\\
\Large\centering{\jRegular for version 2.206}\\
\vfill
{\color{myRed}}
\end{titlepage}
Expand Down Expand Up @@ -44,11 +44,14 @@

\input{encoded-glyphs.tex}

\printindex

\vspace*{\fill}
\begin{center}
{\jItalic{This document was set in 12pt Junicode VF\\
using the {\LuaLaTeX} typesetting system with fontspec for font management.\\
The font for code is Fira Mono.\\
The sans serif font is Fira Sans.\\
The source for the document, JunicodeManual.tex, is available at}}\\
{\color{BrickRed}https://github.com/psb1558/Junicode-font.}
\end{center}
Expand Down
12 changes: 7 additions & 5 deletions docs/OnTheWeb.tex
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ \section{Subsetting Junicode}
of Junicode via subsetting, compress it into a webfont (almost certainly in
woff2 format), and host it on your web server. This is because “Junicode” is
not a “Reserved Font Name” (which complicates web use of
many fonts licensed under the Open Font License). If you are nervous about the
many fonts licensed under the Open Font License). If you are nevertheless nervous about the
legal requirements of the Open Font License, you can change the font name to
something arbitrary with the \texttt{-‌-obfuscate-names} option
of the pyftsubset program, and you can embed the Open Font License, or a
Expand Down Expand Up @@ -108,12 +108,14 @@ \section{Subsetting Junicode}
\hyperlink{req}{Required Features}, are discarded. All of the characters
referenced in these features will also be included in the output file, as long
as those characters are variants of characters in your text file. For example,
the \textSourceText{smcp} (Small Caps) feature has many more small caps than there are letters
the \textSourceText{smcp}\index{smcp} (Small Caps) feature has many more small caps than there are letters
of the alphabet, but most of them are not included in the subsetted font. The
program's parsimony with characters keeps the font file as small as possible.
Note that some features are included automatically: \textSourceText{ccmp},
\textSourceText{locl}, \textSourceText{calt}, \textSourceText{liga}, \textSourceText{rlig},
\textSourceText{kern}, \textSourceText{mark}, and \textSourceText{mkmk}.
Note that some features are included automatically: \textSourceText{ccmp}\index{ccmp},
\textSourceText{locl}\index{locl}, \textSourceText{calt}\index{calt},
\textSourceText{liga}\index{liga}, \textSourceText{rlig}\index{rlig},
\textSourceText{kern}\index{kern}, \textSourceText{mark}\index{mark},
and \textSourceText{mkmk}\index{mkmk}.


\texttt{--layout-features-} tells the program which OpenType features to omit.
Expand Down
34 changes: 20 additions & 14 deletions docs/Record_Interpreter_notes.tex
Original file line number Diff line number Diff line change
Expand Up @@ -28,14 +28,15 @@ \section{A preliminary note on transcription}
screen readers will misinterpret it. To solve one problem (that of visual representation), you may well have introduced
a host of far more serious problems.

Fortunately, Junicode offers a solution for this particular problem. The OpenType feature \textSourceText{cv63} substitutes for
Fortunately, Junicode offers a solution for this particular problem. The OpenType feature
\textSourceText{cv63}\index{cv63} substitutes for
the yogh a character that \textit{looks} like the ezh but is semantically a yogh and therefore will be
handled correctly by applications. But neither Junicode nor any other font can solve every problem of this kind.
Sometimes you will have to call to mind the important principle stated above: \textit{A transcript is not a
facsimile}. It is much more important that it should have the same \textit{meaning} as the original than
that it should have the same \textit{look}.

This document concerns the transcription of texts in Latin (and to some extent, other archaic languages, e.g. Old and
This chapter concerns the transcription of texts in Latin (and to some extent, other archaic languages, e.g. Old and
Middle English, Old French). It is long-standing custom, when transcribing certain kinds of documents, to retain marks
of abbreviation---for example, the \textex{\hlig{\char"0A753p\char"0363}} you may find in a manuscript or printed edition representing
the word \textit{propterea}. This is okay---and Junicode can help with the task. But when dealing with the
Expand All @@ -44,7 +45,8 @@ \section{A preliminary note on transcription}

For example, the abbreviation \textex{\hlig{\char"0A753p\char"0363}} as printed here consists of an underlying sequence of Unicode
characters: \textex{\char"0A753} (\unic{U+A753}, the common abbreviation for \textit{pro}) + \textex{p} + \textex{\char"25CC\char"0363}
(\unic{U+0363}, the combining small \textit{a}). The OpenType feature \textSourceText{hlig} (Historical Ligatures) has been
(\unic{U+0363}, the combining small \textit{a}). The OpenType feature \textSourceText{hlig}\index{hlig}
(Historical Ligatures) has been
applied to this sequence, changing its appearance but not its underlying value. That underlying value is intelligible
to computer applications in the sense that they can recognize each character.

Expand Down Expand Up @@ -81,7 +83,8 @@ \section{A preliminary note on transcription}
\textex{\cvd[32]{84}{q\char"0363\char"0304}}, enter this sequence: q (\unic{U+0071}) + \unic{U+0363} + \unic{U+0304}.

Junicode 2 contains many variants of combining marks: for example the curly zigzag \cvd[1]{81}{\char"25CC\char"035B} is a variant of
Unicode's angular zigzag {\char"25CC\char"035B} (\unic{U+035B}), produced by applying the OpenType feature \textSourceText{cv81[2]} to
Unicode's angular zigzag {\char"25CC\char"035B} (\unic{U+035B}), produced by applying the OpenType feature
\textSourceText{cv81[2]}\index{cv81} to
\textbf{both the base character and the combining mark}. Sometimes the combination of base + combining mark + OpenType
feature will not produce the desired effect. When this happens, place \unic{U+034F} (a special invisible combining mark,
included in Unicode for exactly this purpose) between the base and the (visible) mark.\\
Expand All @@ -92,11 +95,11 @@ \section{A preliminary note on transcription}
\textit{dampna}.
\end{quote}
The combining macron can also be applied above superscripts and combining marks. Apply the OpenType feature
\textSourceText{cv84[33]} for a narrower macron:
\textSourceText{cv84[33]}\index{cv84} for a narrower macron:
\begin{quote}
\cvd[32]{84}{antiqua\char"034F\char"0304} \textit{antiquam}; \cvd[32]{84}{q\char"0363\char"0304} \textit{quam}.
\end{quote}
For the superscript \textit{a}, use the OpenType feature \textSourceText{sups} (see r. below).\\[1ex]
For the superscript \textit{a}, use the OpenType feature \textSourceText{sups}\index{sups} (see r. below).\\[1ex]

\noindent\secletter{b.}\ \ For a straight stroke through a tall letter, use the \textsc{combining short stroke overlay} (\unic{U+0335}): \textex{f\char"0335\ d\char"0335\ l\char"0335}. But Unicode also has precomposed versions of
\textex{d}, \textex{l} and other characters \mbox{with} stroke, e.g.
Expand Down Expand Up @@ -134,7 +137,7 @@ \section{A preliminary note on transcription}
\textit{generatio}; p\char"035B; \textit{prae}; seru\char"035Be \textit{servire}}.
\end{quote}
The curly form of the combining zigzag may be attached to any letter, and it may change shape depending on the letter it
is attached to (including caps, for which use the \textSourceText{case} feature, and small caps:
is attached to (including caps, for which use the \textSourceText{case}\index{case} feature, and small caps:
\textex{\cvd[1]{81}{A\char"035B B\char"035B \textsc{c\char"035B
d\char"035B\hspace{0.2em}}}}).\\[1ex]

Expand Down Expand Up @@ -173,7 +176,7 @@ \section{Spacing characters}
\end{quote}
\noindent\secletter{k.}\ \ For \textit{{}-rum} the Unicode \textsc{rum rotunda} (\unic{U+A75D}) is like the one in MUFI/Junicode.
The one in the \textit{Record Interpreter} and \textit{Statutes} is a late stylized version of
this. Use \unic{U+A75D} and apply OpenType feature \textsc{\textSourceText{cv80}} to obtain the correct shape:
this. Use \unic{U+A75D} and apply OpenType feature \textsc{\textSourceText{cv80}}\index{cv80} to obtain the correct shape:
\begin{quote}
\cvd{80}{a\~{i}a\char"0A75D\ \textit{animarum}; co\char"0A75Dpere \textit{corrumpere}; beato\char"0A75D\
\textit{beatorum}}.
Expand Down Expand Up @@ -203,9 +206,10 @@ \section{Spacing characters}
\char"0A757\ \textit{quod}; \char"0A757d \textit{quid}; \char"0A757b\char"0A76B\ \textit{quibus}.
\end{quote}
\noindent\secletter{q.}\ \ For \textit{quae}, \textit{que}, use \textex{q}
followed by \textsc{et} (\unic{U+A76B}) with or without \textSourceText{hlig}: \textex{q\char"0A76B}
followed by \textsc{et} (\unic{U+A76B}) with or without \textSourceText{hlig}\index{hlig}: \textex{q\char"0A76B}
\textex{\hlig{q\char"0A76B}}. For the semicolon-like \textsc{et} sign (\textex{\cvd{83}{q\char"0A76B}}), use
\textSourceText{cv83[1]}; for the subscripted version (which can also form a ligature via \textSourceText{hlig}), use \textSourceText{cv83[2]}:
\textSourceText{cv83[1]}\index{cv83}; for the subscripted version (which can also form a ligature via \textSourceText{hlig}),
use \textSourceText{cv83[2]}:
\textex{\cvd[1]{83}{q\char"0A76B\ \hlig{q\char"0A76B}}}.\\[1ex]

\noindent\secletter{r.}\ \ All of the letters a-z are available in superscript form. Access with the \textex{sups}
Expand All @@ -215,8 +219,9 @@ \section{Spacing characters}
\end{quote}
The basic Latin letters a--z have anchors that allow you to position combining marks over them (see a. above)\\[1ex]

\noindent\secletter{s.}\ \ Tironian \textsc{et} sign \char"204A\ \unic{U+204A}, cap \char"2E52\ \unic{U+2E52}. With \textSourceText{cv69[1]} \cvd{69}{\char"204A\char"2E52}; with
\textSourceText{cv69[2]} \cvd[1]{69}{\char"204A\char"2E52}.\\[1ex]
\noindent\secletter{s.}\ \ Tironian \textsc{et} sign \char"204A\ \unic{U+204A}, cap \char"2E52\ \unic{U+2E52}.
With \textSourceText{cv69[1]} \cvd{69}{\char"204A\char"2E52}; with
\textSourceText{cv69[2]}\index{cv69} \cvd[1]{69}{\char"204A\char"2E52}.\\[1ex]

\noindent\secletter{t.}\ \ For \textit{est}, use \textex{\char"223B} \unic{U+223B} \textsc{homothetic}. Use of a mathematical sign for this
purpose is not ideal, but Unicode offers no better solution.\\[1ex]
Expand All @@ -228,7 +233,7 @@ \section{Spacing characters}

\noindent\secletter{w.}\ \ At least one edition uses a spacing version of the \textsc{combining zigzag}
(\textbf{f.} above).
Neither Unicode nor MUFI has a matching character: with Junicode, apply \textSourceText{cv67} to the spacing
Neither Unicode nor MUFI has a matching character: with Junicode, apply \textSourceText{cv67}\index{cv67} to the spacing
\textsc{macron} (\unic{U+00AF}): \textex{\cvd{67}{\char"25CC\char"00AF}}.

\section[Other formatting]{Other formatting}
Expand All @@ -252,7 +257,8 @@ \section{Spacing characters}
}
\end{verbatim}

\noindent But the \textSourceText{hlig} feature, if applied to the whole text, will produce many unwanted effects, so it should be
\noindent But the \textSourceText{hlig}\index{hlig} feature, if applied to the whole text,
will produce many unwanted effects, so it should be
included in a class definition to be used in a <span> applied just to the target sequence:
\begin{verbatim}
.que {
Expand Down
14 changes: 7 additions & 7 deletions docs/Specimens.tex
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ \subsection*{Old and Middle English}
Þat siþen depreced prouinces, and patrounes bicome\\
Welneȝe of al þe wele in þe west iles.} (SemiExpanded)\\

\noindent{\small\jSmCondItalic Apply the OpenType feature ss02 (Stylistic Set 2)
\noindent{\small\jSmCondItalic Apply the OpenType feature ss02\index{ss02} (Stylistic Set 2)
for insular letter-forms.}\\[1ex]
{\jSmCond\addfontfeature{Language=English}\InsularLetterForms\jcv{\jcvEogonek}
Her cynewulf benam sigebryht his rices \& westseaxna wiotan for
Expand All @@ -34,7 +34,7 @@ \subsection*{Old Irish}
eturru. Fírbriathar, a ingen, bar Ailill, is maith ben ben
dagfir. Maith omm, bar ind ingen. Cid diatá latsu ón. Is de atá lim,
bar Ailill, ar it ferr-su indiu indá in lá thucus-sa thu.} (Condensed Medium)\\[1ex]
\noindent{\small\jSmCondItalic For insular letter-forms, apply the OpenType feature ss02 (Stylistic Set 2),
\noindent{\small\jSmCondItalic For insular letter-forms, apply the OpenType feature ss02\index{ss02} (Stylistic Set 2),
making sure the language is set to Irish.}\\[1ex]
\noindent\addfontfeature{StylisticSet=2}Bamaith-se
remut, ar Medb. Is maith nach cualammar {\char"204A} nach fetammar, ar Ailill,
Expand All @@ -60,7 +60,7 @@ \subsection*{Old Irish}
\subsection*{Old Icelandic}
{\small\jSmCondItalic\addfontfeature{Language=English} For Nordic shapes of þ and ð in an
English context, specify the appropriate language (e.g. Icelandic or Norwegian);
or apply the OpenType ss01 (Stylistic Set 1) feature.}\\[1ex]
or apply the OpenType ss01\index{ss01} (Stylistic Set 1) feature.}\\[1ex]
{\jMedium\addfontfeature{Language=Icelandic} Um haustit sendi Mǫrðr Valgarðsson orð at Gunnarr myndi vera einn heimi, en
lið alt myndi vera niðri í eyjum at lúka heyverkum. Riðu þeir Gizurr Hvíti ok
Geirr Goði austr yfir ár, þegar þeir spurðu þat, ok austr yfir sanda til Hofs.
Expand Down Expand Up @@ -104,7 +104,7 @@ \subsection*{Gothic}
frawaurkjandans wiþra broþruns, slahandans ize gahugd siuka, du
Xristau fra\-waur\-keiþ.} (SemiCondensed Light)\\

{\noindent\small\jSmCondItalic Use ss19 to produce Gothic letters
{\noindent\small\jSmCondItalic Use ss19\index{ss19} to produce Gothic letters
automatically from transliterated text.}\\[1ex]
{\jSmExpBold\LatinToGothic jabai auk ƕas gasaiƕiþ þuk þana
habandan kunþi in ga\-liuge stada anakumbjandan, niu miþwissei is
Expand Down Expand Up @@ -166,7 +166,7 @@ \subsection*{Greek}
\subsection*{Lithuanian}

{\small\jSmCondItalic Lithuanian poses several typographical challenges. Make sure
Contextual Alternates (calt) is turned on; for i̇́, use i followed
Contextual Alternates (calt\index{calt}) is turned on; for i̇́, use i followed
by combining dot accent (\unic{U+0307}) and acute (\unic{U+0301}).}\\[1ex]
{\jExp\addfontfeature{Language=Lithuanian} Visa žemė turėjo vieną kalbą ir tuos pačius žodžius. Kai žmonės
kėlėsi iš rytų, jie rado slėnį Šinaro krašte ir ten įsikūrė. Vieni
Expand All @@ -178,7 +178,7 @@ \subsection*{Lithuanian}
\subsection*{Polish}
{\small\jSmCondItalic The default shape and position of ogonek in Junicode are suitable
for modern Polish. For the medieval Latin e-caudata, consider using
cv62.}\\[1ex]
cv62\index{cv62}.}\\[1ex]
{\jCondMedium\addfontfeature{Language=Polish} Mieszkańcy całej ziemi mieli jedną mowę, czyli jednakowe słowa. A
gdy wędrowali ze wschodu, napotkali równinę w kraju Szinear i tam
zamieszkali. I mówili jeden do drugiego: Chodźcie, wyrabiajmy cegłę
Expand All @@ -191,7 +191,7 @@ \subsection*{Fleurons}

{\small\jSmCondItalic Junicode contains a number of fleurons (floral
ornaments) copied from a 1785 Caslon specimen book. Access
these via the OpenType feature \hyperlink{ornm}{ornm}. Fleurons have only one weight and
these via the OpenType feature \hyperlink{ornm}{ornm}\index{ornm}. Fleurons have only one weight and
width, and they are the same in roman and italic.}

\begin{center}
Expand Down
Loading

0 comments on commit e8bca2b

Please sign in to comment.