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.html108
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&nbsp;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&nbsp;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&nbsp;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
&amp; 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\&lt;your&nbsp;name&gt;\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">&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
@@ -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&nbsp;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">&lt;resources&gt;</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&nbsp;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 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\&lt;your&nbsp;name&gt;\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&nbsp;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=