source: pst/typesetting/tl-installer.xml@ 00a3154

11.0 qt5new trunk
Last change on this file since 00a3154 was 00a3154, checked in by Ken Moffat <ken@…>, 5 months ago

Update to texlive-2021.

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