source: pst/typesetting/biber.xml@ f594857

<?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;

  <!-- please keep the alternative http, with one of them commented, so that
   a tarball can always be downloaded by a user even if anduin is not yet updated -->
  <!ENTITY biber-download-http   "&sources-anduin-http;/b/biblatex-biber-&biber-version;.tar.xz">
  <!-- please edit this one to point to wherever you uploaded \-\->
  <!ENTITY biber-download-http   "http://www.linuxfromscratch.org/~ken/tmp/biblatex-biber-&biber-version;.tar.xz"> -->
  <!ENTITY biber-download-ftp    "&sources-anduin-ftp;/b/biblatex-biber-&biber-version;.tar.xz">
  <!ENTITY biber-md5sum          "bf5191099887a652105ee9bf08bcf958">
  <!ENTITY biber-size            "1.4 MB">
  <!-- buildsize includes the installed biblatex -->
  <!ENTITY biber-buildsize       "40 MB">
  <!ENTITY biber-time            "less than 0.1 SBU (0.5 SBU to run the tests)">

  <!ENTITY biblatex-download-http   "http://sourceforge.net/projects/biblatex/files/biblatex-&biblatex-version;/biblatex-&biblatex-version;.tds.tgz">
  <!ENTITY biblatex-download-ftp    "">
  <!ENTITY biblatex-md5sum          "c6dad1c1f8a46785981610b5165d9fe5">
  <!ENTITY biblatex-size            "19 MB">

]>

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

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

  <title>biblatex-biber-&biber-version;</title>

  <indexterm zone="biber">
    <primary sortas="a-biber">Biber</primary>
  </indexterm>

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

    <para>Biber is a BibTeX replacement for users of biblatex, written in
    <application>Perl</application>. Upstream prefers to provide binaries
    and no longer offers a source tarball, so that has been taken from the
    git tree : see the file <filename>Fixes-from-git</filename> to see
    which changes (since 2.1 was tagged) have been included.</para>

    &gcc5_checked;

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

    <bridgehead renderas="sect3">Required Additional Download</bridgehead>

      <para>The corresponding version of <application>biblatex</application> is
      a separate project - the tds version is pre-packaged for untarring into
      the <filename class="directory">texmf-dist</filename> directory.</para>

    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&biblatex-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &biblatex-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &biblatex-size;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Biber Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="perl-autovivification"/>
      <xref linkend="perl-business-isbn"/>
      <xref linkend="perl-business-ismn"/>
      <xref linkend="perl-business-issn"/>
      <xref linkend="perl-data-compare"/>
      <xref linkend="perl-data-dump"/>
      <xref linkend="perl-date-simple"/>
      <xref linkend="perl-encode-eucjpascii"/>
      <xref linkend="perl-encode-hanextra"/>
      <xref linkend="perl-encode-jis2k"/>
      <xref linkend="perl-file-slurp"/>
      <xref linkend="perl-ipc-run3"/>
      <xref linkend="perl-log-log4perl"/>
      <xref linkend="perl-lwp"/>
      <xref linkend="perl-list-allutils"/>
      <xref linkend="perl-regexp-common"/>
      <xref linkend="perl-text-bibtex"/>
      <xref linkend="perl-text-roman"/>
      <!-- Collate.pm ships in perl, but is sometimes too old, and we like current
      versions.  Make the latest version required so that everyone is using the
      same version.  In fact, the version in perl-5.20.2 is indeed too old for
      biber-2.0 -->
      <xref linkend="perl-unicode-collate"/>
      <xref linkend="perl-unicode-linebreak"/>
      <xref linkend="perl-xml-libxml-simple"/>
      <xref linkend="perl-xml-libxslt"/>
      <xref linkend="perl-xml-writer"/> and
      <!-- untarring biblatex requires that the texmf directories already exist -->
      <xref linkend="texlive"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="required">
      <xref linkend="perl-file-which"/>,
      <xref linkend="perl-test-differences"/>,
      <xref linkend="perl-test-pod"/> and
      <xref linkend="perl-test-pod-coverage"/> (all needed to run the testsuite)
    </para>

    <note>
      <para>
        It is possible to install (all) missing dependencies automatically.
        Begin by running <command>perl ./Build.PL</command> and then when it
        prompts you, become the root user and run
        <command>./Build installdeps</command>
      </para>
    </note>

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

  </sect2>

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

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

<screen><userinput>perl ./Build.PL &amp;&amp;
./Build</userinput></screen>

    <para>To test the results, enter: <command>./Build test</command></para>

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

<screen role="root"><userinput>tar -xf ../biblatex-&biblatex-version;.tds.tgz -C /opt/texlive/&texlive-year;/texmf-dist &amp;&amp;
texhash &amp;&amp;
./Build install</userinput></screen>

  </sect2>

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

    <para>
      <parameter>tar -xf biblatex-&biblatex-version;a.tds.tar.gz -C
      /opt/texlive/&texlive-year;/texmf-dist</parameter>:
      this installs the new <application>biblatex</application> files over those
      installed by <application>texlive</application>.
    </para>

    <para>
      <parameter>texhash</parameter> : this updates the file hash tables (otherwise
      known as the file name database).
    </para>

  </sect2>

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

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Library</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>biber</seg>
        <seg>None</seg>
        <seg>/usr/lib/site_perl/5.*/Biber</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="biber-prog">
        <term><command>biber</command></term>
        <listitem>
          <para>is used for producing bibliographies in LaTeX documents.</para>
          <indexterm zone="biber biber-prog">
            <primary sortas="b-biber">biber</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>