mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-02-10 21:24:39 +08:00
ed3707eae3
Moved the profile script to texlive.sh from extrapaths.sh. Created an environment variable TEXLIVE_PREFIX and incorporated it into the chapter's build scripts. An additional optimization can still be made by moving the TEXARCH variable into texlive.sh and removing it from package instructions.
280 lines
11 KiB
XML
280 lines
11 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../../general.ent">
|
|
%general-entities;
|
|
|
|
<!ENTITY tl-installer-download-http "https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz">
|
|
|
|
<!ENTITY tl-installer-download-ftp " ">
|
|
<!ENTITY tl-installer-md5sum "00268146cfced12c34fe5f515f032c69">
|
|
<!ENTITY tl-installer-date "20220321"> <!-- in the directory name -->
|
|
<!ENTITY tl-installer-size "5.6 MB">
|
|
|
|
<!ENTITY tl-installer-buildsize "118 MB for basic TeX and latex, 7.1 GB if everything is included">
|
|
<!ENTITY tl-installer-time "varies, depending on network speed and traffic">
|
|
]>
|
|
|
|
<sect1 id="tl-installer" xreflabel="install-tl-unx">
|
|
<?dbhtml filename="tl-installer.html"?>
|
|
|
|
<sect1info>
|
|
<date>$Date$</date>
|
|
</sect1info>
|
|
|
|
<title>install-tl-unx</title>
|
|
|
|
<indexterm zone="tl-installer">
|
|
<primary sortas="a-install-tl-unx">install-tl-unx</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title>Introduction to TeX Live and its installer</title>
|
|
|
|
<para>
|
|
The <application>TeX Live</application> package is a comprehensive
|
|
TeX document production system. It includes TeX, LaTeX2e, ConTeXt,
|
|
Metafont, MetaPost, BibTeX and many other programs; an extensive
|
|
collection of macros, fonts and documentation; and support for
|
|
typesetting in many different scripts from around the world.
|
|
</para>
|
|
|
|
<para>
|
|
This page is for people who wish to use the binary installer to
|
|
provide the programs, the scripts, and a lot of supporting files and
|
|
documentation. The installer is updated frequently, so any published
|
|
md5sum will soon be out of date. Newer versions of the
|
|
installer are expected to work with these instructions, for so long as
|
|
they install to a
|
|
<filename class="directory">&texlive-year;/</filename> directory.
|
|
</para>
|
|
|
|
<para>
|
|
There are two reasons why you may wish to install the binaries in BLFS:
|
|
either you need a smaller install (e.g. at a minimum plain TeX without
|
|
LaTeX2e, ConTeXt, etc), or you wish to use <command>tlmgr</command> to
|
|
get updates whilst this version is supported (typically, until April of
|
|
the year after it was released). For the latter, you might prefer to
|
|
install in your <filename class="directory">/home</filename> directory
|
|
as an unprivileged user, and to then make corresponding changes to the
|
|
PATH in your <filename>~/.bashrc</filename> or equivalent.
|
|
</para>
|
|
|
|
&lfs111_checked;
|
|
|
|
<bridgehead renderas="sect3">Package Information</bridgehead>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>
|
|
Download (HTTP): <ulink url="&tl-installer-download-http;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download (FTP): <ulink url="&tl-installer-download-ftp;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<!--Download MD5 sum: &tl-installer-md5sum; (for &tl-installer-date;)-->
|
|
Download MD5 sum: Varies frequently
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download size: &tl-installer-size;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated disk space required: &tl-installer-buildsize;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated build time: &tl-installer-time;
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<bridgehead renderas="sect4">Recommended</bridgehead>
|
|
<para role="recommended">
|
|
<xref linkend="gnupg2"/> (to validate both the initial downloads, and also
|
|
any updates you might later make using <command>tlmgr</command>.)
|
|
<xref linkend="perl-libwww-perl"/> (to use a single connection to the server,
|
|
which will reduce its load and speed things up.)
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Recommended (at runtime)</bridgehead>
|
|
<para role="recommended">
|
|
The binaries are mostly linked to included static libraries or
|
|
general (LFS) system libraries, but a few of the programs
|
|
and several scripts will fail if the following packages are not present:
|
|
</para>
|
|
<para role="recommended">
|
|
<xref role="runtime" linkend="gs"/> is dynamically loaded by
|
|
the external application <ulink url="https://dvisvgm.de/">dvisvgm</ulink>,
|
|
which is used by <application>asy</application> when that creates SVG
|
|
files.
|
|
</para>
|
|
<para role="recommended">
|
|
<xref role="runtime" linkend="xorg7-lib"/> and
|
|
<xref role="runtime" linkend="libxcb"/> are needed for inimf, mf,
|
|
pdfclose, pdfopen and xdvi-xaw. But if you are using asy, or using a
|
|
<application>TeX</application> engine to create a PDF file, you will
|
|
need <xref role="runtime" linkend="x-window-system"/> (for PDF files,
|
|
this is to support a PDF viewer of your choice, for example
|
|
<xref role="nodep" linkend="epdfview"/>).
|
|
</para>
|
|
<!-- seems to not be needed in 2021
|
|
<para role="recommended">
|
|
the optional non-wide-character ncurses library (for "some binary-only
|
|
application") from the bottom of the <application>Ncurses</application>
|
|
page in LFS is needed
|
|
for xindy.run which is used by <application>xindy</application>
|
|
</para> -->
|
|
<para role="recommended">
|
|
The binary version of <application>asy</application> needs
|
|
<xref linkend="freeglut"/>.
|
|
</para>
|
|
<note>
|
|
<para>
|
|
As always with contributed binary software, it is possible that the
|
|
required dependencies may change when the installer is updated. In
|
|
particular, these dependencies have only been checked on x86_64.
|
|
</para>
|
|
</note>
|
|
<!-- text for runtime deps, shared with texlive -->
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="../../xincludes/texruntime.xml"/>
|
|
|
|
<para condition="html" role="usernotes">User Notes:
|
|
<ulink url="&blfs-wiki;/tl-installer"/></para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Binary Installation of TeX Live</title>
|
|
|
|
<para>
|
|
The <application>TeX Live</application> set of programs with its
|
|
supporting documents, fonts, and utilities is very large. The upstream
|
|
maintainers recommend placing all files in a single directory structure.
|
|
BLFS recommends <filename class='directory'>/opt/texlive</filename>.
|
|
</para>
|
|
|
|
<para>
|
|
As with any other package, unpack the installer and change into its
|
|
directory, <filename class='directory'>
|
|
install-tl-<CCYYMMDD></filename>.
|
|
This directory name changes when the installer is updated, so replace
|
|
<CCYYMMDD> by the correct directory name.
|
|
</para>
|
|
|
|
<note>
|
|
<para>
|
|
The distribution binaries installed below may use static linking
|
|
for general linux system libraries. Additional libraries or
|
|
interpreters as specified in the dependencies section do not need to
|
|
be present during the install, but the programs that need them will
|
|
not run until their specific dependencies have been installed.
|
|
</para>
|
|
|
|
<!-- please keep something like this in the future -->
|
|
<para>
|
|
With all contributed binary software, there may be a mismatch between
|
|
the builder's toolchain and your hardware. In most of TeX this will
|
|
probably not matter, but in uncommon corner cases you might hit
|
|
problems. For example, if your x86_64 processor does not support 3dnowext or
|
|
3dnow, the 2014-06-28 binary failed in conTeXt when running LuaTeX,
|
|
although lualatex worked, as did the i686 binaries on the same
|
|
machine. In such cases, the easiest solution is to install texlive
|
|
from source. Similarly, the x86_64 binary version of
|
|
<command>asy</command> runs very slowly when creating 3-D diagrams.
|
|
</para>
|
|
</note>
|
|
|
|
<para>
|
|
Now, as the <systemitem class="username">root</systemitem> user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>TEXLIVE_INSTALL_PREFIX=/opt/texlive ./install-tl</userinput></screen>
|
|
|
|
<para>
|
|
This command is interactive and allows selection or modification of
|
|
platform, packages, directories, and other options. The full installation
|
|
scheme will require about 4.9 gigabytes of disk space. The time to
|
|
complete the download will depend on your internet connection speed
|
|
and the number of packages selected.
|
|
</para>
|
|
|
|
<para>
|
|
It has been established by debian that the <command>python</command>
|
|
scripts in <filename class="directory">latex-make</filename> will work
|
|
with <command>python3</command>, so update them to invoke that by running
|
|
the following command as the <systemitem class="username">root</systemitem>
|
|
user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>for F in /opt/texlive/&texlive-year;/texmf-dist/scripts/latex-make/*.py ; do
|
|
test -f $F && sed -i 's%/usr/bin/env python%/usr/bin/python3%' $F || true
|
|
done
|
|
</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="commands">
|
|
<title>Command Explanations</title>
|
|
|
|
<para>
|
|
<command>test -f $F && sed ...</command>: in a small install these
|
|
files might not be present, so test if they exist and if not return 'true'
|
|
to avoid any error if this command has been copied into one of your own install scripts.
|
|
</para>
|
|
|
|
<para>
|
|
<option>./install-tl --location
|
|
http://mirror.aut.ac.nz/CTAN/systems/texlive/tlnet/</option>: use a
|
|
variation of this if you wish to use a different mirror, for example, because
|
|
you are in New Zealand but the installer chooses to use an Australian
|
|
mirror. The list of mirrors is at http://ctan.org/mirrors.
|
|
</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="content">
|
|
<title>Contents</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed Programs</segtitle>
|
|
<segtitle>Installed Libraries</segtitle>
|
|
<segtitle>Installed Directories</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>Over 300 binaries and symlinks to scripts</seg>
|
|
<seg>None</seg>
|
|
<seg>/opt/texlive</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="tl-installer-programs">
|
|
<term><command>TeX programs</command></term>
|
|
<listitem>
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="../../xincludes/texprogs.xml"/>
|
|
<indexterm zone="tl-installer tl-installer-programs">
|
|
<primary sortas="b-tl-installer-programs">TeX Live programs</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|