Changeset 775039f for kde/kf5/noto-fonts.xml

Timestamp:

08/19/2016 03:09:04 AM (7 years ago)

Author:

Ken Moffat <ken@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 7.10, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/inkscape-core-mods, lazarus, lxqt, nosym, perl-modules, plabs/python-mods, qt5new, trunk, upgradedb, xry111/intltool, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

dd7d9b0

Parents:

89e01c0

Message:

Noto-fonts: fix up the instructions for people who use the tarball.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17646 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• kde/kf5/noto-fonts.xml (modified) (5 diffs)

kde/kf5/noto-fonts.xml

@@ -32 +32 @@
 
     <para>
-      The <application>noto-fonts</application> package is a set of fonts
-      used by KF5.
+      The <application>noto-fonts</application> package ('No Tofu' i.e. avoiding
+      boxes with dots [ hex digits ] when a glyph cannot be found) is a set of
+      fonts which aim to cover <emphasis>every glyph in unicode, no matter how
+      obscure</emphasis>. These fonts, or at least the Sans Serif fonts, are
+      used by KF5 (initially only for gtk applications).
     </para>
+
+    <para>
+      Some of these fonts began life as the libre Source Sans Pro fonts from
+      adobe.
+    </para>
+
+    <note><para>As well as the full set, there is a slightly smaller and
+    older set of fonts, with some extra fonts, at
+    <ulink url="&noto-alternate;">&noto-alternate;</ulink> (19 MB). The
+    installation procedures for those are listed separately. Unfortunately,
+    the tarball does not provide the CJK fonts.</para></note>
 
     &lfs79_checked;
@@ -72 +86 @@
     </itemizedlist>
 
-    <note><para>There is a smaller file that contains some of the most common
-    Noto fonts at <ulink url="&noto-alternate;">&noto-alternate;</ulink> 
-    (19 MB).  The installation procedures are similar to the instructions 
-    below.  Just copy the .ttf files in the tarball to a directory
-    in the /usr/share/fonts/ hierarchy.</para></note>
-
+    <note><para>Almost nobody will ever encounter text for which some of these
+    fonts can be used. Consult the wiki to see which fonts you might wish to
+    delete.</para></note>
 
     <bridgehead renderas="sect3">Noto Fonts Dependencies</bridgehead>
@@ -83 +94 @@
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
-      <xref linkend="unzip"/>
+      <xref linkend="unzip"/> (for Noto-hinted.zip)
     </para>
 
@@ -95 +106 @@
 
     <note><para>Unlike most other packages there is no need to unpack the compressed
-    noto package before installation.</para></note>
-
+    Noto-hinted.zip package before installation.</para></note>
 
     <para>
-      Install the <application>Noto Fonts</application> by running the following
-      commands as the <systemitem class="username">root</systemitem> user:
+      To install <application>Noto Fonts</application> from the full Noto-hinted
+      zip file, run the following commands as the
+       <systemitem class="username">root</systemitem> user:
     </para>
 
-<screen><userinput>install -d -m755         /usr/share/fonts/truetype/noto &amp;&amp;
-unzip Noto-hinted.zip -d /usr/share/fonts/truetype/noto &amp;&amp;
-chmod 0644               /usr/share/fonts/truetype/noto/*</userinput></screen>
+<screen><userinput>install -d -m755         /usr/share/fonts/noto   &amp;&amp;
+unzip Noto-hinted.zip -d /usr/share/fonts/noto   &amp;&amp;
+chmod 0644               /usr/share/fonts/noto/* &amp;&amp;
+fc-cache</userinput></screen>
+
+    <para>
+      Alternatively, to install a smaller set from the tarball, untar it
+      as normal.  You will note that there are both
+      <filename class="directory">hinted/</filename> and
+      <filename class="directory">unhinted/</filename> directories, and
+      the documentation suggests that linux users should install the
+      hinted files.
+    </para>
+
+    <para>
+      In fact, there are many other fonts in the <filename
+      class="directory">unhinted</filename> directory, but all except one are
+      historic. The exception is the Noto Sans Symbols font - if Noto Sans is
+      your main font, you will probably want this because of the currency
+      symbols it provides.
+    </para>
+
+    <para>
+      In the <filename class="directory">hinted/</filename> directory there are
+      also some duplicate TTC (TrueType Collection) files for NotoSans which do
+      not provide anything useful and similarly some UI variants which were
+      again a dead end.
+    </para>
+
+    <para>
+      To install from the tarball, run the following commands as the
+       <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen><userinput>install -d -m755         /usr/share/fonts/noto                                 &amp;&amp;
+cp -v LICENSE hinted/*.ttf unhinted/NotoSansSymbols*.ttf /usr/share/fonts/noto &amp;&amp;
+rm -v /usr/share/fonts/noto/Noto*UI*                                           &amp;&amp;
+chmod 0644               /usr/share/fonts/noto/*                               &amp;&amp;
+fc-cache</userinput></screen>
+
+    <para>
+      If you remove any of the fonts, remember to run 'fc-cache' (as root) to
+      update fontconfig.
+    </para>
 
     <para>
@@ -129 +181 @@
         </seg>
         <seg>
-          /usr/share/fonts/truetype/noto 
+          /usr/share/fonts/noto
         </seg>
       </seglistitem>