source: pst/typesetting/tl-installer.xml@ c74eb3a

10.0 10.1 11.0 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since c74eb3a was c74eb3a, checked in by Ken Moffat <ken@…>, 3 years ago

TeXLive 2018.

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

  • Property mode set to 100644
File size: 9.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 tl-installer-download-http "http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz">
8
9 <!ENTITY tl-installer-download-ftp " ">
10 <!ENTITY tl-installer-md5sum "3a1ab4e0ed369f2a58e52184636ac0df">
11 <!ENTITY tl-installer-date "20180428"> <!-- in the directory name -->
12 <!ENTITY tl-installer-size "2.7 MB">
13
14 <!ENTITY tl-installer-buildsize "5.5 GB if everything is included">
15 <!ENTITY tl-installer-time "varies, depending on network speed and traffic">
16]>
17
18<sect1 id="tl-installer" xreflabel="install-tl-unx">
19 <?dbhtml filename="tl-installer.html"?>
20
21 <sect1info>
22 <othername>$LastChangedBy$</othername>
23 <date>$Date$</date>
24 </sect1info>
25
26 <title>install-tl-unx</title>
27
28 <indexterm zone="tl-installer">
29 <primary sortas="a-install-tl-unx">install-tl-unx</primary>
30 </indexterm>
31
32 <sect2 role="package">
33 <title>Introduction to TeX Live and its installer</title>
34
35 <para>The <application>TeX Live</application> package is a comprehensive
36 TeX document production system. It includes TeX, LaTeX2e, ConTeXt,
37 Metafont, MetaPost, BibTeX and many other programs; an extensive collection
38 of macros, fonts and documentation; and support for typesetting in many
39 different scripts from around the world.</para>
40
41 <para>This page is for people who wish to use the binary installer to
42 provide the programs, the scripts, and a lot of supporting files and
43 documentation. The installer is updated frequently, so its md5sum will
44 change if it is newer than what is shown below. Newer versions of the
45 installer are expected to work with these instructions, for so long as they
46 install to a
47 <filename class="directory">&texlive-year;/</filename> directory.</para>
48
49 <para>
50 There are two reasons why you may wish to install the binaries in BLFS:
51 either you need a smaller install (e.g. at a minimum plain TeX without
52 LaTeX2e, ConTeXt, etc), or you wish to use <command>tlmgr</command> to
53 get updates whilst this version is supported (typically, until April of
54 the year after it was released). For the latter, you might prefer to
55 install in your <filename class="directory">/home</filename> directory
56 as an unprivileged user, and to then make corresponding changes to the
57 PATH in your <filename>~/.bashrc</filename> or equivalent.
58 </para>
59
60 &lfs82_checked;
61
62 <bridgehead renderas="sect3">Package Information</bridgehead>
63 <itemizedlist spacing="compact">
64 <listitem>
65 <para>Download (HTTP): <ulink url="&tl-installer-download-http;"/></para>
66 </listitem>
67 <listitem>
68 <para>Download (FTP): <ulink url="&tl-installer-download-ftp;"/></para>
69 </listitem>
70 <listitem>
71 <para>Download MD5 sum: &tl-installer-md5sum; (for &tl-installer-date;)</para>
72 </listitem>
73 <listitem>
74 <para>Download size: &tl-installer-size;</para>
75 </listitem>
76 <listitem>
77 <para>Estimated disk space required: &tl-installer-buildsize;</para>
78 </listitem>
79 <listitem>
80 <para>Estimated build time: &tl-installer-time;</para>
81 </listitem>
82 </itemizedlist>
83
84 <bridgehead renderas="sect4">Recommended</bridgehead>
85 <para role="recommended">
86 <xref linkend="gnupg2"/> (to validate both the initial downloads, and also
87 any updates you might later make using <command>tlmgr</command>.)
88 </para>
89
90 <bridgehead renderas="sect4">Recommended (at runtime)</bridgehead>
91 <para role="recommended">
92 The binaries are mostly linked to included static libraries or
93 general (LFS) system libraries, but a few of the programs
94 and several scripts will fail if the following packages are not present:
95 </para>
96 <para role="recommended">
97 <xref role="runtime" linkend="gs"/> is dynamically loaded by dvisvgm, which is used by
98 <application>asy</application>.
99 </para>
100 <para role="recommended">
101 <xref role="runtime" linkend="xorg7-lib"/> and
102 <xref role="runtime" linkend="libxcb"/> are needed for inimf, mf,
103 pdfclose, pdfopen and xdvi-xaw. But if you are using asy, or using a
104 <application>TeX</application> engine to create a PDF file, you will
105 need an <xref role="runtime" linkend="x-window-system"/> (for PDF files,
106 this is to support a PDF viewer of your choice, for example
107 <xref role="nodep" linkend="epdfview"/>).
108 </para>
109 <para role="recommended">
110 the optional non-wide-character ncurses library (for "some binary-only
111 application") from the bottom of the <application>Ncurses</application>
112 page in LFS is needed by <application>asy</application>
113 and also for xindy.run which is used by <application>xindy</application>
114 </para>
115 <para role="recommended">
116 The binary versions of <application>asy</application> need
117 <xref linkend="glu"/>, <xref linkend="freeglut"/>. and <ulink
118 url="&gnu-ftp;/readline/readline-6.3.tar.gz">libreadline-6.3</ulink>
119 with the LFS patch <ulink
120 url="http://www.linuxfromscratch.org/patches/downloads/readline/readline-6.3-upstream_fixes-3.patch">readline-6.3-upstream_fixes-1.patch</ulink>
121 : asy only requires <filename>libreadline.so.6.3</filename> which can be
122 manually copied from the <filename class="directory">shlib/</filename>
123 directory after running <command>configure</command> and
124 <command>make</command>
125 and then symlinked as <filename>libreadline.so.6</filename>.
126 </para>
127 <para>
128 As always with contributed binary software, it is possible that the required
129 dependencies may change when the installer is updated. In particular, these
130 dependencies have only been checked on x86_64.
131 </para>
132 <!-- text for runtime deps, shared with texlive -->
133 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
134 href="../../xincludes/texruntime.xml"/>
135
136 <para condition="html" role="usernotes">User Notes:
137 <ulink url="&blfs-wiki;/tl-installer"/></para>
138
139 </sect2>
140
141 <sect2 role="installation">
142 <title>Binary Installation of TeX Live</title>
143
144 <para>The <application>TeX Live</application> set of programs with its
145 supporting documents, fonts, and utilities is very large. The upstream
146 maintainers recommend placing all files in a single directory structure.
147 BLFS recommends <filename class='directory'>/opt/texlive</filename>.</para>
148
149 <para>As with any other package, unpack the installer and change into its
150 directory, <filename class='directory'>install-tl-&lt;CCYYMMDD&gt;</filename>.
151 This directory name changes when the installer is updated, so replace
152 &lt;CCYYMMDD&gt; by the correct directory name.</para>
153
154 <note>
155 <para>
156 The distribution binaries installed below may use static linking
157 for general linux system libraries. Additional libraries or interpreters
158 as specified in the dependencies section do not need to be present during
159 the install, but the programs that need them will not run until their
160 specific dependencies have been installed.
161 </para>
162
163 <!-- please keep something like this in the future -->
164 <para>
165 With all contributed binary software, there may be a mismatch between the
166 builder's toolchain and your hardware. In most of TeX this will probably
167 not matter, but in uncommon corner cases you might hit problems.
168 e.g. if your x86_64 processor does not support 3dnowext or 3dnow, the
169 2014-06-28 binary failed in conTeXt when running LuaTeX, although lualatex
170 worked, as did the i686 binaries on the same machine. In such cases, the
171 easiest solution is to install texlive from source. Similarly, the x86_64
172 binary version of <command>asy</command> runs very slowly when creating 3-D
173 diagrams.
174 </para>
175 </note>
176
177 <para>Now, as the <systemitem class="username">root</systemitem>
178 user:</para>
179
180<screen role="root"><userinput>TEXLIVE_INSTALL_PREFIX=/opt/texlive ./install-tl</userinput></screen>
181
182 <para>This command is interactive and allows selection or modification of
183 platform, packages, directories, and other options. The full installation
184 scheme will require about 4.9 gigabytes of disk space. The time to complete
185 the download will depend on your internet connection speed and the
186 number of packages selected.</para>
187
188 </sect2>
189
190 <sect2 role="commands">
191 <title>Command Explanations</title>
192
193 <para>
194 <option>./install-tl --location
195 http://mirror.aut.ac.nz/CTAN/systems/texlive/tlnet/</option>: use a
196 variation of this if you wish to use a different mirror, e.g. because
197 you are in New Zealand but the installer chooses to use an Australian
198 mirror. The list of mirrors is at http://ctan.org/mirrors.
199 </para>
200
201 </sect2>
202
203 <sect2 role="content">
204 <title>Contents</title>
205
206 <segmentedlist>
207 <segtitle>Installed Programs</segtitle>
208 <segtitle>Installed Libraries</segtitle>
209 <segtitle>Installed Directories</segtitle>
210
211 <seglistitem>
212 <seg>Over 300 binaries and symlinks to scripts</seg>
213 <seg>None</seg>
214 <seg>/opt/texlive</seg>
215 </seglistitem>
216 </segmentedlist>
217
218 <variablelist>
219 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
220 <?dbfo list-presentation="list"?>
221 <?dbhtml list-presentation="table"?>
222
223 <varlistentry id="tl-installer-programs">
224 <term><command>TeX&nbsp;programs</command></term>
225 <listitem>
226 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
227 href="../../xincludes/texprogs.xml"/>
228 <indexterm zone="tl-installer tl-installer-programs">
229 <primary sortas="b-tl-installer-programs">TeX Live programs</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233 </variablelist>
234
235 </sect2>
236
237</sect1>
Note: See TracBrowser for help on using the repository browser.