source: pst/typesetting/texlive.xml@ fb7ec07

elogind
Last change on this file since fb7ec07 was fb7ec07, checked in by DJ Lucas <dj@…>, 5 years ago

Merge to HEAD 21661.

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

  • Property mode set to 100644
File size: 18.3 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 <!ENTITY texlive-download-http " ">
8 <!ENTITY texlive-download-ftp "ftp://tug.org/texlive/historic/&texlive-year;/texlive-&texlive-version;-source.tar.xz">
9 <!ENTITY texlive-md5sum "be4b20aa60861bc510bcbc5b228bcb51">
10 <!ENTITY texlive-size "52 MB">
11
12 <!ENTITY texlive-buildsize "7.2 GB including the additional download and the tests, 6.0 GB installed">
13 <!ENTITY texlive-time "5.6 SBU including the additional download and the tests, building with parallelism=4">
14
15 <!ENTITY texlive-texmf-download-http " ">
16 <!ENTITY texlive-texmf-download-ftp "ftp://tug.org/texlive/historic/&texlive-year;/texlive-&texmf-version;-texmf.tar.xz">
17 <!ENTITY texlive-texmf-md5sum "586bb6cb6c30ce7efba256b956df6bc2">
18 <!ENTITY texlive-texmf-size "2.5 GB">
19
20]>
21
22
23<sect1 id="texlive" xreflabel="texlive-&texlive-version;">
24 <?dbhtml filename="texlive.html"?>
25
26 <sect1info>
27 <othername>$LastChangedBy$</othername>
28 <date>$Date$</date>
29 </sect1info>
30
31 <title>texlive-&texlive-version;-source</title>
32
33 <indexterm zone="texlive">
34 <primary sortas="a-texlive">texlive</primary>
35 </indexterm>
36
37 <sect2 role="package">
38 <title>Introduction to TeX Live from source</title>
39
40 <para>Most of TeX Live can be built from source without a pre-existing
41 installation, but <application>xindy</application> (for indexing) needs
42 working versions of <command>latex</command> and <command>pdflatex</command>
43 when configure is run, and the testsuite and install for
44 <command>asy</command> (for vector graphics) will fail if TeX has not
45 already been installed. Additionally, <application>biber</application> is
46 not provided within the <application>texlive</application> source.</para>
47
48 <para>All of those packages are dealt with on their own pages and can be
49 built after installing this package. If you have not already done so, you
50 should start at <xref linkend="tex-path"/> so that the final commands to
51 initialise the new installation will be found.</para>
52
53 &lfs84_checked;
54
55 <bridgehead renderas="sect3">Package Information</bridgehead>
56 <itemizedlist spacing="compact">
57 <listitem>
58 <para>Download (HTTP): <ulink url="&texlive-download-http;"/></para>
59 </listitem>
60 <listitem>
61 <para>Download (FTP): <ulink url="&texlive-download-ftp;"/></para>
62 </listitem>
63 <listitem>
64 <para>Download MD5 sum: &texlive-md5sum;</para>
65 </listitem>
66 <listitem>
67 <para>Download size: &texlive-size;</para>
68 </listitem>
69 <listitem>
70 <para>Estimated disk space required: &texlive-buildsize;</para>
71 </listitem>
72 <listitem>
73 <para>Estimated build time: &texlive-time;</para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Required Additional Downloads</bridgehead>
78
79 <para>Much of the texlive environment (including scripts, documentation,
80 fonts and various other files) is not part of the source tarball. You must
81 download it separately. This will give you all of the additional files
82 which are provided by a full install of the binary version, there is no
83 realistic way to restrict which parts get installed.</para>
84
85 <para>
86 Because of the size of this package, it is unlikely to be mirrored by
87 BLFS mirrors. In case of difficulty, go to http://www.ctan.org/mirrors/
88 to find a more-accessible mirror.
89 </para>
90
91 <itemizedlist spacing="compact">
92 <listitem>
93 <para>Download (HTTP): <ulink url="&texlive-texmf-download-http;"/></para>
94 </listitem>
95 <listitem>
96 <para>Download (FTP): <ulink url="&texlive-texmf-download-ftp;"/></para>
97 </listitem>
98 <listitem>
99 <para>Download MD5 sum: &texlive-texmf-md5sum;</para>
100 </listitem>
101 <listitem>
102 <para>Download size: &texlive-texmf-size;</para>
103 </listitem>
104 <listitem>
105 <para>Required patch: <ulink
106 url="&patch-root;/texlive-&texlive-version;-source-upstream_fixes-1.patch"/></para>
107 </listitem>
108 </itemizedlist>
109
110 <bridgehead renderas="sect3">TeX Live from source Dependencies</bridgehead>
111
112 <bridgehead renderas="sect4">Recommended</bridgehead>
113 <para role="recommended">
114 <xref linkend="gs"/> <emphasis>including
115 <filename>libgs.so</filename></emphasis>, <!--(for dvisvgm, which is used by e.g.
116 <xref role="nodep" linkend="asymptote"/>), : still referenced for dynamic loading,
117 even without dvisvgm - e.fg. by dvipsk -->
118 <xref linkend="x-window-system"/>
119 </para>
120
121 <!-- text for recommended libraries -->
122 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
123 href="../../xincludes/texrecommendlibs.xml"/>
124
125<!-- the following ensures jhalfs will set paths before running texlive -->
126
127 <para role="recommended">
128 Furthermore, the instructions below assume you are using the layout
129 described in <xref linkend="tex-path"/>.
130 </para>
131
132 <bridgehead renderas="sect4">Optional</bridgehead>
133 <!-- text for optional deps -->
134 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
135 href="../../xincludes/texoptional.xml"/>
136
137 <bridgehead renderas="sect4">Runtime dependencies</bridgehead>
138 <!-- text for runtime deps, shared with tl-installer -->
139 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
140 href="../../xincludes/texruntime.xml"/>
141
142 <para condition="html" role="usernotes">User Notes:
143 <ulink url="&blfs-wiki;/texlive"/></para>
144
145 </sect2>
146
147 <sect2 role="installation">
148 <title>Installation of TeX Live</title>
149
150 <para>
151 Install TeX Live by running the following commands:
152 </para>
153
154 <para>The shared libraries will be installed into a texlive directory.
155 As the <systemitem class="username">root</systemitem> user, add it to
156 your <filename>/etc/ld.so.conf</filename>:</para>
157
158<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; EOF
159<literal># Begin texlive &texlive-year; addition
160
161/opt/texlive/&texlive-year;/lib
162
163# End texlive &texlive-year; addition</literal>
164EOF</userinput></screen>
165
166 <note>
167 <para>
168 From 2015 onwards, a successful install requires some texlive
169 commands to be run as the root user, so we will export the TEXARCH
170 variable to let <systemitem class="username">root</systemitem> use it.
171 </para>
172
173<!--
174 <para>
175 If you came here to update an old system (because of the recent
176 vulnerability) where the poppler version is before 0.62.0, such as
177 BLFS-8.1, do NOT use the commands in the <literal>MYPOPPLER</literal>
178 block of instructions, nor the <literal>\-\-with-system-poppler</literal>
179 or <literal>\-\-with-system-xpdf</literal> options when configuring.
180 </para>-->
181
182 <para>
183 In the 2019 release, <application>dvisvgm</application> cannot be built
184 if shared system libraries are used. This means that <xref linkend="asymptote"/>
185 will not be able to create svg files.
186 </para>
187 </note>
188
189 <para>
190 Now, as a normal user:
191 </para>
192<screen><userinput>export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') &amp;&amp;
193
194patch -Np1 -i ../texlive-&texlive-version;-source-upstream_fixes-1.patch &amp;&amp;
195<!--
196let MYPOPPLER=$(pkg-config \-\-modversion poppler | cut -d '.' -f2)
197mv -v texk/web2c/pdftexdir/pdftosrc{-newpoppler,}.cc
198if [ $MYPOPPLER -lt 68 ]; then
199 mv -v texk/web2c/pdftexdir/pdftoepdf{-newpoppler,}.cc
200elif [ $MYPOPPLER -lt 69 ]; then
201 mv -v texk/web2c/pdftexdir/pdftoepdf{-poppler0.68.0,}.cc
202else
203 mv -v texk/web2c/pdftexdir/pdftoepdf{-poppler0.69.0,}.cc
204fi &amp;&amp;
205unset MYPOPPLER &amp;&amp;-->
206mkdir texlive-build &amp;&amp;
207cd texlive-build &amp;&amp;
208<!--
209 \-\-with-system-poppler \
210 \-\-with-system-xpdf \
211 potrace was only used by dvisvgm
212 \-\-with-system-potrace \
213 -->
214../configure \
215 --prefix=/opt/texlive/&texlive-year; \
216 --bindir=/opt/texlive/&texlive-year;/bin/$TEXARCH \
217 --datarootdir=/opt/texlive/&texlive-year; \
218 --includedir=/opt/texlive/&texlive-year;/include \
219 --infodir=/opt/texlive/&texlive-year;/texmf-dist/doc/info \
220 --libdir=/opt/texlive/&texlive-year;/lib \
221 --mandir=/opt/texlive/&texlive-year;/texmf-dist/doc/man \
222 --disable-native-texlive-build \
223 --disable-static --enable-shared \
224 --disable-dvisvgm \
225 --with-system-cairo \
226 --with-system-fontconfig \
227 --with-system-freetype2 \
228 --with-system-gmp \
229 --with-system-graphite2 \
230 --with-system-harfbuzz \
231 --with-system-icu \
232 --with-system-libgs \
233 --with-system-libpaper \
234 --with-system-libpng \
235 --with-system-mpfr \
236 --with-system-pixman \
237 --with-system-zlib \
238 --with-banner-add=" - BLFS" &amp;&amp;
239
240make</userinput></screen>
241
242 <para>To test the results, issue: <command>make check</command>
243 A few tests may SKIP because kpathsea
244 has not yet been installed.</para>
245
246 <para>Now, as the <systemitem class="username">root</systemitem>
247 user:</para>
248
249<!-- Editors, you can run 'make texlinks' in a DESTDIR by passing
250DESTDIR#some/where -->
251<screen role="root"><userinput>make install-strip &amp;&amp;
252/sbin/ldconfig &amp;&amp;
253make texlinks &amp;&amp;
254mkdir -pv /opt/texlive/&texlive-year;/tlpkg/TeXLive/ &amp;&amp;
255install -v -m644 ../texk/tests/TeXLive/* /opt/texlive/&texlive-year;/tlpkg/TeXLive/</userinput></screen>
256
257 <note>
258 <para>
259 Only run <command>make texlinks</command> once. If it is rerun,
260 it can change all the program symlinks so that they point to
261 themselves and are useless.
262 </para>
263 </note>
264
265 <para>Now install the additional files as the
266 <systemitem class="username">root</systemitem> user:</para>
267
268<!-- if texmf does not need to be patched, remove &amp;&amp; from first line,
269 close userinput, screen, comment pushd, patch, popd -->
270<screen role="root"><userinput>tar -xf ../../texlive-&texmf-version;-texmf.tar.xz -C /opt/texlive/&texlive-year; --strip-components=1</userinput></screen>
271
272 <para>Still as the <systemitem class="username">root</systemitem> user,
273 initialise the new system (the commands <command>fmtutil-sys --all</command>
274 and <command>mtxrun --generate</command> will produce a
275 <emphasis>lot</emphasis> of output):</para>
276
277<!-- Editors, fmtutil-sys and mtxrun \-\-generate can apparently only be run on
278a real install, as root. But mktexlsr can be run in a DESTDIR with
279cd /YOUR/TEXMF/ROOT ; ls -LAR ./ >ls-R -->
280
281<screen role="root"><userinput>mktexlsr &amp;&amp;
282fmtutil-sys --all &amp;&amp;
283mtxrun --generate</userinput></screen>
284
285 <para>You can now proceed to <xref linkend="asymptote"/>,
286 <xref linkend="biber"/> and / or <xref linkend="xindy"/> if you
287 wish to install them.</para>
288
289 </sect2>
290
291 <sect2 role="commands">
292 <title>Command Explanations</title>
293
294 <para>
295 <command>patch -Np1 -i ../texlive-&texlive-version;-source-upstream_fixes-1.patch</command>:
296 various problems have come to light since the shipped source was frozen to
297 be committed to DVDs.
298 </para>
299
300<!--
301 <para>
302 <command>let MYPOPPLER=...</command>: Because the vulnerability fix applies to
303 many past years of <application>texlive</application>, the tests aim to allow
304 updating using system versions of poppler since 0.62.0. The amended files for
305 newer versions of poppler need to be copied over the original versions,
306 depending on which version is being used.
307 </para>-->
308
309 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
310 href="../../xincludes/tex-prefix.xml"/>
311
312 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
313 href="../../xincludes/tex-lib.xml"/>
314
315 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
316 href="../../xincludes/static-libraries.xml"/>
317
318 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
319 href="../../xincludes/tex-shared.xml"/>
320
321 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
322 href="../../xincludes/tex-system.xml"/>
323<!--
324 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
325 href="../../xincludes/tex-xpdf.xml"/>-->
326
327 <para>
328 <command>--disable-dvisvgm</command>: As noted above, the shipped version
329 of dvisvgm, which has modified configuration files, cannot be built with
330 shared system libraries.
331 </para>
332
333 <para>
334 <option>--without-x</option>: use this if you do not have Xorg installed.
335 </para>
336
337 <para>
338 <command>/sbin/ldconfig</command>: this has to be run here so that <command>make
339 texlinks</command> can use kpsewhich.
340 </para>
341
342 <para>
343 <command>make texlinks</command> : this runs the texlinks.sh script
344 to create symbolic links from formats to engines. In
345 practice, several of the targets such as <command>xetex</command> are now
346 separate binaries and for these it will report "file already exists".
347 </para>
348
349 <para>
350 <command>tar -xf texlive-&texmf-version;-texmf.tar.xz -C /opt/texlive/&texlive-year; --strip-components=1</command>:
351 the tarball contains the files for the texmf-dist directory, and because
352 of its size we do not want to waste time and space untarring it and then
353 copying the files.
354 </para>
355
356 <para>
357 <command>install -v -m644 ../texk/tests/TeXLive/*
358 /opt/texlive/&texlive-year;/tlpkg/TeXLive/</command>: This puts the perl
359 modules <filename>TLConfig.pm</filename> and <filename>TLUtils.pm</filename>
360 into the directory where the binary installer puts them - it is at the
361 start of the perl @INC@ PATH within texlive when installed using the above
362 configure switches. Without these modules, texlive is unusable.
363 </para>
364
365 <para>
366 <command>mktexlsr</command>: Create an <filename>ls-R</filename> file
367 which lists what was installed - this is used by kpathsea to find files.
368 </para>
369
370 <para>
371 <command>fmtutil-sys --all</command>: This initialises the TeX formats,
372 Metafont bases and Metapost mems.
373 </para>
374
375 <para>
376 <command>mtxrun --generate</command>: This initialise the ConTeXt system.
377 </para>
378
379 </sect2>
380
381 <sect2 role="content">
382 <title>Contents</title>
383
384 <segmentedlist>
385 <segtitle>Installed Programs</segtitle>
386 <segtitle>Installed Libraries</segtitle>
387 <segtitle>Installed Directories</segtitle>
388
389 <seglistitem>
390 <seg>Over 300 binaries and symlinks to scripts</seg>
391 <seg>libkpathsea.so, libptexenc.so, libsynctex.so, libtexlua52.so,
392 libtexluajit.so</seg>
393 <seg>/opt/texlive/&texlive-year;/bin, /opt/texlive/&texlive-year;/include,
394 /opt/texlive/&texlive-year;/lib, /opt/texlive/&texlive-year;/texmf-dist</seg>
395 </seglistitem>
396 </segmentedlist>
397
398 <variablelist>
399 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
400 <?dbfo list-presentation="list"?>
401 <?dbhtml list-presentation="table"?>
402
403 <varlistentry id="texlive-programs">
404 <term><command>TeX&nbsp;programs</command></term>
405 <listitem>
406 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
407 href="../../xincludes/texprogs.xml"/>
408 <indexterm zone="texlive texlive-programs">
409 <primary sortas="b-texlive-programs">TeX Live programs</primary>
410 </indexterm>
411 </listitem>
412 </varlistentry>
413
414 <varlistentry id="libkpathsea">
415 <term><filename class="libraryfile">libkpathsea.so</filename></term>
416 <listitem>
417 <para>
418 (kpathsearch) exists to look up a file in a list of directories
419 and is used by <command>kpsewhich</command>.
420 </para>
421 <indexterm zone="texlive libkpathsea">
422 <primary sortas="c-libkpathsea">libkpathsea.so</primary>
423 </indexterm>
424 </listitem>
425 </varlistentry>
426
427 <varlistentry id="libptexenc">
428 <term><filename class="libraryfile">libptexenc.so</filename></term>
429 <listitem>
430 <para>
431 is a library for Japanese pTeX (publishing TeX).
432 </para>
433 <indexterm zone="texlive libptexenc">
434 <primary sortas="c-libptexenc">libptexenc.so</primary>
435 </indexterm>
436 </listitem>
437 </varlistentry>
438
439 <varlistentry id="libsynctex">
440 <term><filename class="libraryfile">libsynctex.so</filename></term>
441 <listitem>
442 <para>
443 is the SyncTeX (Synchronize TeXnology) parser library.
444 </para>
445 <indexterm zone="texlive libsynctex">
446 <primary sortas="c-libsynctex">libsynctex.so</primary>
447 </indexterm>
448 </listitem>
449 </varlistentry>
450
451 <varlistentry id="libtexlua52">
452 <term><filename class="libraryfile">libtexlua52.so</filename></term>
453 <listitem>
454 <para>
455 provides Lua 5.2, modified for use with LuaTeX.
456 </para>
457 <indexterm zone="texlive libtexlua52">
458 <primary sortas="c-libtexlua52">libtexlua52.so</primary>
459 </indexterm>
460 </listitem>
461 </varlistentry>
462
463 <varlistentry id="libtexluajit">
464 <term><filename class="libraryfile">libtexluajit.so</filename></term>
465 <listitem>
466 <para>
467 provides LuaJIT, modified for use with LuaJITTeX.
468 </para>
469 <indexterm zone="texlive libtexluajit">
470 <primary sortas="c-libtexluajit">libtexluajit.so</primary>
471 </indexterm>
472 </listitem>
473 </varlistentry>
474 </variablelist>
475
476 </sect2>
477
478</sect1>
Note: See TracBrowser for help on using the repository browser.