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 | 108 |
1 files changed, 50 insertions, 58 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 index 1b8c360ebb5..8656752777d 100644 --- a/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Installation.html +++ b/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Installation.html @@ -41,12 +41,12 @@ "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>TE 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 +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> @@ -54,24 +54,22 @@ T<sub>E</sub>Xworks will automatically find what it needs. "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). Note that you need a reasonably recent -version of TeX Live (2012 or later at the time of writing) to -use all features of T<sub>E</sub>Xworks. <!--l. 13--></p> +(Linux, macOS, Windows). <!--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 TE X -distribution, but it may not be installed by default and you will -have to use the Linux package management tools to do that. -Alternatively, you can also download and install TeX Live -directly from <a href="http://www.tug.org/texlive/" class= -"url">http://www.tug.org/texlive/</a>. +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. Alternatively, you can also download and install +TeX Live directly from <a href="http://www.tug.org/texlive/" +class="url">http://www.tug.org/texlive/</a>. </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 +"dx7-4007"></a>, a 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--> @@ -82,22 +80,21 @@ available; see <a href="http://www.tug.org/mactex/" class= <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>). +Linux. </div><!--l. 25--> <p class="indent">For details on portable usage, and changing local configuration locations, please see the section Portable Usage & Changing the Configuration – section <a href= -"GoingfurtherOthertools.html#x30-370005.7">5.7 +"GoingfurtherOthertools.html#x29-370005.7">5.7 <!--tex4ht:ref: sec.portable_configuration --></a> (on page -<a href="GoingfurtherOthertools.html#x30-370005.7">44 +<a href="GoingfurtherOthertools.html#x29-370005.7">44 <!--tex4ht:ref: sec.portable_configuration --></a>).</p> <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. 29--> -<p class="noindent">Most of the larger TE X distributions already -contain T<sub>E</sub>Xworks as a package. Sometimes, these versions -even have some distribution-specific enhancements. So, the +<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 @@ -107,7 +104,7 @@ customizing T<sub>E</sub>Xworks to your needs. <!--l. 31--></p> obtain T<sub>E</sub>Xworks by downloading the setup from the T<sub>E</sub>Xworks web site <a href="http://tug.org/texworks/" class="url">http://tug.org/texworks/</a> after the installation of -the TE X distribution. <!--l. 33--></p> +the T<sub>E</sub>X distribution. <!--l. 33--></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 @@ -121,21 +118,18 @@ you like. Note that in this case, shortcuts and file associations must be created manually. <!--l. 39--></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> +"path">C:\Users\<your name>\AppData\Roaming\TUG\TeXworks</span><a id="dx7-5002" +name="dx7-5002"></a>. This folder will contain some sub-folders for +auto-completion<a id="dx7-5003" name="dx7-5003"></a>, +configuration<a id="dx7-5004" name="dx7-5004"></a>, +dictionaries<a id="dx7-5005" name="dx7-5005"></a>, templates<a id= +"dx7-5006" name="dx7-5006"></a>, and interface +translation/localisation<a id="dx7-5007" name="dx7-5007"></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. 42--></p> -<p class="indent">NB. At the time of writing, if <span class= +"footnote-mark"><a href="index8.html#fn1x3"><sup class= +"textsuperscript">1</sup></a></span><a id="x7-5008f1" name= +"x7-5008f1"></a> <!--l. 42--></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 @@ -151,38 +145,37 @@ and facilitate installing T<sub>E</sub>Xworks considerably. <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 TE X distribution, go to <a href= +installation of the T<sub>E</sub>X distribution, go to <a href= "https://github.com/TeXworks/texworks/wiki/Building" class= "url">https://github.com/TeXworks/texworks/wiki/Building</a> and follow the instructions suitable for your Linux distributions. Also -see section <a href="CompilingTw.html#x50-57000C">C +see section <a href="CompilingTw.html#x50-58000C">C <!--tex4ht:ref: sec.compiling --></a>. <!--l. 50--></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. 52--></p> +"path">.local/share/TUG/TeXworks</span><a id="dx7-6002" name= +"dx7-6002"></a> and <span class="path">.config/TUG</span> will be +created in your home directory. <!--l. 52--></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. 54--> +"x7-70002.3" name="x7-70002.3"></a>Under macOS</h3><a id="dx7-7001" +name="dx7-7001"></a> <!--l. 54--> <p class="noindent">If you want to obtain an “official” version, obtain T<sub>E</sub>Xworks by downloading the archive from the T<sub>E</sub>Xworks web site <a href="http://tug.org/texworks/" class="url">http://tug.org/texworks/</a> after the installation of -the TE X distribution. <!--l. 56--></p> +the T<sub>E</sub>X distribution. <!--l. 56--></p> <p class="indent">It comes as 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. 58--></p> -<p class="indent">On Mac OS X, the T<sub>E</sub>Xworks -resource<a id="dx7-7002" name="dx7-7002"></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= +<p class="indent">On macOS, the T<sub>E</sub>Xworks resource<a id= +"dx7-7002" name="dx7-7002"></a> folder will be created in your +<span class="path">Library</span> folder (<span class= +"path">~/Library/Application Support/TUG/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. <!--l. 61--></p> @@ -194,12 +187,11 @@ you can delete if you ever suspect it is causing problems. location of these depends on your platform, this will be referred to as <span class="path"><resources></span><a id="dx7-8001" name="dx7-8001"></a> or the <b>T<sub>E</sub>Xworks resource -folder</b> throughout 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 Mac -OS X it is <span class="path">~/Library/TeXworks/</span> by +folder</b> throughout this manual. On Windows, this is <span class= +"path">C:\Users\<your name>\AppData\Roaming\TUG\TeXworks</span>, +on Linux it is <span class="path">.local/share/TUG/TeXworks</span>, +and on macOS it is <span class= +"path">~/Library/Application Support/TUG/TeXworks</span> by default. The easiest way to locate this folder in recent versions of T<sub>E</sub>Xworks is to use the <em class= "c11">Help</em><span class="lmsy-10x-x-120">→</span><em class= |