summaryrefslogtreecommitdiff
path: root/Master/readme-html.dir/readme.en.html
blob: 73c20dc411434a5205e371befef0d2c37cf0b955 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
<html><head>
<!-- $Id$ -->
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>TeX Live</title></head><body>

<h2>Welcome to TeX Live</h2>

<p>The <strong>TeX Live</strong> software distribution offers a complete
TeX system for a variety of GNU and Unix, Macintosh, Windows and other
platforms. It encompasses programs for editing, typesetting, previewing
and printing of TeX documents in many different languages, and a large
collection of TeX macros and font libraries.

<p>The distribution includes extensive general documentation about TeX,
as well as the documentation for the included software packages.

<p>For licensing information, please see the top-level <a
href="../LICENSE.TL">LICENSE.TL</a> and <a
href="../LICENSE.CTAN">LICENSE.CTAN</a> text files.

<h3>Where to start</h3>

<p>We strongly recommend that you read the TeX Live Guide before
undertaking the installation.  It includes step-by-step instructions, a
description of the top-level directories, and more.

<p>If you are installing from the DVD image, the Guide in English and
all its translations are in the <a href="../texlive-doc">texlive-doc</a>
subdirectory.

<p>After installation, English versions of the Guide are in the <a
href="../texmf-dist/doc/texlive/texlive-en">texmf-dist/doc/texlive/</a>
hierarchy, in both <a
href="../texmf-dist/doc/texlive/texlive-en/texlive-en.html">html</a> and <a
href="../texmf-dist/doc/texlive/texlive-en/texlive-en.pdf">pdf</a>
formats. Translations to other languages are also available under <a
href="../texmf-dist/doc/texlive/">texmf-dist/doc/texlive</a>.

<p>We also provide a list of <a href="../doc.html">links to the
available PDF and HTML documentation</a> for the included packages and
programs.

<p>If you are installing from the Internet, the above links won't work.
In that case, you can view the <a
href="https://tug.org/texlive/doc.html">TeX Live documentation on the
Internet</a>.

<p>For a list of the most important changes in this year's release,
see the <i>Release history</i> section at the end of the documentation.


<h3>Installation</h3>

<p>The installation script is named <tt>install-tl</tt> and is at the
top level of the directory tree. You can invoke it with <tt>perl
install-tl</tt>. On Windows, you can run the companion batch file,
<tt>install-tl-windows.bat</tt>. On Macs, you will probably want to
install via <a href="https://tug.org/mactex/">MacTeX</a>, which has its
own native installer (it's also available on the DVD, next to the
<tt>texlive/</tt> you're in now.)

<p><tt>install-tl</tt> has two operation modes:

<dl>
<dt><b>-gui</b></dt> (default on Windows and Macs) which does a simple
installation by default, using a graphical interface, but allows for
advanced options if desired.<p>  

<dt><b>-no-gui</b></dt> (default on everything else) which provides for
all available options, using a simplistic text interface.<p>

</dl>

<p>Post-installation package updates and other configurations are
performed with the <tt>tlmgr</tt> (TeX Live Package Manager) program,
which likewise has both GUI and text modes.

<p>You can give the command-line option <tt>--help</tt> to both <a
href="https://tug.org/texlive/doc/install-tl.html">install-tl</a> and <a
href="https://tug.org/texlive/tlmgr.html">tlmgr</a> for detailed
information on both programs.  See the documentation links above for
(much) more information.


<h3>Links</h3>

<p>Finally, a few related web pages, for your reference.  These are not
included in TeX Live:

<p><ul>
<li><a href="https://tug.org/begin.html">tug.org/begin.html</a>
    - if you are new to TeX and/or want introductory material.
<li><a href="https://tug.org/interest.html">tug.org/interest.html</a>
    - general list of TeX web resources, including documentation,
      systems, packages, fonts, and more.
<li><a href="https://tug.org/ctan.html">tug.org/ctan.html</a>
    - one entry point into the Comprehensive TeX Archive Network (CTAN),
      which is an online repository of all things TeX.
<li><a href="https://tug.org/usergroups.html">tug.org/usergroups.html</a>
    - list of TeX user groups around the world, with contact
      information.  We strongly encourage you to join the user group of
      your choice, to support TeX Live and other TeX activities.
</ul>

<h4>Happy TeXing!</h4>

<hr><small><a href="https://tug.org/texlive/">TeX Live home page.</a></small>
</body></html>