diff options
Diffstat (limited to 'obsolete/macros/latex')
5 files changed, 130 insertions, 143 deletions
diff --git a/obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.html b/obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.html index 6968dc3417..701f5f4498 100644 --- a/obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.html +++ b/obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.html @@ -4,7 +4,7 @@ <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>" /> +<meta name="dcterms.rights" content="© 2010, 2023 Günter Milde <milde@users.sf.net>" /> <title>substitutefont</title> <link rel="schema.dcterms" href="http://purl.org/dc/terms/"/> <style type="text/css"> @@ -792,9 +792,9 @@ mstyle.mathscr, mi.mathscr { <main id="substitutefont"> <h1 class="title">substitutefont</h1> <p class="subtitle" id="combine-font-families">Combine font families</p> -<dl class="docinfo"> +<dl class="docinfo simple"> <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> +<dd class="copyright">© 2010, 2023 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> @@ -805,65 +805,66 @@ conditions of the <a class="reference external" href="http://www.latex-project.o 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> +<aside class="admonition admonition-obsolete"> +<p class="admonition-title">Obsolete:</p> +<p>The package is obsoleted by the LaTeX kernel command +<span class="docutils literal">\DeclareFontFamilySubstitution</span> added in the +2020-02 LaTeX release <a class="citation-reference" href="#ltnews31" id="citation-reference-1" role="doc-biblioref">[ltnews31]</a>.</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> +<section id="description"> +<h2>Description</h2> +<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 <cite>font encodings</cite> <a class="citation-reference" href="#encguide" id="citation-reference-2" 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 facilitated the task to set up a font family +as substitute for another one in a specified font encoding. +It is obsoleted by the standard LaTeX kernel command +<span class="docutils literal">\DeclareFontFamilySubstitution</span>.</p> +</section> +<section id="usage"> +<h2>Usage</h2> +<p>The macro +<span class="docutils literal"><span class="pre">\DeclareFontFamilySubstitution{<encoding>}{<family>}{<new-family>}</span></span> +selects the font family <new-family> as replacement for <family> in the +font encoding <encoding> <a class="citation-reference" href="#fntguide" id="citation-reference-3" role="doc-biblioref">[fntguide]</a>. The substitution must be defined +before the first use of the specified font encoding, preferably in the +document preamble.<a class="superscript" href="#footnote-1" id="footnote-reference-1" role="doc-noteref"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a></p> +<p>The <span class="docutils literal"><encoding></span> is one of the LaTeX <cite>font encodings</cite>, e.g., T1 for +Latin, T2A for Cyrillic(Russian), or LGR for Greek <a class="citation-reference" href="#encguide" id="citation-reference-4" role="doc-biblioref">[encguide]</a>.</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> +<aside class="footnote-list superscript"> +<aside class="footnote superscript" id="footnote-1" role="doc-footnote"> +<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#footnote-reference-1">1</a><span class="fn-bracket">]</span></span> +<p>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> and +<span class="docutils literal">\DeclareFontFamilySubstitution</span> do not write auxiliary files.</p> +</aside> +</aside> +</section> +<section id="examples"> +<h2>Examples</h2> +<p>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> +<p>Using the obsolete <cite>substitutefont</cite> package:</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> +<p>Using the standard command:</p> +<pre class="literal-block">\usepackage[sc,slantedGreek]{mathpazo} +\DeclareFontFamilySubstitution{LGR}{\rmdefault}{udidot}</pre> +<p>Example documents:</p> <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 @@ -874,25 +875,36 @@ Neohellenic</a>, and teletype from the <a class="reference external" href="https <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> +<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> </ul> </section> +<section id="source"> +<h2>Source</h2> +<dl class="simple"> +<dt><a class="reference external" href="substitutefont.sty">substitutefont.sty</a></dt> +<dd><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> <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> +<span class="backrefs">(<a role="doc-backlink" href="#citation-reference-2">1</a>,<a role="doc-backlink" href="#citation-reference-4">2</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> +<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#citation-reference-3">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> +<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#citation-reference-1">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> diff --git a/obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.rst b/obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.rst index 2ad0f0c6a7..a88f814963 100644 --- a/obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.rst +++ b/obsolete/macros/latex/contrib/substitutefont/substitutefont-doc.rst @@ -3,60 +3,56 @@ substitutefont Combine font families ********************* -:Copyright: © 2010 Günter Milde <milde@users.sf.net> +:Copyright: © 2010, 2023 Günter Milde <milde@users.sf.net> + :Contributor: Special thanks to Ulrike Fischer who provided the indirect definition with active ``\nfss@catcodes``. -:Licence: This work may be distributed and/or modified under the - conditions of the `LaTeX Project Public License`_, - either version 1.3 of this license or (at your option) - any later version. - -:Abastract: 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 - [encguide]_. - 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. +:Licence: This work may be distributed and/or modified under the + conditions of the `LaTeX Project Public License`_, + either version 1.3 of this license or (at your option) + any later version. - The `substitutefont` package facilitates the task to set up a - font family as substitute for another one in a specified `font - encoding <encguide>`_. +.. admonition:: Obsolete: -:News: The package is obsoleted by the NFSS command - ``\DeclareFontFamilySubstitution`` added to the - LaTeX kernel in the 2020-02 release [ltnews31]_. + The package is obsoleted by the LaTeX kernel command + ``\DeclareFontFamilySubstitution`` added in the + 2020-02 LaTeX release [ltnews31]_. + + Existing documents can be updated by removing + ``\usepackage{substitutefont}`` and replacing all uses of + ``\substitutefont`` with ``\DeclareFontFamilySubstitution``. -:Source: `<substitutefont.sty>`_ +Description +=========== - The literate source was converted with PyLit_ to reStructuredText_ and - with Docutils_ to the HTML documentation `<substitutefont.sty.html>`__. +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` [encguide]_. -Usage -===== +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. -.. admonition:: This package is obsolete. - - Authors are encouraged to use the command - ``\DeclareFontFamilySubstitution`` provided by the LaTeX kernel. +The `substitutefont` package facilitated the task to set up a font family +as substitute for another one in a specified font encoding. +It is obsoleted by the standard LaTeX kernel command +``\DeclareFontFamilySubstitution``. - Existing documents can be updated by removing - ``\usepackage{substitutefont}`` and replacing all uses of - ``\substitutefont`` with ``\DeclareFontFamilySubstitution``. +Usage +===== -The macro ``\substitutefont{<encoding>}{<family>}{<new-family>}`` 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 ``\substitutefontfamily`` macro provided by -Babel_, ``\substitutefont`` does not write auxiliary files. +The macro +``\DeclareFontFamilySubstitution{<encoding>}{<family>}{<new-family>}`` +selects the font family <new-family> as replacement for <family> in the +font encoding <encoding> [fntguide]_. The substitution must be defined +before the first use of the specified font encoding, preferably in the +document preamble. [#]_ -The ``<encoding>`` is one of the LaTeX font encodings [encguide]_, e.g., T1 -for Latin, T2A for Cyrillic(Russian), or LGR for Greek. +The ``<encoding>`` is one of the LaTeX `font encodings`, e.g., T1 for +Latin, T2A for Cyrillic(Russian), or LGR for Greek [encguide]_. For ``<family>`` and ``<new-family>``, use the «TeX names» of the font. They are defined by a TeX font package's ``*.fd`` or ``*.sty`` file(s). @@ -64,20 +60,31 @@ LaTeX stores the default family names for Roman, Sans-Serif, and Teletype fonts in the ``\rmdefault``, ``\sfdefault``, and ``\ttdefault`` macros respectively. -Example: Set the font family to Palatino using the standard package -`mathpazo` for Latin and `GFS Didot`_ for Greek:: - + +.. [#] In contrast to the deprecated ``\substitutefontfamily`` macro + provided by Babel_, ``\substitutefont`` and + ``\DeclareFontFamilySubstitution`` do not write auxiliary files. + + +Examples +======== + +Set the font family to Palatino using the standard package +`mathpazo` for Latin and `GFS Didot`_ for Greek. + +Using the obsolete `substitutefont` package:: + \usepackage[sc,slantedGreek]{mathpazo} \usepackage{substitutefont} \substitutefont{LGR}{\rmdefault}{udidot} -For details on LaTeX font selection, see [encguide]_ and [fntguide]_. +Using the standard command:: -Tests/Examples -============== + \usepackage[sc,slantedGreek]{mathpazo} + \DeclareFontFamilySubstitution{LGR}{\rmdefault}{udidot} + +Example documents: -* Simple test with Latin fonts: - `<substitutefont-test.tex>`__, `<substitutefont-test.pdf>`__ * Palatino with Greek from `GFS Didot`_: `<greek-palatino-didot.tex>`__, `<greek-palatino-didot.pdf>`__ * Times/Helvetica/Courier (newtx_) with `GFS Artemisia`_, `GFS @@ -88,6 +95,16 @@ Tests/Examples `<cyrillic-lm-lgc.tex>`__, `<cyrillic-lm-lgc.pdf>`__ * Times/Helvetica/Courier (TeX Gyre) with Cyrillic ParaType_ fonts: `<cyrillic-paratype.tex>`__, `<cyrillic-paratype.pdf>`__ +* Simple test with Latin fonts: + `<substitutefont-test.tex>`__, `<substitutefont-test.pdf>`__ + + +Source +====== + +`<substitutefont.sty>`_ + The literate source was converted with PyLit_ to reStructuredText_ and + with Docutils_ to the HTML documentation `<substitutefont.sty.html>`__. References diff --git a/obsolete/macros/latex/contrib/substitutefont/substitutefont.sty b/obsolete/macros/latex/contrib/substitutefont/substitutefont.sty index a90f01abfe..a5a8600ab2 100644 --- a/obsolete/macros/latex/contrib/substitutefont/substitutefont.sty +++ b/obsolete/macros/latex/contrib/substitutefont/substitutefont.sty @@ -18,7 +18,7 @@ \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{substitutefont} -[2023-08-13 v0.1.6 combine font families (obsolete)] +[2023-09-05 v0.1.7 combine font families (obsolete)] % Changelog: % .. class:: borderless @@ -31,6 +31,7 @@ % 2013-11-04 0.1.4 documentation update % 2023-08-13 0.1.5 declare obsolete, update documentation and tests % 2023-08-17 0.1.6 documentation fixes +% 2023-09-05 0.1.7 documentation update % ============ ===== ================================================ % % diff --git a/obsolete/macros/latex/contrib/substitutefont/test-artemisia-greek.pdf b/obsolete/macros/latex/contrib/substitutefont/test-artemisia-greek.pdf Binary files differdeleted file mode 100644 index 2758e3b764..0000000000 --- a/obsolete/macros/latex/contrib/substitutefont/test-artemisia-greek.pdf +++ /dev/null diff --git a/obsolete/macros/latex/contrib/substitutefont/test-artemisia-greek.tex b/obsolete/macros/latex/contrib/substitutefont/test-artemisia-greek.tex deleted file mode 100644 index 4bd193e914..0000000000 --- a/obsolete/macros/latex/contrib/substitutefont/test-artemisia-greek.tex +++ /dev/null @@ -1,43 +0,0 @@ -\documentclass{article} -\usepackage{parskip} -\usepackage[LGR,T1]{fontenc} -\usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref} -\pagestyle{empty} - -\usepackage[scaled=0.97]{newtxtext} -\usepackage{artemisia-greek} - -\begin{document} - -\section*{Times and Artemisia} - -Combine Times from the \href{https://ctan.org/pkg/newtx}{newtx} package -with \href{https://ctan.org/pkg/gfsartemisia}{GFS Artemisia}, -for Greek text. - -% Teststring -\newcommand{\alphabet}{% - abcdefghjiklmnoprqrstuvwxyzäöüß - {\fontencoding{LGR}\selectfont abgdezhjiklmnxoprsctufqyw} \\ - ABCDEFGHJIKLMNOPRQRSTUVWXYZÄÖÜ - {\fontencoding{LGR}\selectfont ABGDEZHJIKLMNXOPRSTUFQYW}% -} - -\begin{description} - \item [Normal:] \alphabet - - \item [it:] \textit{\alphabet} - - \item [sl:] \textsl{\alphabet} - - \item [bf:] \textbf{\alphabet} - - \item [bf it:] \textbf{\textit\alphabet} - - \item [sc:] \textsc{\alphabet} - - % \item [bf sc:] \textsc{\textbf\alphabet} missing in Bodoni - -\end{description} - -\end{document} |