source: pst/typesetting/texlive.xml@ 5e61060

10.0 10.1 11.0 7.10 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 upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 5e61060 was 5e61060, checked in by Ken Moffat <ken@…>, 6 years ago

Update texlive to 2016, also update xindy to current source. Various cleanups, in particular the perl modules are now mode 644. Explanations brought into same order as the commands (I hope). Tag asymptote and biber. Any users of asymptote on gcc-6.1 systems should consult the wiki pages for install-tl-unx or asymptote (i.e. if from source) as appropriate. E&OE.

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

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