summaryrefslogtreecommitdiff
path: root/fonts/gentium-tug/doc/gentium.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-05-23 03:03:21 +0000
committerNorbert Preining <norbert@preining.info>2022-05-23 03:03:21 +0000
commit989493fc0cf04ec736a261d39eee40e1d7bdf4be (patch)
treea277a139c974ad3d3703fa42439cb0da70de6f89 /fonts/gentium-tug/doc/gentium.tex
parentfcedb80554137a681150f48c9a1ca20dbfb2e83a (diff)
CTAN sync 202205230303
Diffstat (limited to 'fonts/gentium-tug/doc/gentium.tex')
-rw-r--r--fonts/gentium-tug/doc/gentium.tex553
1 files changed, 0 insertions, 553 deletions
diff --git a/fonts/gentium-tug/doc/gentium.tex b/fonts/gentium-tug/doc/gentium.tex
deleted file mode 100644
index 426c47df77..0000000000
--- a/fonts/gentium-tug/doc/gentium.tex
+++ /dev/null
@@ -1,553 +0,0 @@
-% !TEX TS-program = pdflatex
-% !TEX encoding = UTF-8 Unicode
-
-% $Id: gentium.tex 24 2019-07-09 22:04:39Z karl $
-% This file is part of the Gentium package for TeX.
-% It is licensed under the Expat License, see doc//README for details.
-
-\documentclass[11pt, welsh, british]{article}
-\usepackage{babel}
-\usepackage[utf8x]{inputenc}
-\usepackage[T1]{fontenc}
-\usepackage{gentium}
-\renewcommand{\ttdefault}{lmvtt}
-\usepackage{fancyhdr,lastpage,fancyref}
-\usepackage{array,longtable,verbatim}
-\usepackage{booktabs}
-\usepackage{multirow}
-\usepackage{url}
- \urlstyle{tt}
-\usepackage[breaklinks,colorlinks,
- linkcolor=black,citecolor=black,urlcolor=black]
- {hyperref}
-%\usepackage{microtype}
-\usepackage[a4paper,headheight=14pt,scale=0.8]{geometry}
- % use 14pt for 11pt text, 15pt for 12pt text
-
-\title{Gentium for \TeX}
-\author{Mojca Miklavec \and Pavel Farář
- \and Thomas A. Schmitz \and Karl Berry}
-\newcommand*{\dyddiad}{\today}
-\newcommand*{\ofname}{of}
-\date{\dyddiad}
-\pagestyle{fancy}
- \fancyhf[lh]{\itshape gentium-tug}
- \fancyhf[rh]{\itshape\dyddiad}
- \fancyhf[ch]{}
- \fancyhf[lf]{}
- \fancyhf[rf]{}
- \fancyhf[cf]{\itshape --- \thepage~\ofname~\pageref{LastPage} ---}
-
-\usepackage{textcomp}
-
-\def\ConTeXt{Con{\TeX}t}
-\def\ConTeXtMKII{Con{\TeX}t {\sc MkII}}
-\def\ConTeXtMKIV{Con{\TeX}t {\sc MkIV}}
-\def\XeTeX{Xe{\TeX}} % TODO: improve the first "e"--reversed and lowered
-\def\pdfTeX{pdf{\TeX}}
-\def\pdfLaTeX{pdf{\LaTeX}}
-\def\TeXLive{\TeX~Live}
-\def\MiKTeX{MiK\TeX}
-\def\MacTeX{Mac\TeX}
-
-\begin{document}
-\maketitle
-\thispagestyle{empty}
-\pdfinfo{%
- /Creator (TeX)
- /Producer (pdfTeX)
- /Author (Pavel Farář, Mojca Miklavec, Clea F.\ Rees, Thomas A. Schmitz, Karl Berry)
- /Title (Gentium for TeX)
- /Subject (TeX)
- /Keywords (TeX,LaTeX,ConTeXt,font,fonts,tex,latex,gentium,GentiumPlus,GentiumBasic,Gentium,SIL,sil)}
-\pdfcatalog{%
- /URL ()
- /PageMode /UseOutlines}
- % other values: /UseNone, /UseOutlines, /UseThumbs, /FullScreen
- %[openaction <actionspec>]
-% \pagestyle{empty}
- % if you want this, you probably want to comment out \maketitle as well...?
-\setlength{\parindent}{0pt}
-\setlength{\parskip}{0.5em}
-
-
-\newcommand*{\sil}{\textsc{sil}}
-\newcommand*{\pkgname}[1]{\textsf{#1}}
-\newcommand*{\fname}[1]{\textsf{#1}}
-
-\begin{abstract}
- \hspace*{-\parindent}This document outlines the
- \TeX/\LaTeX/\ConTeXt\ support provided by this
- package, \pkgname{gentium-tug}, for the Gentium font collection
- released by \sil.
-\end{abstract}
-
-\tableofcontents
-
-
-\section{Introduction}
-
-This document explains how to use the \TeX/\LaTeX/\ConTeXt\ support in
-the present package for the Gentium font collection developed by \sil.
-This package includes fonts in PostScript Type~1 format converted from
-the original TrueType files released by \sil\ (using the FontForge
-routines found in this package). These Type~1 fonts use the name
-`Gentium' by permission of \sil\ to the \TeX\ Users Group. Therefore
-the name of this \TeX\ package, by request of \sil, is
-\pkgname{gentium-tug}. Its home page is \url{https://tug.org/gentium}.
-
-Further information about the fonts themselves can be found in the
-included documentation and at \url{https://scripts.sil.org/gentium}. The
-fonts are released under the \textsc{sil} Open Font License. For
-details, see \url{ofl.txt} and \url{ofl-faq.txt}. (In the event of
-releasing modified versions of the fonts, either TrueType or Type~1,
-it's required to use a name that doesn't include ``Gentium'', per the
-\textsc{ofl}.)
-
-This \TeX/\LaTeX/\ConTeXt\ support package consists of metrics, map
-files, style files, documentation, and so on. These files are released
-under the Expat license. The text for both licenses is included at the
-end of this document, and in files in the distribution.
-
-If you have the package installed and just want to know how to use
-Gentium in your \TeX\ documents, feel free to skip to
-section~\ref{sec:latex-package} (\LaTeX\ usage) or
-section~\ref{sec:context-package} (\ConTeXt\ usage).
-
-Please report any problems (contact info on the web page). If you can
-also send a fix, so much the better.
-
-
-\section{Gentium collection background}
-
-This package uses the original fonts GentiumPlus to make the regular and
-italic styles and GentiumBasic to make the bold and bold italic styles,
-and combines them into one \TeX-world family.
-
-GentiumPlus is a serif family designed to support a wide range of Latin,
-Greek and Cyrillic characters. It currently includes just the regular
-and italic style, as well as smallcaps.
-
-GentiumBasic has just the Latin characters and it even lacks some Latin
-characters found in GentiumPlus. Therefore, the bold and bold italic
-styles of this package support fewer languages than the regular and
-italic styles (e.g.\ Czech and Slovak are not fully
-supported). Moreover, GentiumBasic has no smallcaps and no kerning
-pairs. When and if \sil\ releases bold and bold italic GentiumPlus
-fonts, we will switch to those, of course.
-
-This package does not use the Berry fontname scheme, but longer names
-similar to those of Latin Modern, etc. One disadvantage of this choice
-is that you cannot use the additional font selection commands provided
-by the package \pkgname{nfssext-cfr}.
-
-
-\section{Installation}
-
-If you are using a reasonably recent \MiKTeX\ or \TeXLive\ or distro
-installation it should be enough to install the \pkgname{gentium-tug}
-package (if it's not already present).
-
-Otherwise, or if you want to install the font manually, you will in
-general need to perform these steps:
-\begin{enumerate}
-\item choose whether to install the font system-wide or in a personal
- directory;
-\item move or copy the package files to the appropriate location;
-\item refresh the \TeX\ database;
-\item incorporate the included map file fragments for the different
- engines.
-\end{enumerate}
-
-However, that's all that it make sense to say here. It's beyond the
-scope of this Gentium documentation to explain all the myriad ways in
-which \TeX-world map files can be installed and used; there are
-differences between \TeXLive\ and \MiKTeX, too.
-
-Instead, we refer you to an explanation of the system-wide installation,
-with information for both \MiKTeX\ and \TeXLive, at
-\url{https://tug.org/fonts/fontinstall.html}. A corresponding
-explanation for personal installation is at
-\url{https://tug.org/fonts/fontinstall-personal.html}.
-
-Those pages describe using \path{testfont.tex} for a basic test of the
-font; a tfm file name to use with that is \url{ec-gentiumplus-regular}.
-
-To further test your installation and that the package works on your
-system, run \LaTeX\ on this \path{gentium.tex} source file. (You'll
-need some commonly-available \LaTeX\ packages too, or comment them at.)
-The console output and/or log should tell you whether any fonts were not
-found. You can also compare your output with the original
-\path{gentium.pdf}.
-
-
-\section{Gentium \TeX\ support packages}\label{sec:support}
-
-In short, for \LaTeX\ it suffices to include \verb|\usepackage{gentium}|
-in your document preamble, and for \ConTeXtMKIV,
-\verb|\setupbodyfont[gentium]|. Details follow.
-
-The only prerequisite is that the \LaTeX\ package (\path{gentium.sty})
-requires \pkgname{xkeyval}, which you almost certainly already have.
-
-
-\subsection{Encodings}\label{sec:encs}
-
-The package supports not only the most common Latin encodings such as
-\textsc{ot1}, TeXnANSI/\textsc{ly1}, Cork/\textsc{ec}/\textsc{t1} and
-Text Companion/\textsc{ts1} encodings, but also (in regular and italic)
-other Latin, Greek and Cyrillic encodings. Most characters in the text
-encodings and some of those in the Text Companion encoding are
-available, including the~\texteuro. You can see the available encodings
-in table~\ref{encodings}. The Greek encoding LGR is supported only in
-\LaTeX, and AGR only in \ConTeXt.
-
-\begin{table}[h]
-\centering
- \begin{tabular}{lll}
- \toprule
- script & available encodings & styles \\
- \midrule
- Latin & OT1, T1, LY1, L7x, QX, T5, TS1 & regular, italic, bold,
- bold italic \\
- Cyrillic & T2A, T2B, T2C, X2 & regular, italic\\
- Greek & LGR (\LaTeX), AGR (\ConTeXt) & regular, italic \\
- \bottomrule
- \end{tabular}
- \caption{Available encodings in \pkgname{gentium-tug}.}
- \label{encodings}
-\end{table}
-
-The regular and italic styles support all these Latin, Greek and Cyrillic
-encodings. They support also small caps for the Latin and Cyrillic encodings,
-but there are no small caps for Greek.
-
-The bold and bold italic styles support only the Latin encodings and they
-have no small caps.
-
-Cork/T1 encoding lacks visible space, cwm (compound work mark),
-SS and the character for composing permille sign.
-
-Missing characters in bold styles for Latin encodings:
-
-T1: Aogonek / aogonek, Eogonek / eogonek, Lcaron / lcaron,
- Scedilla / scedilla, uni021A (Tcommaaccent) / uni021B (tcommaaccent),
- dcaron, tcaron
-
-L7x: Rcommaaccent, Gcommaaccent, Kcommaaccent, Lcommaaccent, Ncommaaccent,
- Aogonek, Eogonek, Iogonek, Uogonek
-
-QX: Aogonek, Eogonek, Iogonek, uni021A (Tcommaaccent)
-
-
-\subsection{\LaTeX}
-\label{sec:latex-package}
-
-To use Gentium fonts in a \LaTeX\ document, add
-\verb|\usepackage{gentium}| to your document preamble. This will set
-the default serif/roman family to \fname{gentium}.
-
-If you want to use Gentium together with another font (sans or
-typewriter) with a different x-height, you should consider using the
-option \verb|scaled|. This scales Gentium font and if you choose the
-right scaling factor, you will get the same x-height of both fonts.
-Here is an example of this option:
-\begin{verbatim}
-\usepackage[scaled=0.9]{gentium}
-\end{verbatim}
-
-
-\subsection{\ConTeXt}
-\label{sec:context-package}
-
-In \ConTeXtMKIV, to switch to the Gentium typeface you only need:
-\begin{verbatim}
-\setupbodyfont[gentium]
-\end{verbatim}
-
-In \ConTeXtMKII, before doing that you need either (for \pdfTeX):
-\begin{verbatim}
-\usetypescriptfile[type-gentium]
-\usetypescript[gentium][ec] % or whatever encoding
-\end{verbatim}
-or (for \XeTeX):
-\begin{verbatim}
-\usetypescriptfile[type-gentium]
-\usetypescript[gentium]
-\end{verbatim}
-
-
-\subsection{Changes in the Type~1 fonts vs.\ the TrueType originals}
-
-The shapes of all characters in the Type~1 fonts are the same as in the
-original TrueType fonts, except for the unavoidable changes are induced
-by the format conversion (that is, the spline representations are
-necessarily different).
-
-However, a few small changes---hopefully improvements---were made to the
-metrics of the GentiumPlus family (that is, regular and italic; bold and
-bold italic are untouched). The Type~1 fonts are used to generate the
-\TeX\ font metric files (tfm), so these changes propagate to the 8-bit
-engines like \pdfTeX.
-
-The first change concerns Greek. 8-bit Greek encodings (LGR and AGR) do
-not use precomposed accented capital letters. These letters are composed
-as a sequence of two glyphs: accent + capital letter. The problem is
-that this sequence does not look like the precomposed letter---there is
-often big space between the accent and the letter. Therefore, there are
-some extra kerning pairs between accents and capital Greek
-letters. These kerning pairs are created automatically (the script is
-included in the sources) and the goal is to have the same relative
-position between the accent and the letter as in the precomposed
-letter. Thanks to these extra kerning pairs you should get better
-results for 8-bit engines. These changes are irrelevant for Unicode
-engines---they use the precomposed letters.
-
-Another change concerning Greek was made in July 2019 (version 1.1.1):
-for the LGR encoding only (files \verb|lgr-gentiumplus-regular.tfm| and
-\verb|lgr-gentiumplus-regular.tfm|), ligatures were added such that a
-sigma at the end of a word (i.e., the compound-word-mark as a boundary
-character) or followed by punctuation is automatically changed to a
-final sigma, as is usual for that encoding. Thanks to Ralf Stubner for
-suggesting and then implementing this.
-
-The second general change is in the letters dcaron (ď) and lcaron
-(ľ) that are used in the Czech and Slovak languages. (There was
-no need to change tcaron (ť) and Lcaron (Ľ) with the same
-accent.) There is no change of their shapes, and their advance widths
-are also untouched---the change is to add several kerning pairs with
-quite big negative values. Without these changes there was often a large
-space between dcaron or lcaron and the following letter, so the changes
-make the words containing these letters much more compact. You get these
-changes automatically if you use 8-bit engines. If you use Unicode
-engines with the original TrueType fonts, you get the original
-metrics. However, you can tell the Unicode engines to use the Type~1
-fonts (which append \verb|PS| to the family name) like this:
-\begin{verbatim}
-\usepackage{fontspec}
-\setmainfont{GentiumPlusPS}
-\end{verbatim}
-Then you get the additional kern pairs for dcaron and lcaron. The
-unfortunately disadvantage is that you cannot use small caps.
-
-The last (similar) change is that additional kerning pairs were added to
-the Type~1 fonts for accented Latin letters and small caps. The original
-TrueType fonts have no such kerning pairs. As with the Czech/Slovak
-changes, you get these changes automatically if you use 8-bit
-engines. If you use Unicode engines with the original TrueType fonts,
-you get the original metrics, but you can override as above (but since
-you cannot use small caps with that method, the kerning pairs for small
-caps become irrelevant).
-
-
-\section{Known bugs}
-
-There are problems in older versions of \pdfTeX\ with small caps when
-using TrueType fonts. In particular, the Latin encoding \textsc{t5} and all
-Cyrillic encodings are unusable. You can use the Type~1 version of the
-fonts or at least \pdfTeX\ version 1.40.13 to avoid these problems.
-
-The Gentium fonts are a work in progress and as such they still miss
-some features like kerning pairs for some letters. Currently, there are
-no kerning pairs in the GentiumBasic family at all and the GentiumPlus
-family has kerning pairs just for Latin letters without accents and for
-Greek letters; there are no kerning pairs for small caps, accented Latin
-letters or Cyrillic letters. The Type~1 fonts in this package have some
-additional kerning pairs for accented Latin letters and for small
-caps. Kerning pairs for Cyrillic are under consideration.
-
-
-\section{License}
-
-The fonts in this page, both the \sil\ originals and the derived Type~1
-versions, are released under \textsc{ofl}. The \TeX\ support files
-are licensed under the Expat License. Here are the full license texts.
-
-
-\subsection{SIL Open Font License}
-
-\hfuzz=1.4pt
-
-Copyright (c) 2003-2011 SIL International (https://www.sil.org/),
-with Reserved Font Names ``Gentium'' and ``SIL''.
-
-This Font Software is licensed under the SIL Open Font License, Version 1.1.
-This license is copied below, and is also available with a FAQ at:
-http://scripts.sil.org/OFL
-
-
-% TODO: Try to have the similar look as the text version
-%-----------------------------------------------------------
-SIL OPEN FONT LICENSE Version 1.1 --- 26 February 2007
-%-----------------------------------------------------------
-
-
-PREAMBLE
-
-The goals of the Open Font License (OFL) are to stimulate worldwide
-development of collaborative font projects, to support the font creation
-efforts of academic and linguistic communities, and to provide a free and
-open framework in which fonts may be shared and improved in partnership
-with others.
-
-The OFL allows the licensed fonts to be used, studied, modified and
-redistributed freely as long as they are not sold by themselves. The
-fonts, including any derivative works, can be bundled, embedded,
-redistributed and/or sold with any software provided that any reserved
-names are not used by derivative works. The fonts and derivatives,
-however, cannot be released under any other type of license. The
-requirement for fonts to remain under this license does not apply
-to any document created using the fonts or their derivatives.
-
-
-DEFINITIONS
-
-``Font Software'' refers to the set of files released by the Copyright
-Holder(s) under this license and clearly marked as such. This may
-include source files, build scripts and documentation.
-
-``Reserved Font Name'' refers to any names specified as such after the
-copyright statement(s).
-
-``Original Version'' refers to the collection of Font Software components as
-distributed by the Copyright Holder(s).
-
-``Modified Version'' refers to any derivative made by adding to, deleting,
-or substituting---in part or in whole---any of the components of the
-Original Version, by changing formats or by porting the Font Software to a
-new environment.
-
-``Author'' refers to any designer, engineer, programmer, technical
-writer or other person who contributed to the Font Software.
-
-
-PERMISSION \& CONDITIONS
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of the Font Software, to use, study, copy, merge, embed, modify,
-redistribute, and sell modified and unmodified copies of the Font
-Software, subject to the following conditions:
-
-1) Neither the Font Software nor any of its individual components,
-in Original or Modified Versions, may be sold by itself.
-
-2) Original or Modified Versions of the Font Software may be bundled,
-redistributed and/or sold with any software, provided that each copy
-contains the above copyright notice and this license. These can be
-included either as stand-alone text files, human-readable headers or
-in the appropriate machine-readable metadata fields within text or
-binary files as long as those fields can be easily viewed by the user.
-
-3) No Modified Version of the Font Software may use the Reserved Font
-Name(s) unless explicit written permission is granted by the corresponding
-Copyright Holder. This restriction only applies to the primary font name as
-presented to the users.
-
-4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
-Software shall not be used to promote, endorse or advertise any
-Modified Version, except to acknowledge the contribution(s) of the
-Copyright Holder(s) and the Author(s) or with their explicit written
-permission.
-
-5) The Font Software, modified or unmodified, in part or in whole,
-must be distributed entirely under this license, and must not be
-distributed under any other license. The requirement for fonts to
-remain under this license does not apply to any document created
-using the Font Software.
-
-
-TERMINATION
-
-This license becomes null and void if any of the above conditions are
-not met.
-
-
-DISCLAIMER
-
-\textsc{The font software is provided ``as is'', without warranty of any kind,
-express or implied, including but not limited to any warranties of
-merchantability, fitness for a particular purpose and noninfringement
-of copyright, patent, trademark, or other right. In no event shall the
-copyright holder be liable for any claim, damages or other liability,
-including any general, special, indirect, incidental, or consequential
-damages, whether in an action of contract, tort or otherwise, arising
-from, out of the use or inability to use the font software or from
-other dealings in the font software.}
-
-
-\subsection{Expat License}
-
-Copyright (c) 2008-2019 TeX Users Group
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-``Software''), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be included
-in all copies or substantial portions of the Software.
-
-\textsc{The software is provided ``as is'', without warranty of any kind,
-express or implied, including but not limited to the warranties of
-merchantability, fitness for a particular purpose and noninfringement.
-In no event shall the authors or copyright holders be liable for any
-claim, damages or other liability, whether in an action of contract,
-tort or otherwise, arising from, out of or in connection with the
-software or the use or other dealings in the software.}
-
-
-
-% OT1 is the same for regular and italic style (like TeX Gyre, unlike
-% Computer Modern)---this might go to the bugs section.
-
-% Cyrillic encodings use some letters with tail instead of with descender.
-
-
-% TODO
-
-% Show the available encodings in a better way (probably something
-% similar to README), probably use small caps. Look at Clea's tables
-% if they are better than what I wrote.
-
-% Improve the LaTeX logo in Gentium (not so much related to this
-% documentation).
-
-% Search for gentiumplus and vgx---the latter shouldn't be present.
-
-% Scale the monospaced font to match the x-height.
-
-% Change the license and other information in the header.
-
-
-% NOTES TO CLEA
-
-% Current (unlike Clea's) LY1 doesn't contain Wcircumflex and others.
-% Look at it!
-% \textsc{ly1} is
-% necessary for access to Wcircumflex (Ŵ), wcircumflex (ŵ),
-% Ycircumflex (Ŷ) and ycircumflex (ŷ) as pre-composed
-% glyphs.
-
-% Look what's different from Clea's package.
-
-
-% Some Clea's texts that might be used:
-
-% The final option controls whether Latin Modern is used for sans and
-% typewriter text. Because Computer Modern does not support the
-% TeXnANSI/\textsc{ly1} encoding, you will likely get strange results
-% unless you redefine \path{\sfdefault} and \path{\ttdefault}. Latin
-% Modern is used because it is close to the default Computer Modern fonts
-% and is widely available. If you would prefer that the package not
-% redefine the default sans and typewriter families, use \verb|lm=false|
-% when loading \pkgname{gentiumplus}. To explicitly request the default
-% behaviour, which does redefine these families, use \verb|lm| or
-% \verb|lm=true|.
-
-% Loading \path{gentium.sty} does not affect the setup for
-% mathematics.
-
-\end{document}