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

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

Use copy members for some of the texlive dependency and command-explanation items.

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

  • Property mode set to 100644
File size: 11.2 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
111 <!-- text for recommended libraries, shared with texlive itself -->
112 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
113 href="../../xincludes/texrecommendlibs.xml"/>
114
115 <bridgehead renderas="sect4">Optional</bridgehead>
116 <!-- text for optional deps, shared with texlive itself -->
117 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
118 href="../../xincludes/texoptional.xml"/>
119
120 <bridgehead renderas="sect4">Runtime dependencies</bridgehead>
121 <!-- text for runtime deps, shared with tl-installer and pass 1 -->
122 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
123 href="../../xincludes/texruntime.xml"/>
124
125 <para condition="html" role="usernotes">User Notes:
126 <ulink url="&blfs-wiki;/texlive-pass1"/></para>
127
128 </sect2>
129
130 <sect2 role="installation">
131 <title>Installation of TeX Live, pass 1</title>
132
133 <para>
134 Install TeX Live pass 1 by running the following commands:
135 </para>
136
137<!-- the configure switches should be identical to those in the
138 first part of texlive itself -->
139<screen role="root"><userinput>export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') &amp;&amp;
140mkdir texlive-build &amp;&amp;
141cd texlive-build &amp;&amp;
142
143../configure \
144 --prefix=/opt/texlive/&texlive-year; \
145 --bindir=/opt/texlive/&texlive-year;/bin/$TEXARCH \
146 --datarootdir=/opt/texlive/&texlive-year; \
147 --includedir=/usr/include \
148 --infodir=/opt/texlive/&texlive-year;/texmf-dist/doc/info \
149 --libdir=/usr/lib \
150 --mandir=/opt/texlive/&texlive-year;/texmf-dist/doc/man \
151 --disable-native-texlive-build \
152 --disable-static --enable-shared \
153 --with-system-cairo \
154 --with-system-fontconfig \
155 --with-system-freetype2 \
156 --with-system-graphite2 \
157 --with-system-harfbuzz \
158 --with-system-icu \
159 --with-system-libgs \
160 --with-system-libpng \
161 --with-system-pixman \
162 --with-system-poppler \
163 --with-system-xpdf \
164 --with-system-zlib \
165 --with-banner-add=" - BLFS" &amp;&amp;
166unset TEXARCH &amp;&amp;
167
168make</userinput></screen>
169
170 <para>To test the results, issue: <command>make -k check</command>
171 One test in each of web2c, dvipng and ttf2pk2 will SKIP because kpathsea
172 has not yet been installed.</para>
173
174 <para>Now, as the <systemitem class="username">root</systemitem>
175 user:</para>
176
177<screen><userinput role="root">make install &amp;&amp;
178make texlinks</userinput></screen>
179
180 <para>And now, install the additional files as the
181 <systemitem class="username">root</systemitem> user:</para>
182
183<screen><userinput role="root">mkdir -pv /opt/texlive/&texlive-year; &amp;&amp;
184tar -xf texlive-&texlive-version;-texmf.tar.xz -C /opt/texlive/&texlive-year; --strip-components=1</userinput></screen>
185
186 <para>Now proceed to <xref linkend="tex-path"/>.</para>
187
188 </sect2>
189
190 <sect2 role="commands">
191 <title>Command Explanations</title>
192
193 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
194 href="../../xincludes/tex-prefix.xml"/>
195
196 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
197 href="../../xincludes/tex-lib.xml"/>
198
199 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
200 href="../../xincludes/static-libraries.xml"/>
201
202 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
203 href="../../xincludes/tex-shared.xml"/>
204
205 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
206 href="../../xincludes/tex-system.xml"/>
207
208<!-- <para>
209 <parameter>\-\-with-system-xpdf</parameter>: Uniquely, this parameter has
210 a non-standard meaning, it tells <command>configure</command> to use the
211 system-installed <application>poppler</application> headers and library.
212 Again, omit this if you have not installed
213 <application>poppler</application>.
214 </para> -->
215 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
216 href="../../xincludes/tex-xpdf.xml"/>
217
218 <para>
219 <option>--without-x</option>: use this if you do not have Xorg installed.
220 </para>
221
222 <para>
223 <parameter>make texlinks</parameter> : this runs the texlinks.sh script
224 to create (or recreate) symbolic links from formats to engines. In
225 practice, several of the targets such as <command>xetex</command> are now
226 separate binaries and for these it will report "file already exists".
227 </para>
228 <para>
229 <parameter>tar -xf texlive-&texlive-version;-texmf.tar.xz -C /opt/texlive/&texlive-year; --strip-components=1</parameter>:
230 the tarball contains the files for the texmf-dist directory, and because
231 of its size we do not want to waste time and space untarring it and then
232 copying the files.
233 </para>
234
235 </sect2>
236
237 <sect2 role="content">
238 <title>Contents</title>
239
240 <segmentedlist>
241 <segtitle>Installed Programs</segtitle>
242 <segtitle>Installed Libraries</segtitle>
243 <segtitle>Installed Directories</segtitle>
244
245 <seglistitem>
246 <seg>Over 300 binaries and symlinks to scripts</seg>
247 <seg>libkpathsea.so, libptexenc.so</seg>
248 <seg>/opt/texlive/&texlive-year;/bin, /opt/texlive/&texlive-year;/texmf-dist,
249 /usr/include/kpathsea, /usr/include/ptexenc</seg>
250 </seglistitem>
251 </segmentedlist>
252
253 <variablelist>
254 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
255 <?dbfo list-presentation="list"?>
256 <?dbhtml list-presentation="table"?>
257
258 <varlistentry id="texpass1-programs">
259 <term><command>TeX&nbsp;programs</command></term>
260 <listitem>
261 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
262 href="../../xincludes/texprogs.xml"/>
263 <indexterm zone="texpass1 texpass1-programs">
264 <primary sortas="b-texpass1-programs">TeX Live programs</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 <varlistentry id="libkpathsea-texpass1">
270 <term><filename class="libraryfile">libkpathsea.so</filename></term>
271 <listitem>
272 <para>
273 (kpathsearch) exists to look up a file in a list of directories.
274 </para>
275 <indexterm zone="texpass1 libkpathsea">
276 <primary sortas="c-libkpathsea">libkpathsea.so</primary>
277 </indexterm>
278 </listitem>
279 </varlistentry>
280
281 <varlistentry id="libptexenc-texpass1">
282 <term><filename class="libraryfile">libptexenc.so</filename></term>
283 <listitem>
284 <para>
285 is a library for Japanese pTeX (publishing TeX).
286 </para>
287 <indexterm zone="texpass1 libptexenc">
288 <primary sortas="c-libptexenc">libptexenc.so</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292 </variablelist>
293
294 </sect2>
295
296</sect1>
Note: See TracBrowser for help on using the repository browser.