Debian Codegraph @

readme-html.dir/readme.en.html

raw
1 <html><head>
2 <!-- $Id: readme.en.html 71579 2024-06-21 01:28:45Z mseven $ -->
3 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
4 <meta name="viewport" content="width=device-width,initial-scale=1">
5 <title>TeX Live</title></head><body>
6
7 <h2>Welcome to TeX Live</h2>
8
9 <p>The <strong>TeX Live</strong> software distribution offers a complete
10 TeX system for a variety of GNU and Unix, Macintosh, Windows and other
11 platforms. It encompasses programs for editing, typesetting, previewing
12 and printing of TeX documents in many different languages, and a large
13 collection of TeX macros and font libraries.
14
15 <p>The distribution includes extensive general documentation about TeX,
16 as well as the documentation for the included software packages.
17
18 <p>For licensing information, please see the top-level <a
19 href="../LICENSE.TL">LICENSE.TL</a> and <a
20 href="../LICENSE.CTAN">LICENSE.CTAN</a> text files.
21
22
23 <h3>Where to start</h3>
24
25 <p>We strongly recommend that you read the TeX Live Guide before
26 undertaking the installation. It includes step-by-step instructions, a
27 description of the top-level directories, and more.
28
29 <p>If you are installing from the DVD image, the Guide in English and
30 all its translations are in the <a href="../texlive-doc">texlive-doc</a>
31 subdirectory.
32
33 <p>After installation, English versions of the Guide are in the <a
34 href="../texmf-dist/doc/texlive/texlive-en">texmf-dist/doc/texlive/</a>
35 hierarchy, in both <a
36 href="../texmf-dist/doc/texlive/texlive-en/texlive-en.html">html</a> and <a
37 href="../texmf-dist/doc/texlive/texlive-en/texlive-en.pdf">pdf</a>
38 formats. Translations to other languages are also available under <a
39 href="../texmf-dist/doc/texlive/">texmf-dist/doc/texlive</a>.
40
41 <p>We also provide a list of <a href="../doc.html">links to the
42 available PDF and HTML documentation</a> for the included packages and
43 programs.
44
45 <p>If you are installing from the Internet, the above links won't work.
46 In that case, you can view the <a
47 href="https://tug.org/texlive/doc.html">TeX Live documentation on the
48 Internet</a>.
49
50 <p>For a list of the most important changes in this year's release,
51 see the <i>Release history</i> section at the end of the documentation.
52
53
54 <h3>Installation</h3>
55
56 <p>The installation script is named <tt>install-tl</tt> and is at the
57 top level of the directory tree. You can invoke it with <tt>perl
58 install-tl</tt>. On Windows, you can run the companion batch file,
59 <tt>install-tl-windows.bat</tt>. On Macs, you will probably want to
60 install via <a href="https://tug.org/mactex/">MacTeX</a>, which has its
61 own native installer (it's also available on the DVD, next to the
62 <tt>texlive/</tt> you're in now.)
63
64 <p><tt>install-tl</tt> has two operation modes:
65
66 <dl>
67 <dt><b>-gui</b></dt> (default on Windows and Macs) which does a simple
68 installation by default, using a graphical interface, but allows for
69 advanced options if desired.<p>
70
71 <dt><b>-no-gui</b></dt> (default on everything else) which provides for
72 all available options, using a simplistic text interface.<p>
73
74 </dl>
75
76 <p>Post-installation package updates and other configurations are
77 performed with the <tt>tlmgr</tt> (TeX Live Package Manager) program,
78 which likewise has both GUI and text modes.
79
80 <p>You can give the command-line option <tt>--help</tt> to both <a
81 href="https://tug.org/texlive/doc/install-tl.html">install-tl</a> and <a
82 href="https://tug.org/texlive/tlmgr.html">tlmgr</a> for detailed
83 information on both programs. See the documentation links above for
84 (much) more information.
85
86
87 <h3>Links</h3>
88
89 <p>Finally, a few related web pages, for your reference. These are not
90 included in TeX Live:
91
92 <p><ul>
93 <li><a href="https://tug.org/begin.html">tug.org/begin.html</a>
94 - if you are new to TeX and/or want introductory material.
95 <li><a href="https://tug.org/interest.html">tug.org/interest.html</a>
96 - general list of TeX web resources, including documentation,
97 systems, packages, fonts, and more.
98 <li><a href="https://tug.org/ctan.html">tug.org/ctan.html</a>
99 - one entry point into the Comprehensive TeX Archive Network (CTAN),
100 which is an online repository of all things TeX.
101 <li><a href="https://tug.org/usergroups.html">tug.org/usergroups.html</a>
102 - list of TeX user groups around the world, with contact
103 information. We strongly encourage you to join the user group of
104 your choice, to support TeX Live and other TeX activities.
105 </ul>
106
107 <h4>Happy TeXing!</h4>
108
109 <hr><small><a href="https://tug.org/texlive/">TeX Live home page.</a></small>
110 </body></html>