source: pst/typesetting/biber.xml@ 4250ad5

10.0 10.1 11.0 11.1 11.2 9.1 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 4250ad5 was 4250ad5, checked in by Ken Moffat <ken@…>, 3 years ago

I forgot to link perl module Parse::Descent as a dep of biber.
Thanks to Doug for noticing this, another example of why I do not like to
mark my own homework. ;-)

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

  • Property mode set to 100644
File size: 11.1 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<!--
8 When a proper url is not evident, github will download with
9 https://github.com/ <path> /archive/<version>/<name>-<version>.tar.<compression>
10
11 <!ENTITY biber-download-http "https://github.com/plk/biber/archive/v&biber-version;.tar.gz">
12-->
13 <!ENTITY biber-download-http "https://github.com/plk/biber/archive/v&biber-version;/biber-&biber-version;.tar.gz">
14 <!ENTITY biber-download-ftp " ">
15 <!ENTITY biber-md5sum "726e7457f1b4d882e1d05fd185563cfd">
16 <!ENTITY biber-size "1.6 MB">
17 <!-- Buildsize includes the installed biblatex, except that what matters is
18 the difference from the files shipped by texlive, so usually the addition is
19 minimal. Copy full texmf to somewhere for working, measure with du -shm,
20 then install bibleatex over the top of it and remeasure. -->
21 <!ENTITY biber-buildsize "16 MB">
22 <!ENTITY biber-time "0.6 SBU including tests">
23
24 <!-- Check path. Directory might not be &biblatex-version; if a suffixed update -->
25 <!ENTITY biblatex-download-http "http://sourceforge.net/projects/biblatex/files/biblatex-&biblatex-version;/biblatex-&biblatex-version;.tds.tgz">
26 <!ENTITY biblatex-download-ftp "">
27 <!ENTITY biblatex-md5sum "fc3605bc86de283e6f962f20a80c5a04">
28 <!ENTITY biblatex-size "20 MB">
29
30]>
31
32<sect1 id="biber" xreflabel="biber-&biber-version;">
33 <?dbhtml filename="biber.html"?>
34
35 <sect1info>
36 <othername>$LastChangedBy$</othername>
37 <date>$Date$</date>
38 </sect1info>
39
40 <title>biber-&biber-version;</title>
41
42 <indexterm zone="biber">
43 <primary sortas="a-biber">Biber</primary>
44 </indexterm>
45
46 <sect2 role="package">
47 <title>Introduction to biber</title>
48
49 <para>Biber is a BibTeX replacement for users of biblatex, written in
50 <application>Perl</application>, with full Unicode support.</para>
51
52 &lfs91_checked;
53
54 <!-- note for editors: you can test this by using the latest version
55 of the latex-test tarball from
56 http://www.linuxfromscratch.org/~ken/tex-testfiles/
57 using ./configure (to create the Makefile) and then making the
58 following targets:
59 biblatex-unibiber and biblatex-biber (these just use pdflatex
60 and biber, biblatex-unibiber is more important, it uses UTF-8)
61 bibxelatex (uses xelatex and biber, needs TTF or OTF fonts and
62 in particular coverage of simplified Chinese and Japanese, and
63 optionally Korean - installed fonts for CJK can be specified to
64 configure if they are not found)
65 remote1 and remote2 (pdflatex and biber, for use with manually
66 installed perl modules, i.e. without Mozilla::CA, to prove that
67 remote references work).
68 In all cases the output PDF should include references at the
69 end, the Makefile does not check that for the remote tests. -->
70
71 <bridgehead renderas="sect3">Package Information</bridgehead>
72 <itemizedlist spacing="compact">
73 <listitem>
74 <para>Download (HTTP): <ulink url="&biber-download-http;"/></para>
75 </listitem>
76 <listitem>
77 <para>Download (FTP): <ulink url="&biber-download-ftp;"/></para>
78 </listitem>
79 <listitem>
80 <para>Download MD5 sum: &biber-md5sum;</para>
81 </listitem>
82 <listitem>
83 <para>Download size: &biber-size;</para>
84 </listitem>
85 <listitem>
86 <para>Estimated disk space required: &biber-buildsize;</para>
87 </listitem>
88 <listitem>
89 <para>Estimated build time: &biber-time;</para>
90 </listitem>
91 </itemizedlist>
92
93 <note>
94<!--
95 <para>
96 The <application>biber</application> source tarball shown above
97 downloads with the correct name, biber-&biber-version;.tar.gz,
98 if using a browser such as Firefox. If you prefer to use a command line
99 program such as wget, you normally would obtain
100 v&biber-version;.tar.gz. To obtain this package with the proper
101 filename, run:
102
103<screen><userinput>wget -c &biber-download-http; \
104 -O biber-&biber-version;.tar.gz</userinput></screen>.
105 </para>
106-->
107 <para>
108 If you have updated to a new release of texlive-source, biber and its
109 perl dependencies are still in present in <filename
110 class="directory">/usr</filename> and do not need to be rebuilt. However,
111 biblatex installs in <filename
112 class="directory">/opt/texlive/&texlive-year;</filename> and does need to
113 be reinstalled.
114 </para>
115
116 <para>
117 This version of biber requires <application>perl-5.30</application> or later.
118 If you are still using the 8.4 version of BLFS you may wish to build the
119 2.13 version: see the 8.4 book noting that biblatex-3.13 has been replaced by
120 biblatex-3.13a upstream.
121 </para>
122 </note>
123
124 <bridgehead renderas="sect3">Required Additional Downloads</bridgehead>
125
126 <itemizedlist spacing="compact">
127 <listitem>
128 <para>The corresponding version of <application>biblatex</application> is
129 a separate project - the tds tarball is pre-packaged for untarring into
130 the <filename class="directory">texmf-dist</filename> directory.
131 Download (HTTP): <ulink url="&biblatex-download-http;"/></para>
132 </listitem>
133 <listitem>
134 <para>Download MD5 sum: &biblatex-md5sum;</para>
135 </listitem>
136 <listitem>
137 <para>Download size: &biblatex-size;</para>
138 </listitem>
139 </itemizedlist>
140
141 <bridgehead renderas="sect3">Biber Dependencies</bridgehead>
142
143 <bridgehead renderas="sect4">Required</bridgehead>
144 <para role="required">
145 <!-- KFM: the order listed in Build.PL is not alphabetical -->
146 <xref linkend="perl-autovivification"/>
147 <xref linkend="perl-business-isbn"/>
148 <xref linkend="perl-business-ismn"/>
149 <xref linkend="perl-business-issn"/>
150 <xref linkend="perl-class-accessor"/>
151 <xref linkend="perl-data-compare"/>
152 <xref linkend="perl-data-dump"/>
153 <xref linkend="perl-data-uniqid"/>
154 <xref linkend="perl-datetime-calendar-julian"/>
155 <xref linkend="perl-datetime-format-builder"/>
156 <xref linkend="perl-encode-eucjpascii"/>
157 <xref linkend="perl-encode-hanextra"/>
158 <xref linkend="perl-encode-jis2k"/>
159 <xref linkend="perl-file-slurper"/>
160 <xref linkend="perl-io-string"/>
161 <!-- IPC::Cmd is a part of core perl -->
162 <xref linkend="perl-ipc-run3"/>
163 <xref linkend="perl-lingua-translit"/>
164 <xref linkend="perl-list-allutils"/>
165 <xref linkend="perl-list-moreutils"/>
166 <!-- perl-list-moreutils-xs is a dep of perl-list-moreutils -->
167 <xref linkend="perl-log-log4perl"/>
168 <xref linkend="perl-lwp-protocol-https"/>
169 <!-- LWP::Simple is part of perl-libwww-perl,
170 that is pulled in by perl-lwp-protocol-https
171 and that pulls in perl-uri -->
172 <xref linkend="perl-module-build"/>
173 <xref linkend="perl-parse-recdescent"/>
174 <xref linkend="perl-perlio-utf8_strict"/>
175 <!-- Mozilla::CA should not be needed when using system certificates -->
176 <xref linkend="perl-regexp-common"/>
177 <xref linkend="perl-sort-key"/>
178 <xref linkend="perl-text-bibtex"/>
179 <xref linkend="perl-text-csv"/>
180 <!-- perl-text-csv_xs is a recommended dependency for perl-text-csv -->
181 <xref linkend="perl-text-roman"/>
182 <!-- Unicode-Collate usually needs to be latest when biber is released,
183 core perl is usually older. To read the core version, look at
184 /usr/lib/perl5/5.xx.y/x86_64-linux-thread-multi/Unicode/Collate.pm -->
185 <xref linkend="perl-unicode-collate"/>
186 <!-- Unicode::GCstring is part of Unicode::LineBreak -->
187 <xref linkend="perl-unicode-linebreak"/>
188 <!-- Unicode::Normalize is part of core perl, found in
189 /usr/lib/perl5/5.xx.y/x86_64-linux-thread-multi/Unicode/Normalize.pm -->
190 <!-- perl-xml-libxml is a dependency of perl-xml-libxml-simple -->
191 <xref linkend="perl-xml-libxml-simple"/>
192 <xref linkend="perl-xml-libxslt"/>
193 <xref linkend="perl-xml-writer"/> and
194 <!-- untarring biblatex requires that the texmf directories already exist -->
195 <xref linkend="texlive"/>
196 (or <xref linkend="tl-installer"/>, but for that you can use
197 <command>tlmgr update </command>)
198 </para>
199
200 <bridgehead renderas="sect4">Recommended (required for the testsuite)</bridgehead>
201 <para role="recommended">
202 <xref linkend="perl-file-which"/> and
203 <xref linkend="perl-test-differences"/>
204 </para>
205
206 <note>
207 <para>
208 It is possible to install all missing dependencies automatically. You
209 must first install <xref linkend="perl-module-build"/> using <xref
210 linkend="perl-auto-install"/>. then run <command>perl ./Build.PL</command>
211 and when it prompts you, become the root user and run
212 <command>./Build installdeps</command>
213 </para>
214 </note>
215
216 <para condition="html" role="usernotes">User Notes:
217 <ulink url='&blfs-wiki;/biber'/></para>
218
219 </sect2>
220
221 <sect2 role="installation">
222 <title>Installation of Biber</title>
223
224 <para>Install <application>Biber</application> by running the following
225 commands:</para>
226
227<screen><userinput>perl ./Build.PL &amp;&amp;
228./Build</userinput></screen>
229
230 <para>To test the results, enter: <command>./Build test</command></para>
231
232 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
233
234<screen role="root"><userinput>tar -xf ../biblatex-&biblatex-version;.tds.tgz -C /opt/texlive/&texlive-year;/texmf-dist &amp;&amp;
235texhash &amp;&amp;
236./Build install</userinput></screen>
237
238 </sect2>
239
240 <sect2 role="commands">
241 <title>Command Explanations</title>
242
243 <para>
244 <command>tar -xf biblatex-&biblatex-version;.tds.tar.gz -C
245 /opt/texlive/&texlive-year;/texmf-dist</command>:
246 this installs the new <application>biblatex</application> files over those
247 installed by <application>texlive</application>.
248 </para>
249
250 <para>
251 <command>texhash</command> : this updates the file hash tables (otherwise
252 known as the file name database).
253 </para>
254
255 </sect2>
256
257 <sect2 role="content">
258 <title>Contents</title>
259
260 <segmentedlist>
261 <segtitle>Installed Programs</segtitle>
262 <segtitle>Installed Library</segtitle>
263 <segtitle>Installed Directory</segtitle>
264
265 <seglistitem>
266 <seg>biber</seg>
267 <seg>None</seg>
268 <seg>/usr/lib/perl5/site_perl/5.*{,/&lt;arch&gt;-linux/auto}/Biber</seg>
269 </seglistitem>
270 </segmentedlist>
271
272 <variablelist>
273 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
274 <?dbfo list-presentation="list"?>
275 <?dbhtml list-presentation="table"?>
276
277 <varlistentry id="biber-prog">
278 <term><command>biber</command></term>
279 <listitem>
280 <para>is used for producing bibliographies in LaTeX documents.</para>
281 <indexterm zone="biber biber-prog">
282 <primary sortas="b-biber">biber</primary>
283 </indexterm>
284 </listitem>
285 </varlistentry>
286
287 </variablelist>
288
289 </sect2>
290
291</sect1>
Note: See TracBrowser for help on using the repository browser.