source: general/graphlib/woff2.xml@ a1a89ee

<?xml version="1.0" encoding="UTF-8"?>
<!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 woff2-download-http "https://github.com/google/woff2/archive/v&woff2-version;/woff2-&woff2-version;.tar.gz">
  <!ENTITY woff2-download-ftp  " ">
  <!ENTITY woff2-md5sum        "793c8844845351cb80730a74937e411b">
  <!ENTITY woff2-size          "39 KB">
  <!ENTITY woff2-buildsize     "1.6 MB">
  <!ENTITY woff2-time          "less than 0.1 SBU">
]>

<sect1 id="woff2" xreflabel="WOFF2-&woff2-version;">
  <?dbhtml filename="woff2.html"?>


  <title>woff2-&woff2-version;</title>

  <indexterm zone="woff2">
    <primary sortas="a-woff2">woff2</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to WOFF2</title>

    <para>
      <application>WOFF2</application> is a library for converting fonts from
      the TTF format to the WOFF 2.0 format. It also allows decompression from
      WOFF 2.0 to TTF. The WOFF 2.0 format uses the Brotli compression algorithm
      to compress fonts suitable for downloading in CSS @font-face rules.
    </para>

    &lfs121_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&woff2-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&woff2-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &woff2-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &woff2-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &woff2-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &woff2-time;
        </para>
      </listitem>
    </itemizedlist>
<!--
    <note>
      <para>
        The <application>WOFF2</application> source tarball shown above
        downloads with the correct name, woff2-&woff2-version;.tar.gz,
        if using a browser such as Firefox. If you prefer to use a command line
        program such as wget, you normally would obtain
        v&woff2-version;.tar.gz. To obtain this package with the proper
        filename, run:

<screen><userinput>wget -c https://github.com/google/woff2/v&brotli-version;.tar.gz \
     -O woff2-&woff2-version;.tar.gz</userinput></screen>.
      </para>
    </note>
-->
    <bridgehead renderas="sect3">WOFF2 Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="brotli"/> and
      <xref linkend="cmake"/>
    </para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of WOFF2</title>

    <para>
      Install <application>WOFF2</application> by running the following
      commands:
    </para>

<screen><userinput>mkdir out                              &amp;&amp;
cd    out                              &amp;&amp;
cmake -DCMAKE_INSTALL_PREFIX=/usr   \
      -DCMAKE_BUILD_TYPE=Release    \
      -DCMAKE_SKIP_INSTALL_RPATH=ON .. &amp;&amp;
make</userinput></screen>

    <para>
      This package does not come with a test suite.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make install</userinput></screen>
  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/cmake-skip-install-rpath.xml"/>
  </sect2>

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

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>
          None
        </seg>
        <seg>
          libwoff2common.so, libwoff2dec.so and libwoff2enc.so
        </seg>
        <seg>
          /usr/include/woff2
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="libwoff2common">
        <term><filename class="libraryfile">libwoff2common.so</filename></term>
        <listitem>
          <para>
            provides shared data used by the libwoff2dec and libwoff2enc libraries
          </para>
          <indexterm zone="woff2 libwoff2common">
            <primary sortas="c-libwoff2common">libwoff2common.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libwoff2dec">
        <term><filename class="libraryfile">libwoff2dec.so</filename></term>
        <listitem>
          <para>
            is the WOFF2 decoder library
          </para>
          <indexterm zone="woff2 libwoff2dec">
            <primary sortas="c-libwoff2dec">libwoff2dec.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libwoff2enc">
        <term><filename class="libraryfile">libwoff2enc.so</filename></term>
        <listitem>
          <para>
            is the WOFF2 encoder library
          </para>
          <indexterm zone="woff2 libwoff2enc">
            <primary sortas="c-libwoff2common">libwoff2enc.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>
  </sect2>

</sect1>