source: kde/kf5/noto-fonts.xml@ 0901194

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY noto-fonts-download-http "https://noto-website-2.storage.googleapis.com/pkgs/Noto-hinted.zip">
  <!ENTITY noto-fonts-download-ftp  " ">
  <!ENTITY noto-fonts-md5sum        "92e5af616ba8f5b420141a37c13b4d1c">
  <!ENTITY noto-fonts-size          "471 MB">
  <!ENTITY noto-fonts-buildsize     "582 MB">
  <!ENTITY noto-fonts-time          "less than 0.1 SBU">
  <!ENTITY noto-alternate           "https://github.com/googlei18n/noto-fonts/archive/v2015-09-29-license-adobe.tar.gz">
]>

<sect1 id="noto-fonts" xreflabel="noto-fonts">
  <?dbhtml filename="noto-fonts.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>Noto Fonts</title>

  <indexterm zone="noto-fonts">
    <primary sortas="a-noto-fonts">noto-fonts</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Noto Fonts</title>

    <para>
      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>

    &lfs7a_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&noto-fonts-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&noto-fonts-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &noto-fonts-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &noto-fonts-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &noto-fonts-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &noto-fonts-time;
        </para>
      </listitem>
    </itemizedlist>

    <note><para>Almost nobody will ever encounter text for which some of these
    fonts can be used. Consult the user notes below to see which fonts you 
    might wish to delete.</para></note>

    <bridgehead renderas="sect3">Noto Fonts Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="unzip"/> (for Noto-hinted.zip)
    </para>

    <para condition="html" role="usernotes">
      User Notes: <ulink url="&blfs-wiki;/noto-fonts"/>
    </para>
  </sect2>

  <sect2 role="installation">
    <title>Installation of Noto Fonts</title>

    <note><para>Unlike most other packages there is no need to unpack the
    compressed Noto-hinted.zip package before installation.</para></note>

    <para>
      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/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>
      This package does not come with a test suite.
    </para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          None
        </seg>
        <seg>
          None
        </seg>
        <seg>
          /usr/share/fonts/noto
        </seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

</sect1>