source: pst/typesetting/biber.xml@ f4d8a42

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f4d8a42 was f4d8a42, checked in by Ken Moffat <ken@…>, 5 years ago

Some tags I forgot to commit.

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

  • Property mode set to 100644
File size: 9.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!-- for 2.5 the directory is current instead of 2.5 -->
8 <!ENTITY biber-download-http "http://sourceforge.net/projects/biblatex-biber/files/biblatex-biber/current/biblatex-biber.tar.gz">
9 <!ENTITY biber-download-ftp " ">
10<!-- <!ENTITY biber-download-http "&sources-anduin-http;/biblatex-biber/biblatex-biber-&biber-version;.tar.gz">
11 <!ENTITY biber-download-ftp "&sources-anduin-ftp;/biblatex-biber/biblatex-biber-&biber-version;.tar.gz">-->
12 <!ENTITY biber-md5sum "md5sum 747c3c86eff58ccbc1b419357f665ebd">
13 <!ENTITY biber-size "816 KB">
14 <!-- buildsize includes the installed biblatex -->
15 <!ENTITY biber-buildsize "31 MB">
16 <!ENTITY biber-time "less than 0.1 SBU (0.83 SBU to run the tests)">
17
18 <!ENTITY biblatex-download-http "http://sourceforge.net/projects/biblatex/files/biblatex-&biblatex-version;/biblatex-&biblatex-version;.tds.tgz">
19 <!ENTITY biblatex-download-ftp "">
20 <!ENTITY biblatex-md5sum "322d8f7aec957b2af4e7d3462d0c4818">
21 <!ENTITY biblatex-size "19 MB">
22
23]>
24
25<sect1 id="biber" xreflabel="biber-&biber-version;">
26 <?dbhtml filename="biber.html"?>
27
28 <sect1info>
29 <othername>$LastChangedBy$</othername>
30 <date>$Date$</date>
31 </sect1info>
32
33 <title>biblatex-biber-&biber-version;</title>
34
35 <indexterm zone="biber">
36 <primary sortas="a-biber">Biber</primary>
37 </indexterm>
38
39 <sect2 role="package">
40 <title>Introduction to biber</title>
41
42 <para>Biber is a BibTeX replacement for users of biblatex, written in
43 <application>Perl</application>, with full Unicode support.</para>
44
45 &lfs7a_checked;
46
47 <bridgehead renderas="sect3">Package Information</bridgehead>
48 <itemizedlist spacing="compact">
49 <listitem>
50 <para>Download (HTTP): <ulink url="&biber-download-http;"/></para>
51 </listitem>
52 <listitem>
53 <para>Download (FTP): <ulink url="&biber-download-ftp;"/></para>
54 </listitem>
55 <listitem>
56 <para>Download MD5 sum: &biber-md5sum;</para>
57 </listitem>
58 <listitem>
59 <para>Download size: &biber-size;</para>
60 </listitem>
61 <listitem>
62 <para>Estimated disk space required: &biber-buildsize;</para>
63 </listitem>
64 <listitem>
65 <para>Estimated build time: &biber-time;</para>
66 </listitem>
67 </itemizedlist>
68
69 <bridgehead renderas="sect3">Required Additional Download</bridgehead>
70
71
72 <itemizedlist spacing="compact">
73 <listitem>
74 <para>The corresponding version of <application>biblatex</application> is
75 a separate project - the tds tarball is pre-packaged for untarring into
76 the <filename class="directory">texmf-dist</filename> directory.
77 Download (HTTP): <ulink url="&biblatex-download-http;"/></para>
78 </listitem>
79 <listitem>
80 <para>Download MD5 sum: &biblatex-md5sum;</para>
81 </listitem>
82 <listitem>
83 <para>Download size: &biblatex-size;</para>
84 </listitem>
85 </itemizedlist>
86
87 <bridgehead renderas="sect3">Biber Dependencies</bridgehead>
88
89 <bridgehead renderas="sect4">Required</bridgehead>
90 <para role="required">
91 <!-- KFM: because I always get confused by these deps, I've decided
92 to add some comments.
93 Both Config::AutoConf and ExtUtils::LibBuilder are listed as build
94 requirements in Build.PL, the rest are just requirements, but the
95 difference seems moot. Those two are needed to build Text::BibTeX
96 so not listed separately. -->
97 <xref linkend="perl-autovivification"/>
98 <xref linkend="perl-business-isbn"/>
99 <xref linkend="perl-business-ismn"/>
100 <xref linkend="perl-business-issn"/>
101 <xref linkend="perl-class-accessor"/>
102 <xref linkend="perl-data-compare"/>
103 <xref linkend="perl-data-dump"/>
104 <xref linkend="perl-data-uniqid"/>
105 <xref linkend="perl-date-simple"/>
106 <xref linkend="perl-encode-eucjpascii"/>
107 <xref linkend="perl-encode-hanextra"/>
108 <xref linkend="perl-encode-jis2k"/>
109 <xref linkend="perl-file-slurp"/>
110 <!-- IPC::Cmd is a part of core perl -->
111 <xref linkend="perl-ipc-run3"/>
112 <xref linkend="perl-lingua-translit"/>
113 <xref linkend="perl-list-allutils"/>
114 <!-- List::MoreUtils was pulled in for the testsuite of List::AllUtils,
115 but it needs to be present even if people do not run the tests -->
116 <xref linkend="perl-list-moreutils"/>
117 <xref linkend="perl-log-log4perl"/>
118 <!-- I initially misread LWP-Protocol-https as part of libwww-perl
119 when I was preparing this list. In fact, it depends on that -->
120 <xref linkend="perl-lwp-protocol-https"/>
121 <!-- LWP::Simple is part of libwww-perl,
122 that is pulled in by LWP::Protocol::https -->
123 <!-- Module::Build is pulled in by perl-text-bibtex, but mention it explicitly
124 so that the note on automatically installing missing dependencies can be run -->
125 <xref linkend="perl-module-build"/>
126 <!-- Mozilla::CA is a dependency of LWP-Protocol-https -->
127 <xref linkend="perl-regexp-common"/>
128 <xref linkend="perl-text-bibtex"/>
129 <xref linkend="perl-text-roman"/>
130 <!-- Collate.pm ships in perl, but is sometimes too old, and we like current
131 versions. Make the latest version required so that everyone is using the
132 same version. In fact, the version in perl-5.20.2 is indeed too old for
133 biber-2.0 -->
134 <xref linkend="perl-unicode-collate"/>
135 <!-- Unicode::GCstring is part of Unicode::LineBreak -->
136 <xref linkend="perl-unicode-linebreak"/>
137 <xref linkend="perl-unicode-normalize"/>
138 <xref linkend="perl-xml-libxml-simple"/>
139 <xref linkend="perl-xml-libxslt"/>
140 <xref linkend="perl-xml-writer"/> and
141 <!-- untarring biblatex requires that the texmf directories already exist -->
142 <xref linkend="texlive"/>
143 (or <xref linkend="tl-installer"/>)
144 </para>
145
146 <bridgehead renderas="sect4">Optional</bridgehead>
147 <para role="optional">
148 <xref linkend="perl-file-which"/> and
149 <xref linkend="perl-test-differences"/> to run the testsuite
150 </para>
151
152 <note>
153<!-- when a new release appears, use this para and link to sourceforge,
154 until we have a versioned copy at anduin. -->
155 <para>
156 Although the tarball name is unversioned, it will untar to a
157 correctly-versioned biblatex-biber-&biber-version; directory.
158 </para>
159
160 <para>
161 It is almost possible to install all missing dependencies automatically.
162 Except, from <application>perl-5.22.0</application> onwards,
163 <xref linkend="perl-module-build"/> is no longer part of
164 the core perl distribution. And for <xref linkend="perl-data-uniqid"/>
165 we have to patch it to skip over a test which always fails - that failing
166 test will probably break the automatic install. To automatically install
167 the remaining perl dependencies you will need to manually install those
168 two modules first.
169 You can then run <command>perl ./Build.PL</command> and when it
170 prompts you, become the root user and run
171 <command>./Build installdeps</command>
172 </para>
173 </note>
174
175 <para condition="html" role="usernotes">User Notes:
176 <ulink url='&blfs-wiki;/biber'/></para>
177
178 </sect2>
179
180 <sect2 role="installation">
181 <title>Installation of Biber</title>
182
183 <para>Install <application>Biber</application> by running the following
184 commands:</para>
185
186<screen><userinput>perl ./Build.PL &amp;&amp;
187./Build</userinput></screen>
188
189 <para>To test the results, enter: <command>./Build test</command> - you will
190 require the en_GB.UTF-8 and sv_SE.UTF-8 locales. Test 12 of t/sort-order.t
191 will fail : for
192 speed the tests use system locales instead of the default Unicode::Collation
193 algorithm, and some minor details of the locales in OSX (where development
194 takes place) differ from those in <application>glibc</application></para>
195
196 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
197
198<screen role="root"><userinput>tar -xf ../biblatex-&biblatex-version;.tds.tgz -C /opt/texlive/&texlive-year;/texmf-dist &amp;&amp;
199texhash &amp;&amp;
200./Build install</userinput></screen>
201
202 </sect2>
203
204 <sect2 role="commands">
205 <title>Command Explanations</title>
206
207 <para>
208 <command>tar -xf biblatex-&biblatex-version;.tds.tar.gz -C
209 /opt/texlive/&texlive-year;/texmf-dist</command>:
210 this installs the new <application>biblatex</application> files over those
211 installed by <application>texlive</application>.
212 </para>
213
214 <para>
215 <command>texhash</command> : this updates the file hash tables (otherwise
216 known as the file name database).
217 </para>
218
219 </sect2>
220
221 <sect2 role="content">
222 <title>Contents</title>
223
224 <segmentedlist>
225 <segtitle>Installed Programs</segtitle>
226 <segtitle>Installed Library</segtitle>
227 <segtitle>Installed Directory</segtitle>
228
229 <seglistitem>
230 <seg>biber</seg>
231 <seg>None</seg>
232 <seg>/usr/lib/perl5/site_perl/5.*{,/&lt;arch&gt;-linux/auto}/Biber</seg>
233 </seglistitem>
234 </segmentedlist>
235
236 <variablelist>
237 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
238 <?dbfo list-presentation="list"?>
239 <?dbhtml list-presentation="table"?>
240
241 <varlistentry id="biber-prog">
242 <term><command>biber</command></term>
243 <listitem>
244 <para>is used for producing bibliographies in LaTeX documents.</para>
245 <indexterm zone="biber biber-prog">
246 <primary sortas="b-biber">biber</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 </variablelist>
252
253 </sect2>
254
255</sect1>
Note: See TracBrowser for help on using the repository browser.