summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.tex')
-rw-r--r--Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.tex112
1 files changed, 112 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.tex b/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.tex
new file mode 100644
index 00000000000..a5eef86433a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.tex
@@ -0,0 +1,112 @@
+% !TEX TS-program = lualatex
+\documentclass{article}
+
+\usepackage{biblatex}
+\addbibresource{unicode-alphabets.bib}
+
+\usepackage{showexpl}
+\usepackage{float}
+\usepackage{moreverb}
+
+\title{Unicode Alphabets for \LaTeX}
+\author{Mikkel Eide Eriksen}
+
+\usepackage{fontspec}
+\newfontfamily\mufifont{Palemonas MUFI}
+\newfontfamily\titusfont{TITUS Cyberbit Basic}
+
+\usepackage[
+ CYFI,
+ MUFI,
+ TITUS,
+% disable entity macros,
+ fonts={
+ CYFI=\titusfont,
+ MUFI=\mufifont,
+ TITUS=\titusfont,
+ },
+]{unicode-alphabets}
+
+\begin{document}
+
+\maketitle
+
+\section{Preface}
+
+While Unicode supports the vast majority of use cases, there are certain specialized niches which require characters and glyphs not (yet) represented in the standard.
+
+Thus the Private Use Area (PUA) at code points E000--F8FF, which enables third parties to define arbitrary character sets.
+
+This package allows configuring a number of macros to enter characters from the PUA by name or code point.
+
+\section{Setup}
+
+The package is configured in the following manner:
+
+\begin{verbatim}
+\usepackage[⟨options⟩]{unicode-alphabets}
+\end{verbatim}
+
+Where \verb|options| must be one or more of the following character sets. See references for further detail on each, as well as usable fonts.
+
+\begin{figure}[H]
+\begin{description}
+
+% \item[CSUR] - https://www.evertype.com/standards/csur/
+\item[CYFI] Early Cyrillic glyphs\cite{CYFI}.
+% DANIA ???
+\item[LINCUA] Shortcut for enabling the character sets CYFI, MUFI, and TITUS\cite{LINCUA}.
+\item[MUFI] The Medieval Unicode Font Initiative\cite{MUFI}.
+\item[SIL] SIL International\cite{SIL}.
+\item[TITUS] Thesaurus Indogermanischer Text- und Sprachmaterialien\cite{TITUS}.
+\item[UNZ] Normung von Sonderzeichen\cite{UNZ}.
+
+\end{description}
+\caption{Character sets}
+\end{figure}
+
+There is no default, since future versions of this package may supply more character sets that are incompatible with the above.
+
+Additionally, one may configure different fonts for each character set, as in the following example:
+
+\begin{figure}[H]
+\centering
+\begin{verbatimtab}
+\usepackage[
+ MUFI,
+ TITUS,
+ fonts={
+ MUFI=\mufifont,
+ TITUS=\titusfont,
+ },
+]{unicode-alphabets}
+\end{verbatimtab}
+\caption{Example setup}
+\end{figure}
+
+If no fonts are configured, the document font will be used (note that this may give undesirable results, as few fonts support multiple character sets\footnote{I believe Andreas Stötzner's \emph{Andron Mega} does, albeit I haven't tried it as it is somewhat expensive.}).
+
+Finally, the \verb|MUFI| and \verb|UNZ| character sets have defined entity names, which result in the creation of macros for each character (see \verb|msignfour| in the following example). These can be suppressed with the \verb|disableentitymacros| option.
+
+\section{Usage}
+
+Each set defines a macro in the following manner. Let's use \verb|MUFI| as an example.
+
+By default, a macro with the lower-case name of the character set is defined: \verb|\mufi{}|. It can then be used to display characters from the given set (the below uses the \emph{Palemonas MUFI} font available from the MUFI project):
+
+\begin{figure}[H]
+\centering
+\begin{LTXexample}[varwidth=true]
+\mufi{FLOURISHED SMALL LETTER M SIGN}\\
+\msignflour{}
+\mufi{msignflour}
+\mufi{F2F3}
+\end{LTXexample}
+\caption{Example usage}
+\end{figure}
+
+Additionally, starred versions of each macro are defined, which suppress using the configured font, falling back to the document font.
+
+\printbibliography
+
+\end{document}