source: pst/typesetting/tl-installer.xml@ 45ab6c7

11.0 lazarus qt5new trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 5 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 9.7 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 "769eb3849f931ca3efcbeeca093b95c0">
11 <!ENTITY tl-installer-date "20200406"> <!-- in the directory name -->
12 <!ENTITY tl-installer-size "3.8 MB">
13
14 <!ENTITY tl-installer-buildsize "6.6 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 <para role="recommended">
128 the optional non-wide-character ncurses library (for "some binary-only
129 application") from the bottom of the <application>Ncurses</application>
130 page in LFS is needed
131 for xindy.run which is used by <application>xindy</application>
132 </para>
133 <para role="recommended">
134 The binary version of <application>asy</application> needs
135 <xref linkend="freeglut"/>.
136 </para>
137 <note>
138 <para>
139 As always with contributed binary software, it is possible that the
140 required dependencies may change when the installer is updated. In
141 particular, these dependencies have only been checked on x86_64.
142 </para>
143 </note>
144 <!-- text for runtime deps, shared with texlive -->
145 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
146 href="../../xincludes/texruntime.xml"/>
147
148 <para condition="html" role="usernotes">User Notes:
149 <ulink url="&blfs-wiki;/tl-installer"/></para>
150
151 </sect2>
152
153 <sect2 role="installation">
154 <title>Binary Installation of TeX Live</title>
155
156 <para>
157 The <application>TeX Live</application> set of programs with its
158 supporting documents, fonts, and utilities is very large. The upstream
159 maintainers recommend placing all files in a single directory structure.
160 BLFS recommends <filename class='directory'>/opt/texlive</filename>.
161 </para>
162
163 <para>
164 As with any other package, unpack the installer and change into its
165 directory, <filename class='directory'>
166 install-tl-&lt;CCYYMMDD&gt;</filename>.
167 This directory name changes when the installer is updated, so replace
168 &lt;CCYYMMDD&gt; by the correct directory name.
169 </para>
170
171 <note>
172 <para>
173 The distribution binaries installed below may use static linking
174 for general linux system libraries. Additional libraries or
175 interpreters as specified in the dependencies section do not need to
176 be present during the install, but the programs that need them will
177 not run until their specific dependencies have been installed.
178 </para>
179
180 <!-- please keep something like this in the future -->
181 <para>
182 With all contributed binary software, there may be a mismatch between
183 the builder's toolchain and your hardware. In most of TeX this will
184 probably not matter, but in uncommon corner cases you might hit
185 problems. e.g. if your x86_64 processor does not support 3dnowext or
186 3dnow, the 2014-06-28 binary failed in conTeXt when running LuaTeX,
187 although lualatex worked, as did the i686 binaries on the same
188 machine. In such cases, the easiest solution is to install texlive
189 from source. Similarly, the x86_64 binary version of
190 <command>asy</command> runs very slowly when creating 3-D diagrams.
191 </para>
192 </note>
193
194 <para>
195 Now, as the <systemitem class="username">root</systemitem> user:
196 </para>
197
198<screen role="root"><userinput>TEXLIVE_INSTALL_PREFIX=/opt/texlive ./install-tl</userinput></screen>
199
200 <para>
201 This command is interactive and allows selection or modification of
202 platform, packages, directories, and other options. The full installation
203 scheme will require about 4.9 gigabytes of disk space. The time to
204 complete the download will depend on your internet connection speed
205 and the number of packages selected.
206 </para>
207
208 </sect2>
209
210 <sect2 role="commands">
211 <title>Command Explanations</title>
212
213 <para>
214 <option>./install-tl --location
215 http://mirror.aut.ac.nz/CTAN/systems/texlive/tlnet/</option>: use a
216 variation of this if you wish to use a different mirror, e.g. because
217 you are in New Zealand but the installer chooses to use an Australian
218 mirror. The list of mirrors is at http://ctan.org/mirrors.
219 </para>
220
221 </sect2>
222
223 <sect2 role="content">
224 <title>Contents</title>
225
226 <segmentedlist>
227 <segtitle>Installed Programs</segtitle>
228 <segtitle>Installed Libraries</segtitle>
229 <segtitle>Installed Directories</segtitle>
230
231 <seglistitem>
232 <seg>Over 300 binaries and symlinks to scripts</seg>
233 <seg>None</seg>
234 <seg>/opt/texlive</seg>
235 </seglistitem>
236 </segmentedlist>
237
238 <variablelist>
239 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
240 <?dbfo list-presentation="list"?>
241 <?dbhtml list-presentation="table"?>
242
243 <varlistentry id="tl-installer-programs">
244 <term><command>TeX&nbsp;programs</command></term>
245 <listitem>
246 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
247 href="../../xincludes/texprogs.xml"/>
248 <indexterm zone="tl-installer tl-installer-programs">
249 <primary sortas="b-tl-installer-programs">TeX Live programs</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253 </variablelist>
254
255 </sect2>
256
257</sect1>
Note: See TracBrowser for help on using the repository browser.