done documenting

1 files changed, 156 insertions, 68 deletions

diff --git a/oldstandard-t.tex b/oldstandard-t.tex
index b5d1154..d5cc755 100644
--- a/oldstandard-t.tex
+++ b/oldstandard-t.tex
@@ -7,6 +7,13 @@
   url =          {https://ctan.org/pkg/arabluatex},
   version =      {1.17}
 }
+@software{babel,
+  title =        {The Babel package},
+  titleaddon =   {Multilingual support for Plain TeX or LaTeX},
+  author =       {Bezos López, Javier and Braams, Johannes L.},
+  url =          {http://www.ctan.org/pkg/babel},
+  version =      {3.33}
+}
 @software{oldstandard,
   title =        {The OldStandard package},
   titleaddon =   {Old Standard: A Unicode Font for Classical and
@@ -33,16 +40,25 @@ BoldItalicFeatures={RawFeature={+embolden=2}}]{Old Standard T}
 
 \babelfont{tt}{CMU Typewriter Text}
 
+\newlength\defaultparindent
+\setlength\defaultparindent{\parindent}
 \usepackage{dtxdescribe}
+\setlength\parindent{\defaultparindent}
+
 \usepackage[xindy]{imakeidx}
 \indexsetup{noclearpage}
 \makeindex
-\renewcommand{\pkg}[1]{\textsf{#1}\index{#1 (package)}}
 
+\usepackage{latexcolors}
 \usepackage{csquotes}
+\usepackage{xurl}
+\usepackage{uri}
 \usepackage{varioref}
 \usepackage{hyperref}
-\hypersetup{unicode=true, linktocpage=true, colorlinks, hidelinks}
+\hypersetup{unicode=true, linktocpage=true, colorlinks,
+  allcolors=cinnamon, pdfauthor={Robert Alessi}, pdftitle={Old
+    Standard T}}
+
 \usepackage{enumitem}
 \setlist{nosep}
 \setlist[itemize]{label=\textendash}
@@ -55,51 +71,22 @@ BoldItalicFeatures={RawFeature={+embolden=2}}]{Old Standard T}
 \usepackage{relsize}
 \usepackage{tikz}
 \usepackage[breakable, skins, xparse, minted]{tcolorbox}
-\tcbset{colback=white, boxrule=.15mm, colframe=red!50!white,
-  breakable}
+\tcbset{colback=white, boxrule=.15mm, colframe=cinnamon, breakable}
 \newtcblisting{example}{minted options={linenos, numbersep=0mm,
     fontsize=\smaller}}
 \newtcblisting{code}{minted options={linenos, numbersep=0mm,
-    fontsize=\smaller}, listing
-  only}
+    fontsize=\smaller}, listing only}
 
-\usepackage{latexcolors}
 \usepackage[fullvoc]{arabluatex}
-\usepackage{teubner}
 \usepackage[style=oxnotes-inote]{biblatex}
 \DeclareFieldFormat{postnote}{\mkpageprefix[pagination][\mknormrange]{#1}}
 \addbibresource{oldstandard-t.bib}
-\usepackage[citecmd=autocite]{icite}
+\usepackage[citecmd=autocite,defaultindex=none]{icite}
 \bibinput{oldstandard-t}
 
 \usepackage{cleveref}
 
-\usepackage{etoc}
-\etocsettocdepth{paragraph}
-\newcommand{\altableofcontents}{%
-  \begingroup
-  \etocsetstyle{section}{}{}
-  {\etocsavedsectiontocline{%
-      \numberline{\etocnumber}\etocname}{\etocpage}}{}
-  \etocsetstyle{subsection}{}{}
-  {\etocsavedsubsectiontocline{%
-      \numberline{\etocnumber}\etocname}{\etocpage}}{}%
-  \etocsetstyle{subsubsection}{}{}
-  {\etocsavedsubsubsectiontocline{%
-      \numberline{\etocnumber}\etocname}{\etocpage}}{}%
-  \etocsetstyle{paragraph}{}{\leftskip2cm\rightskip 2.2em \parfillskip
-    0pt plus 1fil\relax \nobreak}
-  {\noindent\etocname{} \etocpage{} }{\par}%
-  \etocmulticolstyle[2]{\section*{Contents}}
-  \pdfbookmark[1]{Contents}{toc}
-  \tableofcontents
-  \endgroup}
-
-% url = https://gitlab.com/ralessi/oldstandard_t,
-%   % 
-%   abstract = {This font is just the same as Alexey Kryukov's beautiful
-%     \emph{Old Standard}. In comparison to \emph{Old Standard},
-%     \emph{Old Standard T} includes new letters and some corrections.}
+\usepackage[toc]{multitoc}
 
 \title{\mdseries\tcbox[colframe=black, enhanced, tikznode, drop
   lifted shadow, colback=white, boxrule=.25mm]%
@@ -117,7 +104,7 @@ BoldItalicFeatures={RawFeature={+embolden=2}}]{Old Standard T}
 \begin{document}
 \maketitle
 \footnotesize
-\altableofcontents
+\tableofcontents
 \normalsize
 
 \begin{abstract}
@@ -136,6 +123,16 @@ Copyright \textcopyright\ 2019, Robert Alessi
 (\href{mailto:alessi@robertalessi.net}{alessi@robertalessi.net}), without
 Reserved Font Names.
 
+Please send error reports and suggestions for improvements to Robert
+Alessi:
+\begin{itemize}
+\item email: \mailto[oldstandard-t package]{alessi@roberalessi.net}
+\item website: \url{http://www.robertalessi.net/oldstandard\_t}
+\item development: \url{http://git.robertalessi.net/oldstandard\_t}
+\item comments, feature requests, bug reports:
+\url{https://gitlab.com/ralessi/oldstandard\_t/issues}
+\end{itemize}
+
 This Font Software is licensed under the SIL Open Font License,
 Version 1.1. This license is available with a FAQ at:
 \url{http://scripts.sil.org/OFL}
@@ -150,15 +147,13 @@ be found online,\footnote{See
   \url{https://github.com/akryukov/oldstand}} have been published
 under the terms of the OFL license (see above,
 \vref{sec:license}). However, at the time of writing, the latest
-update dates back to Aug. 12, 2013. To be more precise, all of the
+update dates back to Aug.\ 12, 2013. To be more precise, all of the
 five \enquote*{commits} the writer was able to see were pushed on the
 very same day. Since then, two \enquote*{pull requests} dating back to
 2017 have been remained unanswered. It is therefore to be feared that
-the project has been abandoned.
-
-To date, this release of \emph{Old Standard} has been published by
-Nikola Lečić and Bob Tennent and is available on CTAN and {\TeX}Live
-with a style file.\footnote{See
+the project has been abandoned.  To date, this release of \emph{Old
+  Standard} has been published by Nikola Lečić and Bob Tennent and is
+available on CTAN and {\TeX}Live with a style file.\footnote{See
   \url{https://ctan.org/pkg/oldstandard}}
 
 Being unable himself to contact the author, the writer, while in need
@@ -183,7 +178,7 @@ item of the original extensive documentation applies. The reader
 should refer to it.\icite{oldstandard}
 
 \section{Additions and corrections provided by
-  Old Stan\-dard~T}
+  \emph{Old Standard~T}}
 \label{sec:addit-corr-prov}
 \emph{Old Standard T} includes new letters and some corrections:
 \begin{enumerate}
@@ -198,7 +193,7 @@ should refer to it.\icite{oldstandard}
   the only character missing from \emph{Old Standard} that is needed
   in some of the accepted standards of romanization of classical
   Arabic. See for references the current documentation of the
-  \pkg{arabluatex} package.\footnote{\icite{arabluatex}[cite], sect{.}
+  \textsf{arabluatex} package.\footnote{\icite{arabluatex}[cite], sect{.}
     \enquote{Transliteration}.}
 \item Additionally, \emph{Old Standard T} corrects the \verb|+ss06|
   feature provided by \emph{Old Standard}. This feature is supposed to
@@ -221,15 +216,21 @@ It is loaded with \pkg{fontspec} like so:---
 \end{code}
 
 \paragraph{Small capitals}
-The following example demonstrates the use of small capitals:---
-\begin{example}
+Small capitals have been added in \emph{Old Standard T} for the
+following languages or transcription schemes: French, German, Italian,
+Spanish, unaccented Greek, basic Russian and Arabic \enquote*{DMG}.
+
+The following two examples demonstrate the use of small capitals:---
+\begin{tcblisting}{minted language=latex, title=Initials, minted
+    options={fontsize=\smaller, linenos, numbersep=0mm,
+      highlightlines={7}}}
   \begin{center}
     CHAPTER I
 
-    MR. SHERLOCK HOLMES
+    MR.\ SHERLOCK HOLMES
   \end{center}
   
-  \lettrine[loversize=0.2]{M}{r. Sherlock Holmes}, who was usually
+  \lettrine[loversize=0.2]{M}{r.\ Sherlock Holmes}, who was usually
   very late in the mornings, save upon those not infrequent occasions
   when he stayed up all night, was seated at the breakfast table. I
   stood upon the hearth-rug and picked up the stick which our visitor
@@ -240,10 +241,11 @@ The following example demonstrates the use of small capitals:---
     from his friends of the C.C.H.,} was engraved upon it, with the
   date \enquote{1884.} It was just such a stick as the old-fashioned
   family practitioner used to carry—dignified, solid, and reassuring.
-\end{example}
+\end{tcblisting}
 
-Another example follows:---
-\begin{example}
+\begin{tcblisting}{minted language=latex, title=Headings, minted
+    options={linenos, numbersep=0mm, fontsize=\smaller,
+      highlightlines={11}}}
   \doublespacing
   \begin{center}
     \textlarger{PART SECOND}.
@@ -258,38 +260,124 @@ Another example follows:---
 
     1. \emph{The Forms of the Triliteral Verb}.
   \end{center}
-\end{example}
+\end{tcblisting}
 
 \paragraph{The letter \enquote*{ǧ}} It is used notably to print
-romanized Arabic:---
-\begin{example}
+romanized Arabic. \emph{Old Standard T} now features this letter in
+all of the three styles (Regular, Italic and Bold):---
+\begin{tcblisting}{minted language=latex, minted
+    options={fontsize=\smaller, linenos, numbersep=0mm,
+      highlightlines={3,6,9}}}  
   \begin{arab}[trans]
     \begin{center}
-      \textbf{dajAjaTu \uc{'a}bI 'l-\uc{h}u_dayli 'l-\uc{`a}llAfi}
+      \textbf{da^gA^gaTu \uc{'a}bI 'l-\uc{h}u_dayli 'l-\uc{`a}llAfi}
     \end{center}
     kAna \uc{'a}bU 'l-\uc{h}u_dayli 'ahd_A 'il_A \uc{m}uwaysiN
-    dajAjaTaN. wa-kAnat dajAjatu-hu 'llatI 'ahdA-hA dUna mA kAna
+    da^gA^gaTaN. wa-kAnat da^gA^gatu-hu 'llatI 'ahdA-hA dUna mA kAna
     yuttaxa_du li-\uc{m}uwaysiN.
 
-      (\uc{al-jA.hi.zu}, \aemph{\uc{k}itAbu 'l-\uc{b}u_halA'i})
+    (\uc{al-^gA.hi.zu}, \aemph{\uc{k}itAbu 'l-\uc{b}u_halA'i})
   \end{arab}
-\end{example}
-
-\begin{example}
+\end{tcblisting}
+
+\paragraph{\texttt{+ss06} OpenType feature} It is commonly believed
+that all Greek vowels with acute accent taken from the Greek Extended
+Unicode block \verb|1F00–1FFF| along with standalone acute accents
+were duplicated from the Greek and Coptic Unicode block. Affected
+characters from the Greek Extended Unicode block (\verb|0370–03FF|)
+follow: \textgrc{ά, έ, ή, ί, ό, ύ, ώ, Ά, Έ, Ή, Ί, Ό, Ύ, Ώ, ΐ, ΰ, ´,
+  ΅}. The counterparts of these letters in the Greek and Coptic
+Unicode block are vowels with \emph{tonoi}.
+
+However, strictly speaking, \emph{tonos} is not to be mistaken for
+\enquote*{acute}: that is for sure, as \emph{tonos} was introduced as
+a result of a reform to denote a tone, namely a stress on some vowels,
+and not a pitch, namely a rising and falling voice on accented vowels.
+Confusion began when the Greek government decreed that \emph{tonos}
+shall be the acute.  From what the writer could see, many Greek fonts
+originally reflected the distinction between \emph{tonos} and acute.
+But nowadays, they simply mix them up.  As a result of this confusion,
+in \emph{Old Standard}, vowels with acute were simply missing from the
+Greek Extended Block. All of them, including the standalone accents,
+have been restored in \emph{Old Standard T}. Furthermore, the rule
+that instructed to absorb vowels with acute into vowels with
+\emph{tonos} has been removed.
+
+Since assigning vowels with \emph{tonos} and vowels with acute to the
+same code points is clearly unacceptable even if the glyphs are
+identical, it is now possible in \emph{Old Standard T} to input all
+accented vowels from the Greek Extended Unicode block exclusively and
+have the substitution rules applied at the same time, as shown by the
+example that follows:---
+\begin{tcblisting}{minted language=latex, minted
+    options={fontsize=\smaller, linenos, numbersep=0mm,
+      highlightlines={9-10}}}
   \begin{grc}
     \begin{center}
-      \textlarger{ΕΠΙΔΗΜΙΩΝ ΤΟ ΔΕΥΤΕΡΟΝ}.
+      \textlarger{��ΠΠΟΚΡΑΤΟΥΣ ��ΠΙΔΗΜΙΩΝ ΤΟ ΔΕΥΤΕΡΟΝ}.
 
       ΤΜΗΜΑ ΠΡΩΤΟΝ.
     \end{center}
     
-    \textbf{1} Ἄνθρακες θερινοὶ ἐν Κραννῶνι· ὗεν ἐν καύμασιν ὕδατι
-    λάβρῳ δι' ὅλου καὶ ἐγίνετο μᾶλλον νότῳ, [καὶ] ὑπογίνονται μὲν ἐν
-    τῷ δέρματι ἰχῶρες· ἐγκαταλαμβανόμενοι δέ, θερμα����ονται, καὶ
-    κνησμὸν ἐμπο������υσιν· εἶτα φλυκταιν����ες ὥσπερ πυρ����αυστοι
-    ἐπανίσταντο καὶ ὑπὸ τὸ δέρμα κα����σθαι ἐδόκεον.
+    \textbf{1.} Ἄνθρακες θερινοὶ ἐν Κραννῶνι· ὗεν ἐν καύμασιν ὕδατι
+    λάβρῳ δι’ ὅλου καὶ ἐγίνετο μᾶλλον νότῳ, [καὶ] ὑπογίνονται μὲν ἐν
+    τῷ δέρματι ἰχῶρες· ἐγκαταλαμβανόμενοι δέ, θερμαίνονται, καὶ
+    κνησμὸν ἐμπο��έουσιν· εἶτα φλυκταινίδες ὥσπερ πυρίκαυστοι
+    ἐπανίσταντο καὶ ὑπὸ τὸ δέρμα καίεσθαι ἐδόκεον.
   \end{grc}
-\end{example}
+\end{tcblisting}
+
+\subsection{Bold Italic shape}
+\label{sec:bold-italic-shape}
+As \emph{Old Standard}, \emph{Old Standard T} does not feature a bold
+italic shape. However, both \XeTeX\ and \LuaTeX\ engines can emulate
+this shape as shown in the following two examples:
+
+\begin{tcblisting}{minted options={linenos, numbersep=0mm,
+      fontsize=\smaller}, listing only, title=\XeLaTeX}
+  \usepackage{fontspec}
+  \setmainfont{Old Standard T}[
+    BoldItalicFont={Old Standard T Italic},
+    BoldItalicFeatures={FakeBold=1.5}]  
+\end{tcblisting}
+
+\begin{tcblisting}{minted options={linenos, numbersep=0mm,
+      fontsize=\smaller}, listing only, title=\LuaLaTeX}
+  \usepackage{fontspec}
+  \setmainfont{Old Standard T}[
+    BoldItalicFont={Old Standard T Italic},
+    BoldItalicFeatures={RawFeature={+embolden=2}}]
+\end{tcblisting}
+
+\subsection{Using \emph{Old Standard T} in multilingual
+  documents}
+\label{sec:using-old-standard}
+\pkg{babel} provides a high level interface on top of \pkg{fontspec}
+to select fonts depending on the languages to be used.\icite[For more
+information, the reader should refer to][10,24]{babel} As an example,
+here is how \emph{Old Standard T} has been loaded in the preamble of
+this document to be compiled with \LuaLaTeX:---
+\begin{code}
+  \usepackage[no-math]{fontspec}
+  \usepackage{fontspec}
+  \usepackage[greek.ancient,english]{babel}
+  \babeltags{grc = greek}
+  
+  \babelfont{rm}[BoldItalicFont={Old Standard T Italic},
+  BoldItalicFeatures={RawFeature={+embolden=2}}]{Old Standard T}
+  
+  \babelfont[greek]{rm}[RawFeature={+ss05;+ss06},
+  BoldItalicFont={Old Standard T Italic},
+  BoldItalicFeatures={RawFeature={+embolden=2}}]{Old Standard T}
+\end{code}
+
+Then, once \emph{Old Standard T} has been loaded with \cs{babelfont}
+properly,
+\begin{enumerate}
+\item \cs{textgrc}\marg{Greek text} can be used for short insertions
+  of Greek text.
+\item \verb|\begin{grc}| ... \verb|\end{grc}| can be used for
+  inserting running paragraphs of Greek text.
+\end{enumerate}
 
-\printindex
 \end{document}