Changeset 9d8ea23


Ignore:
Timestamp:
11/24/2023 04:21:23 AM (6 months ago)
Author:
Ken Moffat <ken@…>
Branches:
12.1, ken/TL2024, ken/tuningfonts, lazarus, plabs/newcss, python3.11, rahul/power-profiles-daemon, trunk, xry111/llvm18
Children:
f98db52
Parents:
d1d1e5d
Message:

tuningfonts: Add lings to navigate, some more command examples.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • x/installing/tuning-fontconfig.xml

    rd1d1e5d r9d8ea23  
    3737      to understand the changes you are making.
    3838    </para>
     39
     40    <para>The following links are to assist navigation in this page.</para>
     41    <itemizedlist>
     42      <listitem>
     43        <para><xref linkend="xft-font-protocol"/></para>
     44      </listitem>
     45      <listitem>
     46        <para><xref linkend="useful-commands"/></para>
     47      </listitem>
     48      <listitem>
     49        <para><xref linkend="the-various-files"/></para>
     50      </listitem>
     51      <listitem>
     52        <para><xref linkend="rules-to-choose-a-font"/></para>
     53      </listitem>
     54      <listitem>
     55        <para><xref linkend="hinting-and-antialiasing"/></para>
     56      </listitem>
     57      <listitem>
     58        <para><xref linkend="disabling-bitmap-fonts"/></para>
     59      </listitem>
     60      <listitem>
     61        <para><xref linkend="adding-extra-directories"/></para>
     62      </listitem>
     63      <listitem>
     64        <para><xref linkend="preferring-certain-fonts"/></para>
     65      </listitem>
     66      <listitem>
     67        <para><xref linkend="fontconfig-user-docs"/></para>
     68      </listitem>
     69      <listitem>
     70        <para><xref linkend="prefer-a-specific-font"/></para>
     71      </listitem>
     72      <listitem>
     73        <para><xref linkend="prefer-chosen-CJK-fonts"/></para>
     74      </listitem>
     75      <listitem>
     76        <para><xref linkend="editing-old-style-conf-files"/></para>
     77      </listitem>
     78      <listitem>
     79        <para><xref linkend="see-also"/></para>
     80      </listitem>
     81    </itemizedlist>
    3982
    4083    </sect2>
    … …  
    90133
    91134    <para>
    92       The following commands may be helpful when working with fontconfig:
     135      The following commands may be helpful when working with fontconfig,
     136      particularly if you are interested in overriding which font will be
     137      chosen. 'TYPE' should be one of serif, sans-serif or monospace.
    93138    </para>
    94139
    … …  
    110155
    111156    <para>
    112       <command>fc-match -a 'Type' | less</command> : provides a list of all
    113       fonts which can be used for that type (Monospace, Sans, Serif). Note that
    114       in-extremis <application>fontconfig</application> will take a glyph from
    115       any available font, even if it is not of the specified type, and unless it
    116       knows about the font's type it will assume it is Sans.
     157      <command>fc-match -a <replaceable>Type</replaceable> | less</command> :
     158      provides a list of all fonts which can be used for that type (Monospace,
     159      Sans Sasn-serif, Serif <emphasis>(capital letters optional)</emphasis>).
     160      Note that in-extremis <application>fontconfig</application> will take a
     161      glyph from any available font, even if it is not of the specified type,
     162      and unless it knows about the font's type it will assume it is Sans.
    117163    </para>
    118164
    … …  
    122168      It does not mean that the reported font will necessarily be able to show
    123169      Japanese ideograms, so a fallback might be used, or some glyphs may be
    124       missing.
     170      missing. For language codes use  ISO-639 value such as 'fr', 'ja', 'zh-cn'.
     171      Note that an unrecognized value such as just 'zh' will not return any
     172      match. To illustrate the fallback, on a system wherei both Noto Sans Mono
     173      and DejaVu Sans Mono are installed, <command>fc-match 'monospace
     174      :lang=en</command> shows Noto Sans Mono will be used, but if the lang is
     175      changed to 'ar' (arabic) DejaVu Sans will be used.
    125176    </para>
    126177
    … …  
    140191      particularly useful for CJK languages, and you can also pass a
    141192      language, e.g. PANGO_LANGUAGE=en;ja (English, then assume Japanese)
    142       or just zh-cn (or other variants - 'zh' on its own is not valid).
     193      or just zh-cn (or other variants such as zh-sg or zh-tw).
    143194    </para>
    144195
    145196    </sect2>
    146197
    147     <sect2 role="configuration" id="the-various-files" xreflabel="The various files">
    148     <title>The various files</title>
     198    <sect2 role="configuration" id="the-various-files" xreflabel="The configuration files">
     199    <title>The configuation files</title>
    149200
    150201    <para>
    … …  
    553604
    554605    <bridgehead renderas="sect3" id="prefer-a-specific-font"
    555     xreflabel="fontconfig-prefer-specific-font">Prefer a specific font</bridgehead>
     606    xreflabel="prefer-specific-font">Prefer a specific font</bridgehead>
    556607
    557608      <para>
Note: See TracChangeset for help on using the changeset viewer.