summaryrefslogtreecommitdiff
path: root/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Installation.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Installation.html')
-rw-r--r--Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Installation.html270
1 files changed, 270 insertions, 0 deletions
diff --git a/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Installation.html b/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Installation.html
new file mode 100644
index 00000000000..b97ff1be665
--- /dev/null
+++ b/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Installation.html
@@ -0,0 +1,270 @@
+<?xml version="1.0"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta name="generator" content=
+"HTML Tidy for Linux (vers 25 March 2009), see www.w3.org" />
+
+<title>2 Installation</title>
+<meta http-equiv="Content-Type" content=
+"text/html; charset=utf-8" />
+<meta name="generator" content=
+"TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" />
+<meta name="originator" content=
+"TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" />
+<!-- info,2,imgdir:images/,sec-filename,next,index=2,url-enc,html -->
+<meta name="src" content="index.tex" />
+<meta name="date" content="2011-03-20 12:48:00" />
+<link rel="stylesheet" type="text/css" href="index.css" />
+</head>
+
+<body>
+<!--l. 5-->
+
+<p class="noindent"></p>
+
+<div id="container">
+<!--l. 5-->
+
+<div class="crosslinks">
+<p class="noindent">[<a href="Firststeps.html">next</a>] [<a href=
+"Introduction.html">prev</a>] [<a href=
+"Introduction.html#tailIntroduction.html">prev-tail</a>] [<a href=
+"#tailInstallation.html">tail</a>] [<a href=
+"index.html#Installation.html">up</a>]</p>
+</div><!--l. 5-->
+
+<p class="indent"></p>
+
+<div class="chapternumber">
+2
+</div>
+
+<h1><a id="x7-40002" name="x7-40002"></a>Installation</h1><a id=
+"dx7-4001" name="dx7-4001"></a> <!--l. 9-->
+
+<p class="indent">T<sub>E</sub>Xworks is only a text editor; to be
+able to create documents with (L<sup>A</sup>)T<sub>E</sub>X and to
+typeset them to PDF, we also need what is called a
+<em>T<sub>E</sub>X distribution</em><a id="dx7-4002" name=
+"dx7-4002"></a><a id="dx7-4003" name="dx7-4003"></a>. This is a
+collection of programs and other files which will be automatically
+called by T<sub>E</sub>Xworks during its work. Thus, you need to
+install a distribution: we will do that <em>before</em> starting
+T<sub>E</sub>Xworks for the first time, as this way,
+T<sub>E</sub>Xworks will automatically find what it needs.
+<!--l. 11--></p>
+
+<p class="indent"><b>TeX&nbsp;Live</b><a id="dx7-4004" name=
+"dx7-4004"></a> (<a href="http://www.tug.org/texlive/" class=
+"url">http://www.tug.org/texlive/</a>), a combination of teTeX,
+macTeX and XEmTeX, is available for all three operating systems
+(Linux, Mac OS X, Windows). The current version is TeX&nbsp;Live
+2010. Note that you need a reasonably recent version of
+TeX&nbsp;Live (2008 or later at the time of writing) to use all
+features of T<sub>E</sub>Xworks. <!--l. 13--></p>
+
+<p class="indent"></p>
+
+<div class="OSspecific">
+<div class="OSspecificLogo OSLinux"></div>For Linux<a id="dx7-4005"
+name="dx7-4005"></a>: most Linux distributions include a
+T<sub>E</sub>X distribution, but it may not be installed by default
+and you will have to use the Linux package management tools to do
+that. As an alternative to TeX&nbsp;Live, one can use <b>teTeX</b>
+(<a href="http://www.tug.org/teTeX/" class=
+"url">http://www.tug.org/teTeX/</a>, a predecessor system to
+TeX&nbsp;Live.
+</div><!--l. 17-->
+
+<p class="indent"></p>
+
+<div class="OSspecific">
+<div class="OSspecificLogo OSMac"></div>For the Mac<a id="dx7-4006"
+name="dx7-4006"></a>: <b>MacTeX</b><a id="dx7-4007" name=
+"dx7-4007"></a>, a new distribution based on gwTeX and XeTeX, is
+available; see <a href="http://www.tug.org/mactex/" class=
+"url">http://www.tug.org/mactex/</a>.
+</div><!--l. 21-->
+
+<p class="indent"></p>
+
+<div class="OSspecific">
+<div class="OSspecificLogo OSWindows"></div>For Windows<a id=
+"dx7-4008" name="dx7-4008"></a>: a very popular distribution is
+<b>MiKTeX</b><a id="dx7-4009" name="dx7-4009"></a> (<a href=
+"http://www.miktex.org/" class="url">http://www.miktex.org/</a>).
+MikTeX has an update programme, which has also been ported to
+Linux. You can also use the XEmTeX distribution (<a href=
+"http://www.xemtex.org/" class="url">http://www.xemtex.org/</a>).
+</div>
+
+<h3 class="sectionHead"><span class="titlemark">2.1</span> <a id=
+"x7-50002.1" name="x7-50002.1"></a>Under Windows</h3><a id=
+"dx7-5001" name="dx7-5001"></a> <!--l. 27-->
+
+<p class="noindent">Most of the larger T<sub>E</sub>X distributions
+already contain T<sub>E</sub>Xworks as a package. Sometimes, these
+versions even have some distribution-specific enhancements. So, the
+preferred way of installing T<sub>E</sub>Xworks on Windows is to
+use the package manager of your distribution. In this case, you can
+skip the next few paragraphs. Be sure to read the end of this
+section, though, as it provides important information about
+customizing T<sub>E</sub>Xworks to your needs. <!--l. 29--></p>
+
+<p class="indent">If you want to obtain an “official” version,
+obtain T<sub>E</sub>Xworks by downloading the setup from the
+T<sub>E</sub>Xworks web site <a href="htp://tug.org/texworks/"
+class="url">htp://tug.org/texworks/</a> after the installation of
+the T<sub>E</sub>X distribution; you will find binaries for Windows
+at <a href="http://code.google.com/p/texworks/downloads/list"
+class="url">http://code.google.com/p/texworks/downloads/list</a>.
+<!--l. 31--></p>
+
+<p class="indent">Simply install T<sub>E</sub>Xworks by running the
+setup file. During the installation, you will be asked where to
+install the program, if you want to create shortcuts, and if you
+want to always open <span class="path">.tex</span> files with
+T<sub>E</sub>Xworks. There are reasonable default values that
+should work well for most users. <!--l. 33--></p>
+
+<p class="indent">If you want full control over how and where
+T<sub>E</sub>Xworks is put, you can also download the <span class=
+"path">.zip</span> archive from the website and unpack it wherever
+you like. Note that in this case, shortcuts and file associations
+must be created manually. <!--l. 37--></p>
+
+<p class="indent">When you start T<sub>E</sub>Xworks for the first
+time, it creates a folder named <span class=
+"path">TeXworks</span><a id="dx7-5002" name="dx7-5002"></a><a id=
+"dx7-5003" name="dx7-5003"></a> in your home folder<span class=
+"footnote-mark"><a href="index8.html#fn1x3"><sup class=
+"textsuperscript">1</sup></a></span><a id="x7-5004f1" name=
+"x7-5004f1"></a>. This folder will contain some sub-folders for
+auto-completion<a id="dx7-5005" name="dx7-5005"></a>,
+configuration<a id="dx7-5006" name="dx7-5006"></a>,
+dictionaries<a id="dx7-5007" name="dx7-5007"></a>, templates<a id=
+"dx7-5008" name="dx7-5008"></a>, and interface
+translation/localisation<a id="dx7-5009" name="dx7-5009"></a>
+files—we will see these in more detail later.<span class=
+"footnote-mark"><a href="index9.html#fn2x3"><sup class=
+"textsuperscript">2</sup></a></span><a id="x7-5010f2" name=
+"x7-5010f2"></a> <!--l. 40--></p>
+
+<p class="indent">NB. At the time of writing, if <span class=
+"path">&lt;your&nbsp;name&gt;</span> contains any non-ASCII
+characters (for example accented characters), some functions of
+T<sub>E</sub>Xworks may not work correctly. For example, the
+spell-checker and forward/reverse synchronization between the
+source and <span class="path">.pdf</span> will be impaired.</p>
+
+<h3 class="sectionHead"><span class="titlemark">2.2</span> <a id=
+"x7-60002.2" name="x7-60002.2"></a>Under Linux</h3><a id="dx7-6001"
+name="dx7-6001"></a> <!--l. 44-->
+
+<p class="noindent">Several common Linux distributions already have
+packages for T<sub>E</sub>Xworks. They are adequate for most users
+and facilitate installing T<sub>E</sub>Xworks considerably.
+<!--l. 46--></p>
+
+<p class="indent">If your Linux distribution does not provide
+recent, adequate packages, you need to build T<sub>E</sub>Xworks
+from source yourself, which is fairly easy on Linux. After the
+installation of the T<sub>E</sub>X distribution, go to <a href=
+"http://code.google.com/p/texworks/wiki/Building" class=
+"url">http://code.google.com/p/texworks/wiki/Building</a> and
+follow the instructions suitable for your Linux distributions. Also
+see section <a href="CompilingTw.html#x50-57000C">C
+<!--tex4ht:ref: sec.compiling --></a>. <!--l. 48--></p>
+
+<p class="indent">Once the program is installed, start
+T<sub>E</sub>Xworks. The folders <span class=
+"path">.TeXworks</span><a id="dx7-6002" name="dx7-6002"></a> and
+<span class="path">.config/TUG</span><a id="dx7-6003" name=
+"dx7-6003"></a> will be created in your home directory.
+<!--l. 50--></p>
+
+<p class="noindent"></p>
+
+<h3 class="sectionHead"><span class="titlemark">2.3</span> <a id=
+"x7-70002.3" name="x7-70002.3"></a>Under Mac OS X</h3><a id=
+"dx7-7001" name="dx7-7001"></a> <!--l. 52-->
+
+<p class="noindent">MacTeX 2010 already contains
+T<sub>E</sub>Xworks as a package. So, the preferred way of
+installing T<sub>E</sub>Xworks on Windows is to use the package
+manager of your distribution. In this case, you can skip the next
+few paragraphs. Be sure to read the end of this section, though, as
+it provides important information about customizing
+T<sub>E</sub>Xworks to your needs. <!--l. 54--></p>
+
+<p class="indent">If you want to obtain an “official” version,
+obtain T<sub>E</sub>Xworks by downloading the setup from the
+T<sub>E</sub>Xworks web site <a href="htp://tug.org/texworks/"
+class="url">htp://tug.org/texworks/</a> after the installation of
+the T<sub>E</sub>X distribution; you will find binaries for the Mac
+at <a href="http://code.google.com/p/texworks/downloads/list"
+class="url">http://code.google.com/p/texworks/downloads/list</a>.
+<!--l. 56--></p>
+
+<p class="indent">You need to get <span class=
+"path">TeXworks-Mac-0.3r567.zip</span><span class=
+"footnote-mark"><a href="index10.html#fn3x3"><sup class=
+"textsuperscript">3</sup></a></span><a id="x7-7002f3" name=
+"x7-7002f3"></a> which contains everything you need.
+<!--l. 58--></p>
+
+<p class="indent">It is a standalone <tt>.app</tt> package that
+does not require any Qt files installed into <span class=
+"path">/Library/Frameworks</span>, or other libraries into
+<span class="path">/usr/local/lib</span>. Just copy the
+<span class="path">.app</span> anywhere you like and run it.
+<!--l. 60--></p>
+
+<p class="indent">On Mac OS X, the T<sub>E</sub>Xworks
+resource<a id="dx7-7003" name="dx7-7003"></a> folder will be
+created in your <span class="path">Library</span> folder
+(<span class="path">~/Library/.TeXworks/</span>), inside your home
+directory. Preferences are stored in <span class=
+"path">~/Library/Preferences/org.tug.TeXworks.plist</span> which
+you can delete if you ever suspect it is causing problems.</p>
+
+<h3 class="sectionHead"><span class="titlemark">2.4</span> <a id=
+"x7-80002.4" name="x7-80002.4"></a>Ready!</h3><!--l. 67-->
+
+<p class="noindent">Finally, some files may need to be added to the
+“personal” files that T<sub>E</sub>Xworks creates. As the exact
+location of these dependends on your platform, this will be
+referred to as <span class=
+"path">&lt;home&gt;/TeXworks</span><a id="dx7-8001" name=
+"dx7-8001"></a> or the <b>T<sub>E</sub>Xworks resource folder</b>
+later in this manual. On Linux, this is <span class=
+"path">~/.TeXworks</span>, on Windows XP it is <span class=
+"path">C:\Documents&nbsp;and&nbsp;Settings\&lt;your&nbsp;name&gt;\TeXworks</span>,
+on Windows Vista/7 it is <span class=
+"path">C:\Users\&lt;your&nbsp;name&gt;\TeXworks</span>, and on the
+Mac it is <span class="path">~/Library/.TeXworks/</span>,
+<!--l. 69--></p>
+
+<p class="indent">After installation and first run, have a look in
+the sub-folders of the T<sub>E</sub>Xworks resource folder and
+delete any <span class="path">qt_temp.xxxx</span> files; they are
+temporary files left behind and could interfere with the normal
+ones, which are installed in the same folder, later on.
+<!--l. 5--></p>
+
+<div class="crosslinks">
+<p class="noindent">[<a href="Firststeps.html">next</a>] [<a href=
+"Introduction.html">prev</a>] [<a href=
+"Introduction.html#tailIntroduction.html">prev-tail</a>] [<a href=
+"Installation.html">front</a>] [<a href=
+"index.html#Installation.html">up</a>]</p>
+</div><!--l. 5-->
+
+<p class="indent"><a id="tailInstallation.html" name=
+"tailInstallation.html"></a></p>
+</div>
+</body>
+</html>