diff options
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.html | 270 |
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 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 Live +2010. Note that you need a reasonably recent version of +TeX 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 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 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"><your name></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"><home>/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 and Settings\<your name>\TeXworks</span>, +on Windows Vista/7 it is <span class= +"path">C:\Users\<your name>\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> |