source: pst/typesetting/texlive.xml@ 2dc9d58

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

Correct texlive md5sum: I had pasted it from the previous line in my notes, which is for the binary.

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