summaryrefslogtreecommitdiff
path: root/Master/readme.en.html
blob: 60e751157bae46fbce9b6a1899e0037d39772648 (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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
<html><head>
<!-- $Id$ -->
<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 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 also includes extensive general documentation about
TeX, as well as the documentation accompanying 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>English versions of the Guide are in the <a
href="texmf-doc/doc/english">texmf-doc/doc/english/</a> hierarchy, in
both <a href="texmf-doc/doc/english/texlive-en/live.html">html</a> and
<a href="texmf-doc/doc/english/texlive-en/live.pdf">pdf</a> formats.
Translations to other languages are also available under <a
href="texmf-doc/doc/">texmf-doc/doc/*</a>.

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


<h3>Installation</h3>

<p>Space limitations of CD-ROM format have forced us to divide TeX Live
into several distributions.  You can tell which one you're in by looking
for a <tt>00<i>type</i>.TL</tt> file in this top-level directory.

<dl>
<dt><b>live</b></dt>
<dd>A complete system on DVD; it is too large for CD.  You can run
  programs directly from the mounted DVD; see the documentation for
  details.  Or you can install to disk by executing the script
  <tt>install-tl.sh</tt> in the <tt>texlive</tt> directory under Unix,
  including MacOSX (GNU/Linux users can also try setuptl/tlpmgui-i386-linux).  
  A Windows installer named <tt>tlpmgui.exe</tt> is also
  available, in the <tt>setuptl</tt> directory.

  <p>The live DVD also contains other distributions: proTeXt (see
  below); MacTeX, for MacOSX; and a snapshot of CTAN.  Each of these are
  completely independent from TeX Live, with different licensing
  conditions.
</dd>

<dt><b>inst(allable)</b></dt>
<dd>A complete system on CD, for installing on Unix (including MacOSX)
  or Windows; in order to make it fit, we had to compress everything we
  could.  Therefore, it is not possible to run TeX directly from the
  installable CD; you have to install it to disk (hence its name).  Do
  this by running <tt>./install-tl.sh</tt> on Unix or MacOSX, or
  <tt>setuptl/tlpmgui-i386-linux</tt> (GNU/Linux GUI install), or
  <tt>setuptl/tlpmgui.exe</tt> on Windows.
  <p><!-- spacing kludge -->
</dd>

<dt><b>protext</b></dt>
<dd>The proTeXt distribution for Windows is an enhancement of MiKTeX: it
  adds a few extra tools, and simplifies installation considerably.  It is
  completely independent of TeX Live, and has its own installation
  instructions.  It can be run live or installed to disk.  proTeXt is
  provided on the live DVD, and (for some user groups) its own CD.
  <p><!-- spacing kludge -->
</dd>

</dl>

<p>Naturally, each user group chooses what to distribute, at its own
discretion.  (TUG is sending all three discs above to its members.)

<p>CD format details: For Unix and Mac, the CD's use the Rock Ridge
extensions to the standard ISO-9660 format.  For Windows, Microsoft
Joliet extensions are used.  In any case, you should see the full names
after mounting.  If you see truncated names, you cannot run programs
directly.  If you have plenty of bandwidth and know how to burn discs,
the <a href="http://tug.org/ftp/texlive/Images/">ISO images are
available online</a>.  The <a
href="http://tug.org/ftp/texlive/Contents/">contents are also available
for browsing</a>.


<h3>Documentation</h3>

<p>Most of the documentation can be viewed online, before the TeX system
is installed.  To read it most conveniently, you will need to have a
browser (such as <a href="http://www.mozilla.org/">Mozilla</a>, the free
version of Netscape) for HTML documents, and a PDF reader (such as <a
href="http://tug.org/applications/gv/">gv</a> or <a
href="http://www.foolabs.com/xpdf/">xpdf</a>, both free alternatives to
Acrobat) for PDF documents.

<ul>
<li><a href="texmf-doc/doc/english/texlive-en/live.html"><strong>TeX Live 
    documentation</strong></a> (html).

<li><a href="doc.html">Links to all included PDF and HTML documentation</a>.

<li>TeX FAQ's in the distribution:
    <a href="texmf-doc/doc/czechslovak/cstug/csfaq/">Czech/Slovak</a>,
    <a href="texmf-doc/doc/english/FAQ-en/newfaq.pdf">English</a> (pdf),
    <a href="texmf-doc/doc/french/FAQ-fr/">French</a>,
    <a href="texmf-doc/doc/german/FAQ-ge/">German</a>,
</ul>

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

<ul>
<li><a href="http://tug.org/begin.html">http://tug.org/begin.html</a>
    - if you are new to TeX and/or want introductory material.
<li><a href="http://tug.org/interest.html">http://tug.org/interest.html</a>
    - general list of TeX web resources, including documentation,
      systems, packages, fonts, and more.
<li><a href="http://tug.org/ctan.html">http://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="http://tug.org/usergroups.html">http://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="http://tug.org/tex-live/">TeX Live home page.</a></small>
</body></html>