summaryrefslogtreecommitdiff
path: root/obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.html
diff options
context:
space:
mode:
Diffstat (limited to 'obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.html')
-rw-r--r--obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.html125
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 &lt;milde&#64;users.sf.net&gt;" />
+<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 &lt;<a class="reference external" href="mailto:milde&#64;users.sf.net">milde&#64;users.sf.net</a>&gt;</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&#64;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{&lt;encoding&gt;}{&lt;family&gt;}{&lt;new-family&gt;}</span></span> selects
+the font family &lt;new-family&gt; as replacement for &lt;family&gt; in the font
+encoding &lt;encoding&gt;. 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">&lt;encoding&gt;</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">&lt;family&gt;</span> and <span class="docutils literal"><span class="pre">&lt;new-family&gt;</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>