diff options
Diffstat (limited to 'Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug')
-rw-r--r-- | Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/ChangeLog | 235 | ||||
-rw-r--r-- | Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/FONTLOG.txt | 111 | ||||
-rw-r--r-- | Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/Makefile | 17 | ||||
-rw-r--r-- | Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/README | 181 | ||||
-rw-r--r-- | Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/gentium.pdf | bin | 0 -> 636848 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/gentium.tex | 539 |
6 files changed, 1083 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/ChangeLog b/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/ChangeLog new file mode 100644 index 00000000000..5b5d3bc24ea --- /dev/null +++ b/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/ChangeLog @@ -0,0 +1,235 @@ +$Id: ChangeLog 141 2022-05-19 17:50:08Z karl $ +This file is part of the Gentium package for TeX. +It is licensed under the Expat License, see doc//README for details. + +This file lists internal changes to the Type 1 development. For the changes +to the actual Gentium Plus PS fonts by release, see FONTLOG.txt. + +The SIL release has its own FONTLOG.txt, included in the parallel +GentiumPlus-* directory. Please consult it for a full record of changes +to the fonts. + +2022-05-19 +- numerous changes for the Gentium Plus 6.101 release. We are now + distributing Type 1's for the GentiumPlus-* and GentiumBookPlus-* + fonts, eight fonts in all. Remove vestiges of previously-distributed + fonts. (Pavel) Update manual. (Pavel/Karl) + +2022-05-09 +- adapt Ruby scripts that create the TeX support files for the new fonts. + The scripts do not work with the current version of Ruby, but with the + very old version 1.8.7). I don't use Ruby, except for this update. (Pavel) +- create gentiumbook.sty for using the Gentium Book Plus family (Pavel) + +2022-04-26 +- add several wordlists to see in FontForge how the converted fonts behave + (Pavel) + +2022-04-07 +- add some kerning pairs for Cyrillic letters (Pavel) + +2022-03-29 +- improve scripts that test the converted Type 1 fonts (Pavel) + +2022-03-22 +- fix scripts for small caps; Old fonts used x.SC for small caps, new fonts + use x.sc. (Pavel) + +2022-03-19 +- add documentation for the conversion scripts (Pavel) + +2022-03-18 +- add extra kerns for dcaron and lcaron for the updated fonts (Pavel) + +2022-03-16 +- add TrueType fonts Gentium{,Book}Plus v 6.101 (Pavel) + +2022-03-15 +- adapt font conversion scripts for Python 3 (Pavel) + +2019-07-09 +- update lgr-*.tfm to have ligatures for final sigma. (Ralf) +- we'll call this version 1.1.1, since the glyphs did not change; + corresponding documentation and source updated (Karl) + +2015-04-06 +- update dvips/*.enc to use new names *.sc instead of *.SC. (Pavel/Karl) + +2015-01-31 +- update to GentiumPlus 5.000 TrueType fonts from SIL. (Karl) +- remake Type 1 fonts. (Pavel) +- corresponding small updates to documentation and support files. (All) + +2013-05-17 +- Some changes in the test files. (Pavel) + +2013-04-30 +- More doc and distribution tweaks, resent to Victor. (Karl) + +2013-04-27 +- At the request of Victor Gaultney, changed the advance width of + the letters dcaron and lcaron back to the original value. Replaced + with some extra kerning pairs for the more common combinations. (Pavel) + +2013-03-20 +- Added license statement to more files, tweak docs. (Karl) + +2013-03-14 +- Updated Gentium Plus fonts. (Pavel) + +2013-03-10 +- Changed 'gentium' into 'gentium-tug' by request of SIL. (Mojca) + +2013-02-27 +- Added a script to create CTAN-friendly directory structure. (Mojca) + +2012-04-11 +- Added test files and samples for the differences between the + original TrueType and converted Type 1 fonts. (Pavel) + +2012-04-07 +- Corrected letters Tcedilla and Tcommaaccent in the extra kerning + pairs added to the Type 1 fonts. (Pavel) +- Test file for LGR shows also the italic style. (Pavel) + +2012-03-30 +- Added more kerning pairs for accented letters to the Type 1 + fonts. (Pavel) +- Corrected the kern value for DV in GentiumPlus Regular in the + Type 1 fonts. The value was positive. (Pavel) + +2012-03-22 +- Added more kerning pairs for accented letters to the Type 1 + fonts. (Pavel) + +2012-03-20 +- The scripts for the conversion of the fonts to Type1 can add + kerning pairs for accented Latin letters now. The original TTF + fonts have no such kerning pairs. More such kerning pairs should + be added. (Pavel) + +2012-03-14 +- Added several kerning pairs for small caps in the Type 1 version of + GentiumPlus (original TTFs have no kerning pairs for small caps). + They were added for these combinations: small cap + small cap + (currently without accents), capital letter + small cap and some + punctuation symbols preceeded or followed by small cap letter. + All these kerning pairs are created automatically and they are derived + from the respective kerning pairs for capital letters. (Pavel) + +2012-03-07 +- The Type 1 fonts have "TeX Users Group" as creator now. (Pavel) +- Added license header to some files. (Pavel) + +2012-02-27 +- Added FamilyBlues and FamilyOtherBlues to Type 1 fonts. The fonts + can not be one family (t1lint complained), therefore two fonts + from GentiumPlus are one family and two fonts from GentiumBasic + are other family. (Pavel) +- ForceBold set explicitly (true or false) for Type 1 fonts. (Pavel) +- Added new targets "test" and "kerns" for the makefile building + Type 1 fonts. (Pavel) +- Small clean-up of the Type 1 build scripts. (Pavel) + +2012-02-14 +- Update of the PDF/LaTeX documentation. (Pavel) + +2012-02-10 +- Added build scripts for Type 1 fonts to the subdirectory "type1" in + "source". The fonts are not reencoded to Adobe Standard Encoding (which + created many slots containing ".notdef"). (Pavel) + +2012-02-07 +- Update of the PDF/LaTeX documentation. (Pavel) + +2012-02-06 +- The build scripts for the conversion of the fonts to Type 1 remove + the lookups "mark" and "mkmk" after opening the TrueType font. This + eliminates really huge amount of error messages for GentiumPlus. + The scripts print messages about the current operation now. (Pavel) + +2012-02-05 +- Remove old scripts and refactor ruby sources. (Mojca) +- Different formatting in map files, no functional changes; map files + for ot1, ts1, lgr, t2b, t2c, x2 may be removed in future (Mojca) +- Fix dotlessj (uni0237) in some encodings; + fix scommaaccent & some greek letters in qx encoding. (Mojca) +- Change L7X -> L7x in fd files. (Mojca) +- Fix some typos in licenses, update README. + +2012-02-04 +- Improved the PDF/LaTeX documentation. (Pavel) +- Some clean-up of Cyrillic encodings. (Pavel) +- It's possible to set copyright text in the generated Type 1 + fonts. (Pavel) + +2012-02-03 +- Added documentation in PDF with LaTeX source. Heavily based on the work + by Clea F. Rees. (Pavel) + +2012-01-31 +- Added TS1 encoding. (Pavel) +- Improved test files for LGR Greek and Cyrillics. (Pavel) + +2012-01-30 +- Added the Expat license. + +2012-01-28 +- Added OT1 encoding. (Pavel) + +2012-01-24 +- Removed LIGKERN commands (and similar stuff) from the encoding + files for T2A, T2B, T2C, X2 and LGR (lig files are used instead). + (Pavel) +- Add support for SmallCaps. (Mojca) + +2012-01-20 +- Simplified the file gentium.sty quite a lot, uses xkeyval now. + +2012-01-19 +- Added the possibility for afm2pl to use a lig file if present. (Pavel) +- Added lig files for AGR, LGR, T2A, T2B, T2C and X2. (Pavel) +- The fonts from the previous update copied to the main package. (Pavel) +- Generated support for LGR. (Pavel) +- Added simple test files for LGR and Czech. (Pavel) +- Workaround for 'dcroat' and 'Idotaccent' for EC and T5 encodings. (Mojca) + +2012-01-16 +- Created first serious version of Type 1 fonts based on the script + by Clea F. Rees. Added kerning pairs for the combinations + accent + capital Greek letter. The letters dcaron and lcaron made + narrower than it the original fonts (for better results in Czech + and Slovak). The package still uses the old version of the + fonts. (Pavel) +- Added LGR encoding (no support files generated). (Pavel) + +2012-01-13 +- Add gentium.sty for LaTeX and sample *.fd files (Pavel) +- Write a script to generate ${enc}gentium.fd (Mojca) +- Update ConTeXt support files to new names. (Mojca) +- Add some test files. (Mojca & Pavel) + +2012-01-12 +- Try to create Type1 fonts with ttf2pt1 (just a temporary solution). + Observation: AFM font metrics are not compatible (often 1 point difference). +- Generate tfm files from new ttf fonts. (Mojca) +- Update map files with new names and split gentium.map into + gentium-truetype.map & gentium-type1.map. (Mojca) + +2011-10-17 +- Add t2a, t2b, t2c and x2 encoding files. (Pavel) + +2011-10-06 +- Replace Gen{R,I}102.ttf with Gentium-{R,I}.ttf (version 1.103) + GenA{R,I}102.ttf with GentiumAlt-{R,I}.ttf +- Add GentiumPlus and GentiumPlusCompact (version 1.508) +- TeX support files have not been updated yet. + +2010-10-09 +- Add GenAR102.ttf and GenAI102.ttf (requested by users) + +2010-07-07 +- Fix broken font files and some other typos in ConTeXt typescripts + +2008-11-13 +- First release of ConTeXt support files. diff --git a/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/FONTLOG.txt b/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/FONTLOG.txt new file mode 100644 index 00000000000..6e92af9f0a4 --- /dev/null +++ b/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/FONTLOG.txt @@ -0,0 +1,111 @@ +$Id: FONTLOG.txt 146 2022-05-21 22:17:01Z karl $ +The Gentium Plus PS fonts are Type 1 versions of the TrueType Gentium +fonts released by SIL International. The conversion to Type 1 +necessarily introduces changes in the implementation of the shapes and +the metrics. No changes to the shapes or advance widths have been made +by humans, but a few human-made changes are in the kerning tables; +see below. + +The Gentium Plus PS fonts incorporate the name "Gentium" by permission +of SIL given to the TeX Users Group (TUG). These fonts are released and +maintained by volunteers (see list of people below), under the auspices +of TUG. For internal development changes, see the file ChangeLog. + +The SIL release has its own FONTLOG.txt, included in the parallel +GentiumPlus-* directory. Please consult it for a full record of changes +to the fonts. + +The home page for the Gentium Plus PS fonts and TeX support package: +https://tug.org/gentium +Mailing list: gentium@tug.org (https://lists.tug.org/gentium) + +21 May 2022 Gentium Plus PS version 1.101 +- Update to GentiumPlus 6.101. This contains two font families: Gentium Plus + and Gentium Book Plus. +- All encodings support regular, italic, bold and bold italic styles now. + Previously bold and bold italic styles were available only for Latin + encodings and they missed many accented characters. +- Remove ConTeXt support from this package, since Gentium support has + been in ConTeXt itself for some time. + +9 July 2019 Gentium Plus PS version 1.1.1 +- In lgr-*.tfm (only), add ligatures sigma + boundarychar -> final sigma. + +6 April 2015 Gentium Plus PS version 1.1 +- Update to GentiumPlus 5.000. + +2 July 2013 Gentium Plus PS version 1.0 +- First public release. + + +Basic information +----------------- +Each of the eight fonts in GentiumPlus and GentiumBookPlus (regular, +italic, bold, bold italic) have been converted to Type 1. + +These are the changes in the converted fonts; we hope they will be +incorporated in the original fonts in due time. + +- Some extra kerning pairs were added between accents and capital + Greek letters. + +- There are additional kerning pairs for accented Latin letters, the + Czech/Slovak letters dcaron and lcaron, and for small caps. The + original fonts have no such kerning pairs. Manual corrections are + still needed in some cases, e.g., initial cap followed by small cap. + +- Several kerning pairs were added for Cyrillic letters. There were no + kerning pairs for Cyrillic letters in the original fonts. These pairs + try to improve the most obvious problems, but they are far from + complete. + +- There was a positive kern between the letters D and V in the regular + style of Gentium Plus. The derived font has a negative kern. + +The conversion process, including these changes, is implemented in the +Python and FontForge scripts included in the packages, e.g., ff-gentium.pe. +Except that since the final sigma ligatures added in July 2019 only +involve the TeX files, they were implemented with TeX tools; +see ./source/fonts/gentium-tug/Makefile for specifics. + +Acknowledgements +---------------- +Here is where contributors to the TeX package should be acknowledged. If +you make modifications be sure to add your name (N), email (E), +web-address (W), description (D), and active status (A). This list is +sorted by last name in alphabetical order. + +More acknowledgements can be found in the FONTLOGs for each separate +font project. + +N: Karl Berry +E: karl@freefriends.org +W: https://freefriends.org/~karl/ +D: Documentation, licensing, distribution, SIL <-> TUG contact, etc. +A: yes + +N: Pavel Farář +E: pavel.farar@centrum.cz +D: Cyrillic support, conversion and generation scripts, etc. +A: yes + +N: Mojca Miklavec +E: mojca.miklavec.lists@gmail.com +D: ConTeXt support, conversion and generation scripts, etc. +A: yes + +N: Clea F. Rees +W: [404] http://cardiff.ac.uk/encap/contactsandpeople/profiles/rees-clea.html +D: Original LaTeX support, documentation, conversion. +A: no + +N: Thomas A. Schmitz +E: thomas.schmitz@uni-bonn.de +W: [404] http://www.philologie.uni-bonn.de/personal/schmitz +D: Initial version of TeX support files, AGR encoding, ConTeXt support +A: no + +N: Ralf Stubner +E: ralf.stubner@gmail.com +D: Ligatures for final sigma in lgr-*.tfm. +A: no diff --git a/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/Makefile b/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/Makefile new file mode 100644 index 00000000000..b9190f2c992 --- /dev/null +++ b/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/Makefile @@ -0,0 +1,17 @@ +# $Id: Makefile 141 2022-05-19 17:50:08Z karl $ +# This file is part of the Gentium package for TeX. +# It is licensed under the Expat License, see doc//README for details. + +env = TEXMFHOME=../../../.. +texfot = texfot +gentium.pdf: gentium.tex + $(env) $(texfot) pdflatex '\nonstopmode\pdfsuppresswarningdupmap=1\pdfmapfile{+gentium-type1.map}\input $<' +# read the map file for running out of the development tree, +# without having the package installed, necessarily. + +dist: clean + cd ../../../../source/fonts/gentium-tug \ + && ./make-zip-4CTAN.sh -l + +clean: + rm -f *.aux *.log *.out *.toc diff --git a/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/README b/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/README new file mode 100644 index 00000000000..6cabca7d47a --- /dev/null +++ b/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/README @@ -0,0 +1,181 @@ +$Id: README 146 2022-05-21 22:17:01Z karl $ +The home page for the original SIL Gentium font family is +https://scripts.sil.org/Gentium. + +The home page for this TeX package, gentium-tug, is https://tug.org/gentium. +Mailing list: gentium@tug.org (https://lists.tug.org/gentium) + +This TeX package consists of: + +1. The original (unaltered) GentiumPlus and GentiumBookPlus font +families in TrueType format (eight fonts), as developed by SIL and +released under the OFL. See OFL.txt and OFL-FAQ.txt in the directory +GentiumPlus-6.101. + +2. Converted fonts in PostScript Type 1 format (the same eight fonts), +released under the same terms. These incorporate the name "Gentium" by +permission of SIL given to the TeX Users Group. + +3. LaTeX and other supporting files under the Expat license, whose +text given below (also at https://directory.fsf.org/wiki/License:Expat). + +4. Documentation: the TeX-specific documentation is in gentium.{tex,pdf}, +also under Expat). We have also included the original documentation, +fontlogs, and other files from the SIL distributions, entirely +unaltered, in the Gentium*/ subdirectories here. + +The contributors are listed in the FONTLOG.txt files. + + +ENCODINGS: +========= +The package provides font files needed for both Unicode XeTeX and LuaTeX +as well as 8-bit engines such as pdfTeX and TeX (->dvips). + +For 8-bit engines the following encodings are available: +- Latin: + ot1 OT1 - default encoding in TeX + ec T1 - for most European languages + texnansi LY1 - for most Western European languages + l7x L7x - for Baltic languages + qx QX - for Polish + t5 T5 - for Vietnamese + ts1 TS1 - TeX symbols (for LaTeX) + +- Greek: + lgr (only supported in LaTeX) + +- Cyrillic: + t2a T2A + t2b T2B + t2c T2C + x2 X2 + + +FILES: +===== +See the FONTLOG for high-level descriptions of what comes from what. + +/doc/fonts/gentium-tug + /GentiumPlus-* - the original SIL documentation, including the OFL + /gentium-tug - the TeX-specific documentation +/fonts + /afm/public/gentium-tug - Adobe Font Metrics + (only needed for generating new tfm files) + /enc/dvips/gentium-tug - encoding files + gentium-{ts1,agr,lgr}.enc + gentium-{ot1,ec,texnansi,qx,t5,l7x,t2a,t2b,t2c,x2}{,-sc}.enc + gentium-{ec,t5}-ttf{,-sc}.enc - to get around a bug in pdfTeX (dcroat & Idotaccent) + /map + /dvips/gentium-tug + gentium-type1.map - for TeX and LaTeX + /pdftex/gentium + gentium-{ec,texnansi,qx,t5,l7x,agr,t2a}.map - for ConTeXt MkII + gentium-{ot1,ts1,lgr,t2b,t2c,x2}.map - (not used anywhere; might be removed) + gentium-truetype.map - for pdfTeX and pdfLaTeX + /tfm/public/gentium + {ts1,agr,lgr}-gentium{plus,book}-{regular,italic,bold,bolditalic}.tfm + {ot1,ec,texnansi,qx,t5,l7x,t2a,t2b,t2c,x2}-gentium{plus,book}-{regular,italic,bold,bolditalic}{,-sc}.tfm + /truetype/public/gentium-tug - .ttf fonts from SIL + /type1/public/gentium-tug - .pfb fonts, converted from TrueType by TUG + +/source/fonts/gentium-tug + /lig + gentium-{agr,lgr,t2a,t2b,t2c,x2}.lig - additional ligatures used to generate tfm files + /type1 - scripts for TrueType -> Type1 conversion + afmcreator.py - put text "Comment Creator: TeX Users Group" to afm files + ff-gentium.pe - FontForge script for conversion to Type 1 + generate-extra-kerns.sh - main script for creating extra kerning pairs + greekcorrection.py - create kerns for accent + capital Greek letter + kerncorrection.py - create kerns for Latin and Cyrillic letters + kern-test-greek.txt - test file for Greek accents; use it for manual review + in the Metrics Window of FontForge + kern-word-list-caron.txt - test file for dcaron and lcaron; for FontForge + kern-word-list-cyrillic.txt - test file for Cyrillic letters; for FontForge + Gentium{Book,}Plus-{Regular,Italic,Bold,BoldItalic}-Czech.kern - manual kerns for dcaron and lcaron + Makefile + README + ChangeLog + Makefile + generate-support-files.rb - ruby script to generate different files + gentium.rb - ruby library with support classes and functions + make-zip-4CTAN.sh - construct distribution +/tex + /latex/gentium-tug - support files for LaTeX + gentium.sty + gentiumbook.sty + {ot1,t1,ly1,qx,t5,l7x,ts1,lgr,t2a,t2b,t2c,x2}gentium.fd + + +TODO: +==== +- Update the Ruby scripts for current version of Ruby! + +- Check that there are no f-ligatures in the encodings X2, LGR + and possibly AGR. + +- Improve kerning for accented Latin letters and for Cyrillic letters. + More kerning pairs could be added, but not those that can never occur. + Some manually created kerns could replace the automatically created + ones. + +- Look at the letter Lcaron if the accent should be moved to the left + (reported to SIL). + +- The combination of two commas seems not to give quotedblbase in T1. + Check it and correct using lig file if needed. + +- Use all 8 fonts in gentium.sty and gentiumbook.sty. The added fonts would + represent additional series (weight). The following table shows how it + would look for upright (roman) style: + + gentium gentiumbook +---------------------------------------------------------- +GentiumPlus-Regular medium semi light +GentiumBookPlus-Regular semi bold medium +GentiumPlus-Bold bold semi bold +GentiumBookPlus-Bold extra bold bold + + It would be similar for the italic styles. + + Then the package "gentium" would have 4 weights--the usual medium and bold, + but also semi bold and extra bold. The package "gentiumbook" could add the + semi light and semi bold weights. + +- Check if there are new characters to fill the empty slots in encodings. + +- The code concerning the final sigma should be cleaned-up (some refactoring; + how would it be most useful). See commits 24, 142, 143 and mailing list + thread at: + + https://tug.org/pipermail/gentium/2019q3/thread.html + + Some test file would be usefull. + + +EXPAT LICENSE: +============= +This file is part of the Gentium package for TeX. +The package contains font files licensed under the SIL Open Font License, +while the rest are under the Expat License. + +Copyright (c) 2008-2022 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. + +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. diff --git a/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/gentium.pdf b/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/gentium.pdf Binary files differnew file mode 100644 index 00000000000..547340bfd04 --- /dev/null +++ b/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/gentium.pdf diff --git a/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/gentium.tex b/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/gentium.tex new file mode 100644 index 00000000000..9f37664e205 --- /dev/null +++ b/Master/texmf-dist/doc/fonts/gentium-tug/gentium-tug/gentium.tex @@ -0,0 +1,539 @@ +% !TEX TS-program = pdflatex +% !TEX encoding = UTF-8 Unicode + +% $Id: gentium.tex 146 2022-05-21 22:17:01Z karl $ +% This file is part of the Gentium package for TeX. +% It is licensed under the Expat License, see doc//README for details. + +\documentclass[12pt, english]{article} + +\usepackage{metalogo} +%\setLaTeXa{\scshape a} % the small caps A is sadly too wide for this +\setlogokern{La}{-.28em}% default -.36em +\setlogokern{aT}{-.12em}% default -.15em +% +% \TeX looks ok, but since we have to fix \LaTeX, might as well tweak \TeX +\setlogodrop[TeX]{.45ex}% default .5ex + +\usepackage{babel} +\usepackage[utf8x]{inputenc} % running with pdftex +\usepackage[T1]{fontenc} +\usepackage{gentium} +%\renewcommand{\ttdefault}{lmvtt} % variable tt seems indistinct from text +\usepackage{fancyhdr,lastpage,fancyref} +\usepackage{array,longtable,verbatim} +\usepackage{booktabs} +\usepackage{multirow} +\usepackage{url}\urlstyle{tt} +\usepackage[hidelinks,pdfa]{hyperref} +%\usepackage{microtype} % let the fonts be as they are. +\usepackage[a4paper,headheight=15pt,scale=0.8]{geometry} + % use headheight=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\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,font,fonts,tex,latex,gentium,GentiumPlus,GentiumBookPlus,Gentium,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}\raggedright\noindent + This document briefly describes the + \TeX/\LaTeX\ support provided by this + package, \pkgname{gentium-tug}, for the Gentium font collection + released by \sil. +\end{abstract} + +\tableofcontents + +\section{Introduction} + +% logo debugging +%{\Huge\LaTeX\quad \huge\LaTeX\quad \LARGE\LaTeX\quad \Large\LaTeX\quad +% \large\LaTeX \\\normalsize\LaTeX\quad \small\LaTeX\quad +% \footnotesize\LaTeX\quad \scriptsize\LaTeX\quad \tiny\LaTeX} + +This document explains how to use the \TeX/\LaTeX\ 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}, +and there is a public mailing list at \texttt{gentium@tug.org} +(\url{https://lists.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\ 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 \LaTeX\ documents, feel free to skip to +section~\ref{sec:latex-package}. Gentium support is included in the main +\ConTeXt\ distribution and not through this package. + +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 GentiumPlus 6.101 fonts (families +GentiumPlus and GentiumBookPlus, four fonts each). These two families +together can be considered as one super-family containing eight +different weights. + +GentiumPlus is a seriffed design. The fonts support a wide range of +Latin, Greek and Cyrillic characters. + +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} + +That's all that makes 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 sample 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 out.) 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 general, for \LaTeX\ it suffices to include \verb|\usepackage{gentium}| +in your document preamble. + +Alternatively, you can do \verb|\usepackage{gentiumbook}| to load the +GentiumBookPlus fonts for your document, instead of GentiumPlus. The +most noticeable difference is that the Book fonts are a lighter weight. + +The only prerequisite is that the \LaTeX\ packages (\path{gentium.sty}, +\path{gentiumbook.sty}) require \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 +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. + +\begin{table}[h] +\centering + \begin{tabular}{ll} + \toprule + script & available encodings \\ + \midrule + Latin & OT1, T1, LY1, L7x, QX, T5, TS1 \\ + Cyrillic & T2A, T2B, T2C, X2 \\ + Greek & LGR (\LaTeX), AGR (\ConTeXt) \\ + \bottomrule + \end{tabular} + \caption{Available encodings in \pkgname{gentium-tug}.} + \label{encodings} +\end{table} + +The Latin and Cyrillic encodings support also small caps. + +Cork/T1 encoding lacks visible space, cwm (compound word mark), +SS and the character for composing permille sign. + + +\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}. + +You can also use \verb|\usepackage{gentiumbook}|, which will set the +Gentium Book Plus family. + +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} + +The default definition of the \LaTeX\ logo does not work well with +Gentium. Although \TeX\ does not look too bad by default, since we +change \LaTeX, we also change \TeX. This document modifies the logos +using the \pkgname{metalogo} package as follows: + +\begin{verbatim} +\usepackage{metalogo} +\setlogokern{La}{-.28em}% default -.36em +\setlogokern{aT}{-.12em}% default -.15em +% +\setlogodrop[TeX]{.45ex}% default .5ex +\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 induced +by the format conversion (that is, the spline representations are +necessarily different). + +However, a few explicit changes---hopefully improvements---were made to the +kerns in the GentiumPlus family. 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 for 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, again, 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 +regrettable 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, +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. Several kerning pairs were added also for Cyrillic letters, mostly +the capital ones. + + +\section{Licenses} + +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. + +\begin{raggedright}\small % no hyphenation +\subsection{SIL Open Font License} + +%\hfuzz=1.4pt + +Copyright (c) 2003-2022 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-2022 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.} + +\end{raggedright} +\end{document} + + +% 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. + |