diff options
Diffstat (limited to 'obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.html')
-rw-r--r-- | obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.html | 125 |
1 files changed, 125 insertions, 0 deletions
diff --git a/obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.html b/obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.html new file mode 100644 index 0000000000..2c95198cbe --- /dev/null +++ b/obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.html @@ -0,0 +1,125 @@ +<!DOCTYPE html> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> +<meta charset="utf-8" /> +<meta name="generator" content="Docutils 0.21b.dev: https://docutils.sourceforge.io/" /> +<meta name="viewport" content="width=device-width, initial-scale=1" /> +<meta name="dcterms.rights" content="© 2010 Günter Milde <milde@users.sf.net>" /> +<title>substitutefont</title> +<link rel="schema.dcterms" href="http://purl.org/dc/terms/"/> +<link rel="stylesheet" href="../../Python/docutils/docutils/docutils/writers/html5_polyglot/minimal.css" type="text/css" /> +<link rel="stylesheet" href="../../Python/docutils/docutils/docutils/writers/html5_polyglot/responsive.css" type="text/css" /> +</head> +<body> +<main id="substitutefont"> +<h1 class="title">substitutefont</h1> +<p class="subtitle" id="combine-font-families">Combine font families</p> +<dl class="docinfo"> +<dt class="copyright">Copyright<span class="colon">:</span></dt> +<dd class="copyright">© 2010 Günter Milde <<a class="reference external" href="mailto:milde@users.sf.net">milde@users.sf.net</a>></dd> +<dt class="contributor">Contributor<span class="colon">:</span></dt> +<dd class="contributor"><p>Special thanks to Ulrike Fischer who provided +the indirect definition with active <span class="docutils literal">\nfss@catcodes</span>.</p> +</dd> +<dt class="licence">Licence<span class="colon">:</span></dt> +<dd class="licence"><p>This work may be distributed and/or modified under the +conditions of the <a class="reference external" href="http://www.latex-project.org/lppl.txt">LaTeX Project Public License</a>, +either version 1.3 of this license or (at your option) +any later version.</p> +</dd> +<dt class="abastract">Abastract<span class="colon">:</span></dt> +<dd class="abastract"><p>In traditional 8-bit LaTeX, fonts are restricted to 256 glyphs +per file. To support different languages and scripts, the New +Font Selection Scheme uses a set of TeX font encodings +<a class="citation-reference" href="#encguide" id="citation-reference-1" role="doc-biblioref">[encguide]</a>.</p> +<p>Many Latin TeX fonts do not support Greek or Cyrillic, while +many non-Latin fonts are extensions of a Latin font family but +use a different family name due to license reasons or the +creators preference.</p> +<p>The <cite>substitutefont</cite> package facilitates the task to set up a +font family as substitute for another one in a specified <a class="reference external" href="encguide">font +encoding</a>.</p> +</dd> +<dt class="news">News<span class="colon">:</span></dt> +<dd class="news"><p>The package is obsoleted by the NFSS command +<span class="docutils literal">\DeclareFontfamilySubstitution</span> added to the +LaTeX kernel in the 2020-02 release <a class="citation-reference" href="#ltnews31" id="citation-reference-2" role="doc-biblioref">[ltnews31]</a>.</p> +</dd> +<dt class="source">Source<span class="colon">:</span></dt> +<dd class="source"><p><a class="reference external" href="substitutefont.sty">substitutefont.sty</a></p> +<p>The literate source was converted with <a class="reference external" href="https://pypi.org/project/pylit/">PyLit</a> to <a class="reference external" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> and +with <a class="reference external" href="http://docutils.sourceforge.net/rst.html">Docutils</a> to the HTML documentation <a class="reference external" href="substitutefont.sty.html">substitutefont.sty.html</a>.</p> +</dd> +</dl> +<section id="usage"> +<h2>Usage</h2> +<aside class="admonition admonition-this-package-is-obsolete"> +<p class="admonition-title">This package is obsolete.</p> +<p>Authors are encouraged to use the command +<span class="docutils literal">\DeclareFontfamilySubstitution</span> provided by the LaTeX kernel.</p> +<p>Existing documents can be updated by removing +<span class="docutils literal">\usepackage{substitutefont}</span> and replacing all uses of +<span class="docutils literal">\substitutefont</span> with <span class="docutils literal">\DeclareFontFamilySubstitution</span>.</p> +</aside> +<p>The macro <span class="docutils literal"><span class="pre">\substitutefont{<encoding>}{<family>}{<new-family>}</span></span> selects +the font family <new-family> as replacement for <family> in the font +encoding <encoding>. The substitution must be defined before the first use +of the specified font encoding, preferably in the document preamble. +In contrast to the deprecated <span class="docutils literal">\substitutefontfamily</span> macro provided by +<a class="reference external" href="https://ctan.org/pkg/babel">Babel</a>, <span class="docutils literal">\substitutefont</span> does not write auxiliary files.</p> +<p>The <span class="docutils literal"><encoding></span> is one of the LaTeX font encodings <a class="citation-reference" href="#encguide" id="citation-reference-3" role="doc-biblioref">[encguide]</a>, e.g., T1 +for Latin, T2A for Cyrillic(Russian), or LGR for Greek.</p> +<p>For <span class="docutils literal"><family></span> and <span class="docutils literal"><span class="pre"><new-family></span></span>, use the «TeX names» of the font. +They are defined by a TeX font package’s <span class="docutils literal">*.fd</span> or <span class="docutils literal">*.sty</span> file(s). +LaTeX stores the default family names for Roman, Sans-Serif, and Teletype +fonts in the <span class="docutils literal">\rmdefault</span>, <span class="docutils literal">\sfdefault</span>, and <span class="docutils literal">\ttdefault</span> macros +respectively.</p> +<p>Example: Set the font family to Palatino using the standard package +<cite>mathpazo</cite> for Latin and <a class="reference external" href="https://ctan.org/pkg/gfsdidot">GFS Didot</a> for Greek:</p> +<pre class="literal-block">\usepackage[sc,slantedGreek]{mathpazo} +\usepackage{substitutefont} +\substitutefont{LGR}{\rmdefault}{udidot}</pre> +<p>For details on LaTeX font selection, see <a class="citation-reference" href="#encguide" id="citation-reference-4" role="doc-biblioref">[encguide]</a> and <a class="citation-reference" href="#fntguide" id="citation-reference-5" role="doc-biblioref">[fntguide]</a>.</p> +</section> +<section id="tests-examples"> +<h2>Tests/Examples</h2> +<ul class="simple"> +<li><p>Simple test with Latin fonts: +<a class="reference external" href="substitutefont-test.tex">substitutefont-test.tex</a>, <a class="reference external" href="substitutefont-test.pdf">substitutefont-test.pdf</a></p></li> +<li><p>Palatino with Greek from <a class="reference external" href="https://ctan.org/pkg/gfsdidot">GFS Didot</a>: +<a class="reference external" href="greek-palatino-didot.tex">greek-palatino-didot.tex</a>, <a class="reference external" href="greek-palatino-didot.pdf">greek-palatino-didot.pdf</a></p></li> +<li><p>Times/Helvetica/Courier (<a class="reference external" href="https://ctan.org/pkg/newtx">newtx</a>) with <a class="reference external" href="https://ctan.org/pkg/gfsartemisia">GFS Artemisia</a>, <a class="reference external" href="https://ctan.org/pkg/gfsneohellenic">GFS +Neohellenic</a>, and teletype from the <a class="reference external" href="https://ctan.org/pkg/cbgreek-complete">CB</a> fonts: +<a class="reference external" href="greek-times-artemisia.tex">greek-times-artemisia.tex</a>, <a class="reference external" href="greek-times-artemisia.pdf">greek-times-artemisia.pdf</a> +(see also package <a class="reference external" href="https://ctan.org/pkg/txfontsb">txfontsb</a>)</p></li> +<li><p>Latin Modern with Cyrillic from <a class="reference external" href="https://ctan.org/pkg/cm-lgc">CM LGC</a>: +<a class="reference external" href="cyrillic-lm-lgc.tex">cyrillic-lm-lgc.tex</a>, <a class="reference external" href="cyrillic-lm-lgc.pdf">cyrillic-lm-lgc.pdf</a></p></li> +<li><p>Times/Helvetica/Courier (TeX Gyre) with Cyrillic <a class="reference external" href="https://ctan.org/pkg/paratype">ParaType</a> fonts: +<a class="reference external" href="cyrillic-paratype.tex">cyrillic-paratype.tex</a>, <a class="reference external" href="cyrillic-paratype.pdf">cyrillic-paratype.pdf</a></p></li> +</ul> +</section> +<section id="references"> +<h2>References</h2> +<div role="list" class="citation-list"> +<div class="citation" id="encguide" role="doc-biblioentry"> +<span class="label"><span class="fn-bracket">[</span>encguide<span class="fn-bracket">]</span></span> +<span class="backrefs">(<a role="doc-backlink" href="#citation-reference-1">1</a>,<a role="doc-backlink" href="#citation-reference-3">2</a>,<a role="doc-backlink" href="#citation-reference-4">3</a>)</span> +<p>Frank Mittelbach, Robin Fairbairns, Werner Lemberg, +LaTeX3 Project Team, <cite>LaTeX font encodings</cite>: +<a class="reference external" href="https://mirrors.ctan.org/macros/latex/doc/encguide.pdf">https://mirrors.ctan.org/macros/latex/doc/encguide.pdf</a>.</p> +</div> +<div class="citation" id="fntguide" role="doc-biblioentry"> +<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#citation-reference-5">fntguide</a><span class="fn-bracket">]</span></span> +<p>LaTeX3 Project Team, <cite>LaTeX 2e font selection</cite>: +<a class="reference external" href="https://mirrors.ctan.org/macros/latex/doc/fntguide.pdf">https://mirrors.ctan.org/macros/latex/doc/fntguide.pdf</a>.</p> +</div> +<div class="citation" id="ltnews31" role="doc-biblioentry"> +<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#citation-reference-2">ltnews31</a><span class="fn-bracket">]</span></span> +<p><cite>LaATeX News</cite>, Issue 31, February 2020, p. 3: +<a class="reference external" href="https://www.latex-project.org/news/latex2e-news/ltnews31.pdf">https://www.latex-project.org/news/latex2e-news/ltnews31.pdf</a>.</p> +</div> +</div> +</section> +</main> +</body> +</html> |