source: pst/typesetting/texlive.xml@ 45d9840

10.0 10.1 11.0 7.10 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 45d9840 was 45d9840, checked in by Ken Moffat <ken@…>, 8 years ago

The main part of the changes for using system libraries on Tex Live.

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

  • Property mode set to 100644
File size: 12.9 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-year "2013">
8 <!ENTITY texlive-installer "http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz">
9
10 <!ENTITY texlive-source-download-http " ">
11 <!ENTITY texlive-source-download-ftp "ftp://tug.org/texlive/historic/&texlive-year;/texlive-&texlive-version;-source.tar.xz">
12 <!ENTITY texlive-source-md5sum "f52599c99fb1035399b907f4c54f1125">
13 <!ENTITY texlive-source-size "172 MB">
14
15 <!ENTITY texlive-buildsize "1.6 GB">
16 <!ENTITY texlive-time "9.6 SBU">
17]>
18
19<sect1 id="texlive" xreflabel="texlive-&texlive-version;">
20 <?dbhtml filename="texlive.html"?>
21
22 <sect1info>
23 <othername>$LastChangedBy$</othername>
24 <date>$Date$</date>
25 </sect1info>
26
27 <title>texlive-&texlive-version;</title>
28
29 <indexterm zone="texlive">
30 <primary sortas="a-texlive">texlive</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to TeX Live</title>
35
36 <para>The <application>TeX Live</application> package is a comprehensive
37 TeX document production system. It includes TEX, LaTeX2e, ConTEXt,
38 Metafont, MetaPost, BibTeX and many other programs; an extensive collection
39 of macros, fonts and documentation; and support for typesetting in many
40 different scripts from around the world.</para>
41
42 &lfs74_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>Download (HTTP): <ulink url="&texlive-source-download-http;"/></para>
48 </listitem>
49 <listitem>
50 <para>Download (FTP): <ulink url="&texlive-source-download-ftp;"/></para>
51 </listitem>
52 <listitem>
53 <para>Download MD5 sum: &texlive-source-md5sum;</para>
54 </listitem>
55 <listitem>
56 <para>Download size: &texlive-source-size;</para>
57 </listitem>
58 <listitem>
59 <para>Estimated disk space required: &texlive-buildsize;</para>
60 </listitem>
61 <listitem>
62 <para>Estimated build time: &texlive-time;</para>
63 </listitem>
64 </itemizedlist>
65
66 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
67 <itemizedlist spacing="compact">
68 <listitem>
69 <para>The TeX Live installer: <ulink url="&texlive-installer;"/></para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">TeX Live Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Recommended (to build from source)</bridgehead>
76 <para role="recommended">
77 The source ships with its own versions of <emphasis>many</emphasis>
78 libraries, and will use them unless it is forced to use the system
79 versions.
80 <xref linkend="gs"/>,
81 <xref linkend="icu"/>,
82 <xref linkend="freetype2"/>,
83 <xref linkend="fontconfig"/>,
84 <xref linkend="graphite2"/>,
85 <xref linkend="harfbuzz"/> (linked to graphite2),
86 <xref linkend="libpng"/>,
87 <xref linkend="poppler"/>,
88 <xref linkend="x-window-system"/>
89 </para>
90
91
92 <bridgehead renderas="sect4">Optional (to build from source)</bridgehead>
93 <para role="optional">
94 The source ships with its own versions of these libraries, which are either
95 not under active development, or only used for limited functionality. If
96 you install these, as with some other optional dependencies in this book you
97 will need to tell <command>configure</command> to use the system versions.
98 <ulink url="http://libgd.bitbucket.org">GD</ulink>,
99 <ulink url="http://fossies.org/linux/misc/t1lib-5.1.2.tar.gz/">t1lib</ulink>,
100 <ulink url="http://sourceforge.net/projects/zziplib/">ZZIPlib</ulink>,
101 <ulink url="http://www.gnu.org/software/clisp/">CLISP</ulink>,
102 <ulink url="http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&amp;id=TECkitDownloads">TECkit</ulink>
103 </para>
104
105 <bridgehead renderas="sect4">Runtime dependencies if building from source</bridgehead>
106 <para role="recommended">
107 not yet adequate to rebuild this),
108 <xref linkend="tk"/> for ep2pdftk.
109 </para>
110
111 <para condition="html" role="usernotes">User Notes:
112 <ulink url="&blfs-wiki;/texlive"/></para>
113
114 </sect2>
115
116 <sect2 role="installation">
117 <title>Installation of TeX Live</title>
118
119 <para>The <application>TeX Live</application> set of programs with its
120 supporting documents, fonts, and utilities is very large. The upstream
121 maintainers recommend placing all files in a single directory structure.
122 BLFS recommends <filename class='directory'>/opt/texlive</filename>.</para>
123
124 <para>First, unpack the installer and change into the installer's
125 directory, <filename class='directory'>install-tl-&lt;CCYYMMDD&gt;</filename>.
126 This directory name changes frequently when the installer is updated,
127 so replace &lt;CCYYMMDD&gt; by the correct directory name.</para>
128
129<screen><userinput>tar -xf install-tl-unx.tar.gz &amp;&amp;
130cd install-tl-&lt;CCYYMMDD&gt; </userinput></screen>
131
132 <note><para>The distribution binaries installed below use static linking
133 for internal <application>TeX Live</application> libraries. Additional
134 libraries as specified in the dependencies section do not need to be
135 present during the install, but the programs that need them will not run
136 until their specific dependencies are installed.</para></note>
137
138 <para>Now, as the <systemitem class="username">root</systemitem>
139 user:</para>
140
141<screen><userinput role="root">TEXLIVE_INSTALL_PREFIX=/opt/texlive ./install-tl</userinput></screen>
142
143 <para>This command is interactive and allows selection or modification of
144 platform, packages, directories, and other options. The full installation
145 scheme will require about 3.5 gigabytes of disk space. The time to complete
146 the download will depend on your internet connection speed and the
147 number of packages selected.</para>
148
149 <para>After the package download is complete, the next step is to make sure
150 that the system can properly find the files. If you set up your login
151 scripts as recommended in <xref linkend='postlfs-config-profile'/>, update
152 the needed paths by appending to the <filename>extrapaths.sh</filename> script.
153 The programs are always installed in an &lt;ARCH&gt;-linux subdirectory. If
154 you are not using x86_64, <emphasis>always</emphasis> change that to your
155 actual installation location.</para>
156
157<screen><userinput role="root">cat &gt;&gt; /etc/profile.d/extrapaths.sh &lt;&lt; "EOF"
158pathappend /usr/share/man MANPATH
159pathappend /opt/texlive/&texlive-year;/texmf-dist/doc/man MANPATH
160pathappend /usr/share/info INFOPATH
161pathappend /opt/texlive/&texlive-year;/texmf-dist/doc/info INFOPATH
162pathappend /opt/texlive/&texlive-year;/bin/x86_64-linux
163EOF</userinput></screen>
164
165 <note><para>The standard MANPATH and INFOPATH path are specified above to
166 ensure they are included. If they are already set in the boot script
167 procedure, the pathappend function will ensure duplicates are
168 removed, so including them here will do no harm.</para></note>
169
170 <para>The new paths can be immediately activated by running <command>source
171 /etc/profile</command>.</para>
172
173 <para>At this point the binary installation is complete.</para>
174
175 <para>Please note that installing from source will recompile the binary
176 programs and recreate the <literal>man</literal> and <literal>info</literal>
177 files. It will also overwrite the scripts - some of these may be older
178 versions than those from the newer installer. It will <emphasis>not</emphasis>
179 recreate any of the following: the more than 200 symlinks in the
180 &lt;ARCH&gt;-linux directory (some are alternate names, many are pointers to
181 the scripts), html files, PDF files, licenses, README files, two config
182 files (<filename>texmf.cnf</filename> and <filename>texmfcnf.lua</filename>),
183 nor the many package and font files in
184 <filename class="directory">texmf-dist</filename> and
185 <filename class="directory">texmf-var</filename>, nor the files recording
186 the actions of the installer, and the <filename>ls-R</filename> files listing
187 what was originally installed.</para>
188
189 <para>At the moment, these instructions do not rebuild
190 <application>asy</application> and <application>xindy</application> which were
191 installed by the binary installer.</para> <!-- FIXME -->
192
193 <para> If building from
194 source is desired, continue as a normal user. Extract the source package as
195 usual. Again, change x86_64-linux to whatever matches your architecture.
196 The developers do not recommend building in the source directory, so enter
197 the following commands:</para>
198
199<screen><userinput>mkdir texlive-build &amp;&amp;
200cd texlive-build &amp;&amp;
201
202../configure --prefix=/opt/texlive/2013 \
203 --bindir=/opt/texlive/2013/bin/x86_64-linux \
204 --datarootdir=/opt/texlive/2013 \
205 --includedir=/usr/include \
206 --infodir=/opt/texlive/2013/texmf-dist/doc/info \
207 --libdir=/usr/lib \
208 --mandir=/opt/texlive/2013/texmf-dist/doc/man \
209 --disable-native-texlive-build \
210 --disable-static --enable-shared \
211 --with-system-libgs \
212 --with-system-poppler \
213 --with-system-freetype2 \
214 --with-system-fontconfig \
215 --with-system-libpng \
216 --with-system-icu \
217 --with-system-graphite2 \
218 --with-system-harfbuzz \
219 --with-system-xpdf \
220 --with-system-poppler \
221 --with-system-cairo \
222 --with-system-pixman \
223 --with-system-zlib \
224 --with-banner-add=" - BLFS" &amp;&amp;
225make</userinput></screen>
226
227 <para>To test the results, issue: <command>make -k check</command>.</para>
228
229 <para>Now, as the <systemitem class="username">root</systemitem>
230 user:</para>
231
232<screen><userinput role="root">make install</userinput></screen>
233
234 </sect2>
235
236 <sect2 role="commands">
237 <title>Command Explanations</title>
238
239 <para>
240 <parameter>--prefix=, --bindir=, --datarootdir=, --infodir=, --mandir= ...
241 </parameter>: these switches ensure that the files installed from source
242 will overwrite the corresponding files previously installed by
243 <application>install-tl</application>.
244 </para>
245
246 <para>
247 <parameter>--includedir=, --libdir= ...</parameter> : these switches ensure
248 that the libraries will be found at runtime, and that programs can be
249 compiled against them.
250 </para>
251
252 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
253 href="../../xincludes/static-libraries.xml"/>
254
255 <para>
256 <parameter>--enable-shared</parameter>: Use shared versions of
257 <filename class="libraryfile">libkpathsea</filename> and
258 <filename class="libraryfile">libptexenc</filename>.
259 </para>
260
261 <para>
262 <parameter>--with-system-...</parameter>: Unless this parameter is used,
263 the included versions of these libraries will be statically compiled
264 into the programs which need them. If you decided not to install a
265 recommended library, omit the corresponding switches.
266 </para>
267
268 <para>
269 <parameter>--with-system-xpdf</parameter>: Uniquely, this parameter has
270 a non-standard meaning, it tells <command>configure</command> to use the
271 system-installed <application>poppler</application> headers and library.
272 Again, omit this if you have not installed
273 <application>poppler</application>.
274 </para>
275
276 <para>
277 <option>--without-x</option>: use this if you do not have Xorg installed.
278 </para>
279
280 </sect2>
281
282 <sect2 role="content">
283 <title>Contents</title>
284
285 <segmentedlist>
286 <segtitle>Installed Programs</segtitle>
287 <segtitle>Installed Libraries</segtitle>
288 <segtitle>Installed Directories</segtitle>
289
290 <seglistitem>
291 <seg>Over 300 binaries and symlinks to scripts</seg>
292 <seg>None</seg>
293 <seg>/opt/texlive</seg>
294 </seglistitem>
295 </segmentedlist>
296
297 <variablelist>
298 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
299 <?dbfo list-presentation="list"?>
300 <?dbhtml list-presentation="table"?>
301
302 <varlistentry id="texlive-programs">
303 <term><command>TeX&nbsp;programs</command></term>
304 <listitem>
305 <para>included in the <application>TeX Live</application> package are
306 too numerous to individually list. Please refer to the individual
307 program man and html pages in the installation directory's 2011/index.html
308 directory.</para>
309 <indexterm zone="texlive texlive-programs">
310 <primary sortas="b-texlive-programs">TeX Live programs</primary>
311 </indexterm>
312 </listitem>
313 </varlistentry>
314 </variablelist>
315
316 </sect2>
317
318</sect1>
Note: See TracBrowser for help on using the repository browser.