source: pst/typesetting/texlive.xml@ 7ab0957e

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 7ab0957e was 7ab0957e, checked in by Ken Moffat <ken@…>, 7 years ago

Texlive - remove spurious '&&', attempt to clarify that dvisvgm needs the shared libgs.so

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

  • Property mode set to 100644
File size: 16.5 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 "1e75db3412b3e2945fa94b0a423a29c7">
10 <!ENTITY texlive-size "44 MB">
11
12 <!ENTITY texlive-buildsize "4.9 GB including the additional download">
13 <!ENTITY texlive-time "8.3 SBU including the additional download (+0.3 SBU for the tests)">
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 "65da9b4e2514379d128d4cf4e889b63b">
18 <!ENTITY texlive-texmf-size "2.0 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 &lfs80_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-2.patch"/></para>
107 </listitem>
108 <listitem>
109 <para>Required patch: <ulink
110 url="&patch-root;/texlive-&texlive-version;-texmf-upstream_fixes-1.patch"/></para>
111 </listitem>
112 </itemizedlist>
113
114 <bridgehead renderas="sect3">TeX Live from source Dependencies</bridgehead>
115
116 <bridgehead renderas="sect4">Recommended</bridgehead>
117 <para role="recommended">
118 <xref linkend="gs"/> <emphasis>including
119 <filename>libgs.so</filename></emphasis> (for dvisvgm, which is used by e.g.
120 <xref linkend="asymptote"/>),
121 <xref linkend="x-window-system"/>
122 </para>
123
124 <!-- text for recommended libraries -->
125 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
126 href="../../xincludes/texrecommendlibs.xml"/>
127
128 <bridgehead renderas="sect4">Optional</bridgehead>
129 <!-- text for optional deps -->
130 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
131 href="../../xincludes/texoptional.xml"/>
132
133 <bridgehead renderas="sect4">Runtime dependencies</bridgehead>
134 <!-- text for runtime deps, shared with tl-installer -->
135 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
136 href="../../xincludes/texruntime.xml"/>
137
138 <para condition="html" role="usernotes">User Notes:
139 <ulink url="&blfs-wiki;/texlive"/></para>
140
141 </sect2>
142
143 <sect2 role="installation">
144 <title>Installation of TeX Live</title>
145
146 <para>
147 Install TeX Live by running the following commands:
148 </para>
149
150 <para>The shared libraries will be installed into a texlive directory.
151 As the <systemitem class="username">root</systemitem> user, add it to
152 your <filename>/etc/ld.so.conf</filename>:</para>
153
154<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; EOF
155<literal># Begin texlive &texlive-year; addition
156
157/opt/texlive/&texlive-year;/lib
158
159# End texlive &texlive-year; addition</literal>
160EOF</userinput></screen>
161
162 <note>
163 <para>
164 From 2015 onwards, a successful install requires some texlive
165 commands to be run as the root user, so we will export the TEXARCH
166 variable to let <systemitem class="username">root</systemitem> use it.
167 </para>
168 </note>
169
170 <para>
171 Now, as a normal user:
172 </para>
173<screen><userinput>export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') &amp;&amp;
174
175patch -Np1 -i ../texlive-&texlive-version;-source-upstream_fixes-2.patch &amp;&amp;
176
177mkdir texlive-build &amp;&amp;
178cd texlive-build &amp;&amp;
179
180../configure \
181 --prefix=/opt/texlive/&texlive-year; \
182 --bindir=/opt/texlive/&texlive-year;/bin/$TEXARCH \
183 --datarootdir=/opt/texlive/&texlive-year; \
184 --includedir=/opt/texlive/&texlive-year;/include \
185 --infodir=/opt/texlive/&texlive-year;/texmf-dist/doc/info \
186 --libdir=/opt/texlive/&texlive-year;/lib \
187 --mandir=/opt/texlive/&texlive-year;/texmf-dist/doc/man \
188 --disable-native-texlive-build \
189 --disable-static --enable-shared \
190 --with-system-cairo \
191 --with-system-fontconfig \
192 --with-system-freetype2 \
193 --with-system-gmp \
194 --with-system-graphite2 \
195 --with-system-harfbuzz \
196 --with-system-icu \
197 --with-system-libgs \
198 --with-system-libpaper \
199 --with-system-libpng \
200 --with-system-mpfr \
201 --with-system-pixman \
202 --with-system-poppler \
203 --with-system-xpdf \
204 --with-system-zlib \
205 --with-banner-add=" - BLFS" &amp;&amp;
206
207make</userinput></screen>
208
209 <para>To test the results, issue: <command>make check</command>
210 A few tests may SKIP because kpathsea
211 has not yet been installed.</para>
212
213 <para>Now, as the <systemitem class="username">root</systemitem>
214 user:</para>
215
216<screen role="root"><userinput>make install-strip &amp;&amp;
217ldconfig &amp;&amp;
218make texlinks &amp;&amp;
219mkdir -pv /opt/texlive/&texlive-year;/tlpkg/TeXLive/ &amp;&amp;
220install -v -m644 ../texk/tests/TeXLive/* /opt/texlive/&texlive-year;/tlpkg/TeXLive/</userinput></screen>
221
222 <note>
223 <para>
224 Only run <command>make texlinks</command> once. If it is rerun,
225 it can change all the program symlinks so that they point to
226 themselves and are useless.
227 </para>
228 </note>
229
230 <para>Now install the additional files as the
231 <systemitem class="username">root</systemitem> user:</para>
232
233<screen role="root"><userinput>tar -xf ../../texlive-&texmf-version;-texmf.tar.xz -C /opt/texlive/&texlive-year; --strip-components=1 &amp;&amp;
234pushd /opt/texlive/&texlive-year; &amp;&amp;
235patch -Np1 -i /sources/texlive-&texlive-version;-texmf-upstream_fixes-1.patch &amp;&amp;
236popd
237</userinput></screen>
238
239 <para>Still as the <systemitem class="username">root</systemitem> user,
240 initialise the new system (the commands <command>fmtutil-sys --all</command>
241 and <command>mtxrun --generate</command> will produce a
242 <emphasis>lot</emphasis> of output):</para>
243
244<screen role="root"><userinput>mktexlsr &amp;&amp;
245fmtutil-sys --all &amp;&amp;
246mtxrun --generate</userinput></screen>
247
248 <!-- December 2016, by TL2017 the problem might be fixed -->
249 <para>Now, or if returning here because you were advised, fix a new vulnerability.
250 As the <systemitem class="username">root</systemitem> user:</para>
251
252<screen role="root"><userinput>sed -i '/^mpost,/d' /opt/texlive/&texlive-year;/texmf-dist/web2c/texmf.cnf &amp;&amp;
253fmtutil-sys --all</userinput></screen>
254
255 <para>You can now proceed to <xref linkend="asymptote"/>,
256 <xref linkend="biber"/> and / or <xref linkend="xindy"/> if you
257 wish to install them.</para>
258
259 </sect2>
260
261 <sect2 role="commands">
262 <title>Command Explanations</title>
263
264 <para>
265 <command>patch -Np1 -i ../texlive-&texlive-version;-source...</command>:
266 This fixes a segfault in upmendex which was corrected after the source was
267 released and is included in the binary installer.
268 </para>
269
270 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
271 href="../../xincludes/tex-prefix.xml"/>
272
273 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
274 href="../../xincludes/tex-lib.xml"/>
275
276 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
277 href="../../xincludes/static-libraries.xml"/>
278
279 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
280 href="../../xincludes/tex-shared.xml"/>
281
282 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
283 href="../../xincludes/tex-system.xml"/>
284
285 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
286 href="../../xincludes/tex-xpdf.xml"/>
287
288 <para>
289 <option>--without-x</option>: use this if you do not have Xorg installed.
290 </para>
291
292 <para>
293 <command>ldconfig</command>: this has to be run here so that <command>make
294 texlinks</command> can use kpsewhich.
295 </para>
296
297 <para>
298 <command>make texlinks</command> : this runs the texlinks.sh script
299 to create symbolic links from formats to engines. In
300 practice, several of the targets such as <command>xetex</command> are now
301 separate binaries and for these it will report "file already exists".
302 </para>
303
304 <para>
305 <command>tar -xf texlive-&texmf-version;-texmf.tar.xz -C /opt/texlive/&texlive-year; --strip-components=1</command>:
306 the tarball contains the files for the texmf-dist directory, and because
307 of its size we do not want to waste time and space untarring it and then
308 copying the files.
309 </para>
310
311 <para>
312 <command>patch -Np1 -i /sources/texlive-&texlive-version;-texmf...</command>:
313 This fixes various problems in epstopdf which were found after the source
314 was released and are included in the binary installer. Because this is
315 applied to the installated texmf (to minimise disk space) it is necessary
316 to point to /sources instead of using ../
317 </para>
318
319 <para>
320 <command>install -v -m644 ../texk/tests/TeXLive/*
321 /opt/texlive/&texlive-year;/tlpkg/TeXLive/</command>: This puts the perl
322 modules <filename>TLConfig.pm</filename> and <filename>TLUtils.pm</filename>
323 into the directory where the binary installer puts them - it is at the
324 start of the perl @INC@ PATH within texlive when installed using the above
325 configure switches. Without these modules, texlive is unusable.
326 </para>
327
328 <para>
329 <command>mktexlsr</command>: Create an <filename>ls-R</filename> file
330 which lists what was installed - this is used by kpathsea to find files.
331 </para>
332
333 <para>
334 <command>fmtutil-sys --all</command>: This initialises the TeX formats,
335 Metafont bases and Metapost mems.
336 </para>
337
338 <para>
339 <command>mtxrun --generate</command>: This initialise the ConTeXt system.
340 </para>
341
342 </sect2>
343
344 <sect2 role="content">
345 <title>Contents</title>
346
347 <segmentedlist>
348 <segtitle>Installed Programs</segtitle>
349 <segtitle>Installed Libraries</segtitle>
350 <segtitle>Installed Directories</segtitle>
351
352 <seglistitem>
353 <seg>Over 300 binaries and symlinks to scripts</seg>
354 <seg>libkpathsea.so, libptexenc.so, libsynctex.so, libtexlua52.so,
355 libtexluajit.so</seg>
356 <seg>/opt/texlive/&texlive-year;/bin, /opt/texlive/&texlive-year;/include,
357 /opt/texlive/&texlive-year;/lib, /opt/texlive/&texlive-year;/texmf-dist</seg>
358 </seglistitem>
359 </segmentedlist>
360
361 <variablelist>
362 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
363 <?dbfo list-presentation="list"?>
364 <?dbhtml list-presentation="table"?>
365
366 <varlistentry id="texlive-programs">
367 <term><command>TeX&nbsp;programs</command></term>
368 <listitem>
369 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
370 href="../../xincludes/texprogs.xml"/>
371 <indexterm zone="texlive texlive-programs">
372 <primary sortas="b-texlive-programs">TeX Live programs</primary>
373 </indexterm>
374 </listitem>
375 </varlistentry>
376
377 <varlistentry id="libkpathsea">
378 <term><filename class="libraryfile">libkpathsea.so</filename></term>
379 <listitem>
380 <para>
381 (kpathsearch) exists to look up a file in a list of directories
382 and is used by <command>kpsewhich</command>.
383 </para>
384 <indexterm zone="texlive libkpathsea">
385 <primary sortas="c-libkpathsea">libkpathsea.so</primary>
386 </indexterm>
387 </listitem>
388 </varlistentry>
389
390 <varlistentry id="libptexenc">
391 <term><filename class="libraryfile">libptexenc.so</filename></term>
392 <listitem>
393 <para>
394 is a library for Japanese pTeX (publishing TeX).
395 </para>
396 <indexterm zone="texlive libptexenc">
397 <primary sortas="c-libptexenc">libptexenc.so</primary>
398 </indexterm>
399 </listitem>
400 </varlistentry>
401
402 <varlistentry id="libsynctex">
403 <term><filename class="libraryfile">libsynctex.so</filename></term>
404 <listitem>
405 <para>
406 is the SyncTeX (Synchronize TeXnology) parser library.
407 </para>
408 <indexterm zone="texlive libsynctex">
409 <primary sortas="c-libsynctex">libsynctex.so</primary>
410 </indexterm>
411 </listitem>
412 </varlistentry>
413
414 <varlistentry id="libtexlua52">
415 <term><filename class="libraryfile">libtexlua52.so</filename></term>
416 <listitem>
417 <para>
418 provides Lua 5.2, modified for use with LuaTeX.
419 </para>
420 <indexterm zone="texlive libtexlua52">
421 <primary sortas="c-libtexlua52">libtexlua52.so</primary>
422 </indexterm>
423 </listitem>
424 </varlistentry>
425
426 <varlistentry id="libtexluajit">
427 <term><filename class="libraryfile">libtexluajit.so</filename></term>
428 <listitem>
429 <para>
430 provides LuaJIT, modified for use with LuaJITTeX.
431 </para>
432 <indexterm zone="texlive libtexluajit">
433 <primary sortas="c-libtexluajit">libtexluajit.so</primary>
434 </indexterm>
435 </listitem>
436 </varlistentry>
437 </variablelist>
438
439 </sect2>
440
441</sect1>
Note: See TracBrowser for help on using the repository browser.