source: pst/typesetting/texlive.xml@ f594857

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

Texlive-2015. Looking at what I've done in the past in texlive, I'm sure there are probably still errors - if anybody has the time, disk space, inclination, and perhaps their own tex file(s), to review the from source instructions I would appreciate it. My own (lastex, minimal context) test files are in my directory on higgs.

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

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