source: pst/typesetting/texlive.xml@ 4107ac91

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 4107ac91 was 4107ac91, checked in by Ken Moffat <ken@…>, 7 years ago

More patches for texlive.

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