source: pst/typesetting/texlive.xml@ d6c6562

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 d6c6562 was d6c6562, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Remove gcc7 entity

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