source: pst/typesetting/texlive.xml@ e0906079

10.0 10.1 11.0 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since e0906079 was e0906079, checked in by Ken Moffat <ken@…>, 6 years ago

texlive: Replace bogus TEXYEAR by correct entity and clarify the harfbuzz dependency.

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

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