source: pst/typesetting/texlive-pass1.xml@ e30a6f2

10.0 10.1 11.0 7.10 7.7 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 krejzi/svn lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since e30a6f2 was e30a6f2, checked in by Ken Moffat <ken@…>, 7 years ago

texlive pass 1 : remove bogus title from the additional download, a legacy of copying from ghostscript.

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

  • Property mode set to 100644
File size: 12.5 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-pass1-download-http " ">
8 <!ENTITY texlive-pass1-download-ftp "ftp://tug.org/texlive/historic/&texlive-year;/texlive-&texlive-version;-source.tar.xz">
9 <!ENTITY texlive-pass1-md5sum "09ee265ff51637827559affc7304078c">
10 <!ENTITY texlive-pass1-size "40 MB">
11
12 <!-- when measured, 900MB for pass 1 itself, 3.6 GB for texmf -->
13 <!ENTITY texlive-pass1-buildsize "3.6 GB including the additional download">
14 <!ENTITY texlive-pass1-time "8.2 SBU including the additional download">
15
16 <!ENTITY texlive-texmf-download-http " ">
17 <!ENTITY texlive-texmf-download-ftp "ftp://tug.org/texlive/historic/&texlive-year;/texlive-&texlive-version;-texmf.tar.xz">
18 <!ENTITY texlive-texmf-md5sum "645a6f1d3a0ef4a9c279dae02588eab7">
19 <!ENTITY texlive-texmf-size "1.7 GB">
20
21]>
22
23
24<sect1 id="texpass1" xreflabel="texlive-&texlive-version;-source pass 1">
25 <?dbhtml filename="texlive-pass1.html"?>
26
27 <sect1info>
28 <othername>$LastChangedBy$</othername>
29 <date>$Date$</date>
30 </sect1info>
31
32 <title>texlive-&texlive-version;-source pass 1</title>
33
34 <indexterm zone="texpass1">
35 <primary sortas="a-texpass1">texlive-pass-1</primary>
36 </indexterm>
37
38 <sect2 role="package">
39 <title>Introduction to TeX Live from source, pass 1</title>
40
41 <para>Most of TeX Live can be built from source without difficulty.
42 However, <application>xindy</application> (for indexing) needs working
43 versions of <command>latex</command> and <command>pdflatex</command>
44 when configure is run, and the testsuite for <command>asy</command>
45 (for vector graphics) will fail if TeX has not already been installed.
46 </para>
47
48 <para>In addition, it is necessary to create various symlinks at the end of
49 this install.</para>
50
51 <para>We can later rebuild texlive in <xref linkend="texlive"/> to include
52 xindy. There we will install xindy and also build and install asy.</para>
53
54 &lfs76_checked;
55
56 <bridgehead renderas="sect3">Package Information</bridgehead>
57 <itemizedlist spacing="compact">
58 <listitem>
59 <para>Download (HTTP): <ulink url="&texlive-pass1-download-http;"/></para>
60 </listitem>
61 <listitem>
62 <para>Download (FTP): <ulink url="&texlive-pass1-download-ftp;"/></para>
63 </listitem>
64 <listitem>
65 <para>Download MD5 sum: &texlive-pass1-md5sum;</para>
66 </listitem>
67 <listitem>
68 <para>Download size: &texlive-pass1-size;</para>
69 </listitem>
70 <listitem>
71 <para>Estimated disk space required: &texlive-pass1-buildsize;</para>
72 </listitem>
73 <listitem>
74 <para>Estimated build time: &texlive-pass1-time;</para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Required Additional Download</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 (FTP): <ulink url="&texlive-texmf-download-ftp;"/></para>
95 </listitem>
96 <listitem>
97 <para>Download MD5 sum: &texlive-texmf-md5sum;</para>
98 </listitem>
99 <listitem>
100 <para>Download size: &texlive-texmf-size;</para>
101 </listitem>
102 </itemizedlist>
103
104 <bridgehead renderas="sect3">TeX Live from source pass 1 Dependencies</bridgehead>
105
106 <bridgehead renderas="sect4">Recommended</bridgehead>
107 <para role="recommended">
108 <xref linkend="x-window-system"/>
109 </para>
110 <para role="recommended">
111 The source ships with its own versions of <emphasis>many</emphasis>
112 libraries, and will use them unless it is forced to use the system
113 versions. The following are recommended so that the system version
114 will be used:
115 <xref linkend="fontconfig"/>,
116 <xref linkend="freetype2"/>,
117 <xref linkend="gc"/>,
118 <xref linkend="graphite2"/>,
119 <xref linkend="harfbuzz"/> (linked to graphite2),
120 <xref linkend="icu"/>,
121 <xref linkend="libpaper"/>,
122 <xref linkend="libpng"/>,
123 <xref linkend="poppler"/>
124 </para>
125
126 <bridgehead renderas="sect4">Optional</bridgehead>
127 <para role="optional">
128 The source ships with its own versions of several libraries which are either
129 not under active development, or only used for limited functionality. If
130 you install these, as with some other optional dependencies in this book you
131 will need to tell <command>configure</command> to use the system versions.
132 <ulink url="http://libgd.bitbucket.org">GD</ulink>,
133 <ulink url="http://fossies.org/linux/misc/t1lib-5.1.2.tar.gz/">t1lib</ulink>,
134 <ulink url="http://sourceforge.net/projects/zziplib/">ZZIPlib</ulink>,
135 <ulink url="http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&amp;id=TECkitDownloads">TECkit</ulink>
136 </para>
137
138 <bridgehead renderas="sect4">Runtime dependencies</bridgehead>
139 <para role="recommended">
140 Some scripts will use
141 <xref linkend="python2"/> or <xref linkend="ruby"/>.
142 </para>
143
144 <para condition="html" role="usernotes">User Notes:
145 <ulink url="&blfs-wiki;/texlive-pass1"/></para>
146
147 </sect2>
148
149 <sect2 role="installation">
150 <title>Installation of TeX Live, pass 1</title>
151
152 <para>
153 Install TeX Live pass 1 by running the following commands:
154 </para>
155
156<screen role="root"><userinput>export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') &amp;&amp;
157mkdir texlive-build &amp;&amp;
158cd texlive-build &amp;&amp;
159
160../configure \
161 --prefix=/opt/texlive/&texlive-year; \
162 --bindir=/opt/texlive/&texlive-year;/bin/$TEXARCH \
163 --datarootdir=/opt/texlive/&texlive-year; \
164 --includedir=/usr/include \
165 --infodir=/opt/texlive/&texlive-year;/texmf-dist/doc/info \
166 --libdir=/usr/lib \
167 --mandir=/opt/texlive/&texlive-year;/texmf-dist/doc/man \
168 --disable-native-texlive-build \
169 --disable-static --enable-shared \
170 --with-system-cairo \
171 --with-system-fontconfig \
172 --with-system-freetype2 \
173 --with-system-graphite2 \
174 --with-system-harfbuzz \
175 --with-system-icu \
176 --with-system-libgs \
177 --with-system-libpng \
178 --with-system-pixman \
179 --with-system-poppler \
180 --with-system-xpdf \
181 --with-system-zlib \
182 --with-banner-add=" - BLFS" &amp;&amp;
183unset TEXARCH &amp;&amp;
184
185make</userinput></screen>
186
187 <para>To test the results, issue: <command>make -k check</command>
188 One test in each of web2c, dvipng and ttf2pk2 will SKIP because kpathsea
189 has not yet been installed.</para>
190
191 <para>Now, as the <systemitem class="username">root</systemitem>
192 user:</para>
193
194<screen><userinput role="root">make install &amp;&amp;
195make texlinks</userinput></screen>
196
197 <para>And now, install the additional files as the
198 <systemitem class="username">root</systemitem> user:</para>
199
200<screen><userinput role="root">mkdir -pv /opt/texlive/&texlive-year; &amp;&amp;
201tar -xf texlive-&texlive-version;-texmf.tar.xz -C /opt/texlive/&texlive-year; --strip-components=1</userinput></screen>
202
203 <para>Now proceed to <xref linkend="tex-path"/>.</para>
204
205 </sect2>
206
207 <sect2 role="commands">
208 <title>Command Explanations</title>
209
210 <para>
211 <parameter>--prefix=, --bindir=, --datarootdir=, --infodir=, --mandir= ...
212 </parameter>: these switches ensure that the files installed from source
213 will overwrite the corresponding files previously installed by
214 <application>install-tl</application>.
215 </para>
216
217 <para>
218 <parameter>--includedir=, --libdir= ...</parameter> : these switches ensure
219 that the libraries will be found at runtime, and that programs can be
220 compiled against them.
221 </para>
222
223 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
224 href="../../xincludes/static-libraries.xml"/>
225
226 <para>
227 <parameter>--enable-shared</parameter>: Create shared versions of
228 <filename class="libraryfile">libkpathsea</filename> and
229 <filename class="libraryfile">libptexenc</filename>.
230 </para>
231
232 <para>
233 <parameter>--with-system-...</parameter>: Unless this parameter is used,
234 the included versions of these libraries will be statically compiled
235 into the programs which need them. If you decided not to install a
236 recommended library, omit the corresponding switches.
237 </para>
238
239 <para>
240 <parameter>--with-system-xpdf</parameter>: Uniquely, this parameter has
241 a non-standard meaning, it tells <command>configure</command> to use the
242 system-installed <application>poppler</application> headers and library.
243 Again, omit this if you have not installed
244 <application>poppler</application>.
245 </para>
246
247 <para>
248 <option>--without-x</option>: use this if you do not have Xorg installed.
249 </para>
250
251 <para>
252 <parameter>make texlinks</parameter> : this runs the texlinks.sh script
253 to create (or recreate) symbolic links from formats to engines. In
254 practice, several of the targets such as <command>xetex</command> are now
255 separate binaries and for these it will report "file already exists".
256 </para>
257 <para>
258 <parameter>tar -xf texlive-&texlive-version;-texmf.tar.xz -C /opt/texlive/&texlive-year; --strip-components=1</parameter>:
259 the tarball contains the files for the texmf-dist directory, and because
260 of its size we do not want to waste time and space untarring it and then
261 copying the files.
262 </para>
263
264 </sect2>
265
266 <sect2 role="content">
267 <title>Contents</title>
268
269 <segmentedlist>
270 <segtitle>Installed Programs</segtitle>
271 <segtitle>Installed Libraries</segtitle>
272 <segtitle>Installed Directories</segtitle>
273
274 <seglistitem>
275 <seg>Over 300 binaries and symlinks to scripts</seg>
276 <seg>libkpathsea.so, libptexenc.so</seg>
277 <seg>/opt/texlive/&texlive-year;/bin, /opt/texlive/&texlive-year;/texmf-dist,
278 /usr/include/kpathsea, /usr/include/ptexenc</seg>
279 </seglistitem>
280 </segmentedlist>
281
282 <variablelist>
283 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
284 <?dbfo list-presentation="list"?>
285 <?dbhtml list-presentation="table"?>
286
287 <varlistentry id="texpass1-programs">
288 <term><command>TeX&nbsp;programs</command></term>
289 <listitem>
290 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
291 href="../../xincludes/texprogs.xml"/>
292 <indexterm zone="texpass1 texpass1-programs">
293 <primary sortas="b-texpass1-programs">TeX Live programs</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="libkpathsea-texpass1">
299 <term><filename class="libraryfile">libkpathsea.so</filename></term>
300 <listitem>
301 <para>
302 (kpathsearch) exists to look up a file in a list of directories.
303 </para>
304 <indexterm zone="texpass1 libkpathsea">
305 <primary sortas="c-libkpathsea">libkpathsea.so</primary>
306 </indexterm>
307 </listitem>
308 </varlistentry>
309
310 <varlistentry id="libptexenc-texpass1">
311 <term><filename class="libraryfile">libptexenc.so</filename></term>
312 <listitem>
313 <para>
314 is a library for Japanese pTeX (publishing TeX).
315 </para>
316 <indexterm zone="texpass1 libptexenc">
317 <primary sortas="c-libptexenc">libptexenc.so</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321 </variablelist>
322
323 </sect2>
324
325</sect1>
Note: See TracBrowser for help on using the repository browser.