Changeset 82ea9e2 for x


Ignore:
Timestamp:
11/29/2023 07:58:24 AM (7 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:
1307636
Parents:
a5d96b7
Message:

tuningfonts -

Use a capital for Fontconfig, to match other packages.

Location:
x/installing
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • x/installing/TTF-and-OTF-fonts.xml

    ra5d96b7 r82ea9e2  
    2727      Type1 fonts were added, but the desktop world moved on to using TrueType
    2828      and Open Type fonts. To support these, Xorg uses Xft, the X FreeType
    29       interface library, with fontconfig (see previous page for details of
    30       fontconfig including how fonts are selected and various reasons why a
     29      interface library, with Fontconfig (see previous page for details
     30      including how fonts are selected and various reasons why a
    3131      font might be ignored).
    3232    </para>
    … …  
    136136      In the past, everybody recommended running <command>fc-cache</command>
    137137      as the &root; user after installing or removing fonts, but this is not
    138       necessary anymore on Linux, <application>fontconfig</application> will do
     138      necessary anymore on Linux, <application>Fontconfig</application> will do
    139139      it automatically if needed as well as if the font caches are more than 30
    140140      seconds old. However, if you add a font and want to use it immediately,
    … …  
    311311      Georgian and some other glyphs. In the absence of the Bitstream Vera
    312312      fonts (which had much less coverage), these were the default fallback
    313       fonts for 'Latin' languages. As of fontconfig-2.14, if the Noto 'Latin'
     313      fonts for 'Latin' languages. As of Fontconfig-2.14, if the Noto 'Latin'
    314314      fonts have been installed they will be prioritised ahead of DejaVu.
    315315    </para>
    … …  
    335335      <ulink url="https://fontlibrary.org/en/font/gelasio">Gelasio</ulink> is
    336336      metrically compatible with MS Georgia and
    337       <application>fontconfig</application> will use it if MS Georgia is
     337      <application>Fontconfig</application> will use it if MS Georgia is
    338338      requested but is not installed.
    339339    </para>
    … …  
    388388      Although many old posts recommend installing these fonts for
    389389      output which looks better, less old posts say that these are
    390       'ugly' or 'broken' with modern fontconfig, Freetype and Pango.
     390      'ugly' or 'broken' with modern Fontconfig, Freetype and Pango.
    391391      Most people will not want to install any of these fonts.
    392392    </para>
    … …  
    425425
    426426    <para>
    427       Those three fonts are the first-choice preferences of fontconfig for text
     427      Those three fonts are the first-choice preferences of Fontconfig for text
    428428      in those three alphabets, and they are updated frequently to cover recent
    429429      Unicode additions such as the extensions for phonetic transcription in
    … …  
    456456    <para>
    457457      For writing systems not using the Latin, Greek or Cyrillic alphabets the
    458       Noto fonts are not preferred by fontconfig. If you use a Noto font for
     458      Noto fonts are not preferred by Fontconfig. If you use a Noto font for
    459459      a modern language where another installed font also covers it (e.g. the
    460460      DejaVu conts cover several Right-to-Left alphabets), you might need to
    461       set a preference for fontconfig - see the previous page.
     461      set a preference for Fontconfig - see the previous page.
    462462    </para>
    463463
    … …  
    511511
    512512    <para>
    513       For indic languages, fontconfig now prefers Lohit fonts (Sanskrit for 'red').
     513      For indic languages, Fontconfig now prefers Lohit fonts (Sanskrit for 'red').
    514514      They can be found at <ulink url=
    515515      "https://releases.pagure.org/lohit/">pagure.org</ulink>         
    … …  
    528528
    529529    <para>
    530       Also, <application>fontconfig</application> prefers Chinese to Japanese
     530      Also, <application>Fontconfig</application> prefers Chinese to Japanese
    531531      by default. Tuning that is covered at <xref linkend="prefer-chosen-CJK-fonts"/>.
    532532    </para>
    … …  
    548548      written in Mandarin. The UMing HK, Noto Sans HK and WenQuanYi Zen Hei
    549549      fonts all seem to cover Hong Kong usage
    550       (<application>fontconfig</application> disagrees about Noto Sans HK).
     550      (<application>Fontconfig</application> disagrees about Noto Sans HK).
    551551    </para>
    552552
    … …  
    700700      Zen Hei</ulink> provides a Sans-Serif font which covers all CJK scripts
    701701      including Korean. Although it includes old-style conf files, these are
    702       not required: <application>fontconfig</application> will already treat
     702      not required: <application>Fontconfig</application> will already treat
    703703      these fonts (the 'sharp' contains bitmaps, the monospace appears not
    704704      to be Mono in its ASCII part) as Sans, Serif, and Monospace. If all
    … …  
    737737      <ulink url='https://moji-or-jp.translate.goog/ipafont/?_x_tr_sl=auto&amp;_x_tr_tl=en&amp;_x_tr_hl=en&amp;_x_tr_pto=wapp'>Google Translate</ulink>
    738738      on the home page, then click on the download link for IPAex Font Ver.004.01.
    739       Unfortunately, <application>fontconfig</application> only knows about
     739      Unfortunately, <application>Fontconfig</application> only knows about
    740740      the older IPAfonts and the forked IPA Mona font (which is not easily
    741741      available and which apparently does not meet Debian's Free Software
    742742      guidelines). If you install the IPAex fonts, you may want to make it known
    743       to fontconfig. Please see <xref
     743      to Fontconfig. Please see <xref
    744744      linkend="prefer-chosen-CJK-fonts"/> for one way to accomplish this.
    745745    </para>
    … …  
    774774      Gothic are the main Sans fonts. BLFS previously recommended the
    775775      Baekmuk fonts, but the Nanum and Un fonts are now preferred to Baekmuk by
    776       <application>fontconfig</application> because of user requests.
     776      <application>Fontconfig</application> because of user requests.
    777777    </para>
    778778

  • x/installing/tuning-fontconfig.xml

    ra5d96b7 r82ea9e2  
    2626      If you only read text in English, and are happy with the common libre
    2727      fonts listed on the next page, you may never need to worry about the
    28       details of how <application>fontconfig</application> works. But there are
     28      details of how <application>Fontconfig</application> works. But there are
    2929      many things which can be altered if they do not suit your needs.
    3030    </para>
    … …  
    4141    <para>
    4242      Unfortunately, some of the terminology is ambiguous (e.g. 'font face' can
    43       mean a name known to fontconfig, <emphasis>or</emphasis> the ordinary,
     43      mean a name known to Fontconfig, <emphasis>or</emphasis> the ordinary,
    4444      condensed, etc variations of a font).
    4545    </para>
    … …  
    105105      The Xft font protocol provides antialiased font rendering through
    106106      <application>freetype</application>, and fonts are controlled from the
    107       client side using <application>fontconfig</application> (except for
     107      client side using <application>Fontconfig</application> (except for
    108108      <xref linkend="rxvt-unicode"/> which can use fonts listed in
    109109      <filename>~/.Xresources</filename>, and <xref linkend="abiword"/> which
    … …  
    149149
    150150    <para>
    151       The following commands may be helpful when working with fontconfig,
     151      The following commands may be helpful when working with Fontconfig,
    152152      particularly if you are interested in overriding which font will be
    153153      chosen. 'TYPE' should be one of serif, sans-serif or monospace.
    … …  
    166166      see what happens if a font you have not installed is requested, but you
    167167      can also use it if the system is giving you a different font from
    168       what you expected (perhaps because <application>fontconfig</application>
     168      what you expected (perhaps because <application>Fontconfig</application>
    169169      does not think that the font supports your language).
    170170    </para>
    … …  
    173173      <command>fc-match -a <replaceable>Type</replaceable> | less</command> :
    174174      provides a list of all fonts which can be used for that type (Monospace,
    175       Sans Sasn-serif, Serif <emphasis>(capital letters optional)</emphasis>).
    176       Note that in-extremis <application>fontconfig</application> will take a
     175      Sans Sans-serif, Serif <emphasis>(capital letters optional)</emphasis>).
     176      Note that in-extremis <application>Fontconfig</application> will take a
    177177      glyph from any available font, even if it is not of the specified type,
    178178      and unless it knows about the font's type it will assume it is Sans.
    … …  
    349349
    350350    <para>
    351       All remaining scripts for which fontconfig has preferences (CJK scripts,
     351      All remaining scripts for which Fontconfig has preferences (CJK scripts,
    352352      Indic scripts) are dealt with in <filename>65-nonlatin.conf</filename>.
    353353      These are again nominally grouped as Serif, Sans-Serif, Monospace. Of the
    … …  
    387387
    388388    <para>
    389       Before fontconfig-2.14, the first preferred Latin font family was Bitstream
     389      Before Fontconfig-2.14, the first preferred Latin font family was Bitstream
    390390      Vera. In practice that was rarely used because it covered so little. After
    391391      that, DejaVu was the next preferred family, so people were recommended to
    … …  
    415415
    416416    <para>
    417       For 'fantasy' there are no free fonts, so fontconfig will fall back to
     417      For 'fantasy' there are no free fonts, so Fontconfig will fall back to
    418418      sans-serif.
    419419    </para>
    … …  
    421421    <para>
    422422      For 'cursive', the only free font is TeX Gyre Chorus as an alias for
    423       ITC Zapf chancery, otherwise fontconfig will again fall back to sans-serif.
     423      ITC Zapf chancery, otherwise Fontconfig will again fall back to sans-serif.
    424424    </para>
    425425
    … …  
    435435
    436436    <para>
    437       Since fontconfig-2.12.5, there is also generic family matching for some
     437      Since Fontconfig-2.12.5, there is also generic family matching for some
    438438      emoji and math fonts, please see {45,60}-generic.conf.
    439439    </para>
    … …  
    564564      installed. Now, many people will not need to install any of them. But if
    565565      for some reason you have installed one or more bitmap fonts, you can
    566       prevent them from being used by <application>fontconfig</application> by
     566      prevent them from being used by <application>Fontconfig</application> by
    567567      creating the following file as the &root; user :
    568568    </para>
    … …  
    650650          system in a newer version, and if you have multiple versions of a font
    651651          it is unclear which one will be used by
    652           <application>fontconfig</application>.
     652          <application>Fontconfig</application>.
    653653        </para>
    654654      </listitem>
    … …  
    740740&lt;!-- prefer Nimbus Roman No9 L for Times New Roman as well as for Times,
    741741 without this Tinos and Liberation Serif take precedence for Times New Roman
    742  before fontconfig falls back to whatever matches Times --&gt;
     742 before Fontconfig falls back to whatever matches Times --&gt;
    743743    &lt;alias binding="same"&gt;
    744744        &lt;family&gt;Times New Roman&lt;/family&gt;
    … …  
    786786            with an old conf file preferring it for zh-tw and zh-hk language
    787787            codes (and for sans-serif and monospace). But without the conf file,
    788             fontconfig will only treat it as suitable for zh-hk.
     788            Fontconfig will only treat it as suitable for zh-hk.
    789789            The conf file needs to be edited to current style and will then be
    790790            prepended, so specifying UMing does not belong in this
    … …  
    861861      installed in <filename class="directory">/etc/fonts/conf.d</filename>.
    862862      However, if you do that and then use a terminal to run any command which
    863       uses <application>fontconfig</application> you may see error messages such
     863      uses <application>Fontconfig</application> you may see error messages such
    864864      as :
    865865    </para>
    … …  
    873873    <para>
    874874      In practice, these old rules do not work. For non-CJK users,
    875       <application>fontconfig</application> will usually do a good job
     875      <application>Fontconfig</application> will usually do a good job
    876876      <emphasis>without</emphasis> these rules. Their origin dates back to when
    877877      CJK users needed handcrafted bitmaps to be legible at small sizes, and
    … …  
    983983      to your local machine. As shiped it will use your default Serif font assuming
    984984      you have one. Edit it to point to a specific installed font using the name
    985       known to fontconfig (also in the *EDITME FONTNAME*  text items) and open it
     985      known to Fontconfig (also in the *EDITME FONTNAME*  text items) and open it
    986986      from your desktop browser. You can also use it to look at a font with only
    987987      two installed weights, e.g. for testing to see if you prefer other weights.
    … …  
    10151015
    10161016    <bridgehead renderas="sect3" id="items-which-can-override-fontconfig"
    1017     xreflabel="Items which can override fontconfig">Items which can override fontconfig</bridgehead>
    1018 
    1019     <para>
    1020       Several desktop environments, as well as some programs, will use fontconfig
     1017    xreflabel="Items which can override fontconfig">Items which can override Fontconfig</bridgehead>
     1018
     1019    <para>
     1020      Several desktop environments, as well as some programs, will use Fontconfig
    10211021      to find fonts but may override certain things.
    10221022    </para>
    … …  
    10251025      GNOME: The settings in org.gnome.desktop.interface can be updated with
    10261026      <application>dconf-editor</application>. You can set the fonts to your preference
    1027       and desired point size. To use the fonts chosen by fontconfig specify e.g.
     1027      and desired point size. To use the fonts chosen by Fontconfig specify e.g.
    10281028      'Sans 12', Serif 11', 'Mono 10' as desired. Also review the antialiasing, hinting
    10291029      and rgba settings.
    … …  
    10311031
    10321032    <para>
    1033       LXQt: Change font settings as necessary to match fontconfig in
     1033      LXQt: Change font settings as necessary to match Fontconfig in
    10341034      <application>lxqt-config-appearance</application>.
    10351035    </para>
    … …  
    10551055      series, use the 'Hamburger' menu to got to Preferences, General, and under Fonts
    10561056      -> Advanced select Sans Serif, Serif, Monospace as appropriate if you wish to use
    1057       the fonts which match fontconfig.  Set the point sizes as desired. In later
     1057      the fonts which match Fontconfig.  Set the point sizes as desired. In later
    10581058      versions, the settings are at Preferences -> Fonts.
    10591059      <!-- FIXME : Ken - when merging, add note in packages to update this when next ESR
    … …  
    10651065      which supports several European languages but had only one weight and no
    10661066      italics or slant showed that although <application>libreoffice</application>
    1067       uses fontconfig to find the font, it created its own bold or slanted text.
     1067      uses Fontconfig to find the font, it created its own bold or slanted text.
    10681068      It is not clear if it will do the same where a font actually has bold weight
    10691069      or an italic style. Also, documentation shows that libreoffice has its own
    10701070      substitution rules for when a codepoint is not found in the selected font,
    1071       but is unclear if those rules apply on Linux using fontconfig.
     1071      but is unclear if those rules apply on Linux using Fontconfig.
    10721072    </para>
    10731073
    … …  
    10891089      The blog entries by <ulink
    10901090      url="https://eev.ee/blog/2015/05/20/i-stared-into-the-fontconfig-and-the-fontconfig-stared-back-at-me/">Eevee</ulink>
    1091       are particularly useful if <application>fontconfig</application> does not
     1091      are particularly useful if <application>Fontconfig</application> does not
    10921092      think your chosen font supports your language, and for preferring some
    10931093      non-MS Japanese fonts when an ugly MS font is already installed.
Note: See TracChangeset for help on using the changeset viewer.