summaryrefslogtreecommitdiff
path: root/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Firststeps.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Firststeps.html')
-rw-r--r--Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Firststeps.html121
1 files changed, 75 insertions, 46 deletions
diff --git a/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Firststeps.html b/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Firststeps.html
index 79da8750484..e3e880299a0 100644
--- a/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Firststeps.html
+++ b/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Firststeps.html
@@ -16,7 +16,7 @@
"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" />
+<meta name="date" content="2011-05-26 18:30:00" />
<link rel="stylesheet" type="text/css" href="index.css" />
<style type="text/css" xml:space="preserve">
/*<![CDATA[*/
@@ -54,7 +54,7 @@
<p class="indent">Let’s now see how to create a first document: for
this you’ll need to type some text in the editor window of
T<sub>E</sub>Xworks. (L<sup>A</sup>)T<sub>E</sub>X is <em>not</em>
-a WYSIWYG<a id="dx11-9001" name="dx11-9001"></a><span class=
+WYSIWYG<a id="dx11-9001" name="dx11-9001"></a><span class=
"footnote-mark"><a href="index12.html#fn1x4"><sup class=
"textsuperscript">1</sup></a></span><a id="x11-9002f1" name=
"x11-9002f1"></a> software, so you’ll have to type the text and the
@@ -107,17 +107,24 @@ functions: New document, Open, Save | Undo, Redo | Cut, Copy, Paste
"pict" /></p>
</div><!--l. 40-->
+<p class="indent">Even though they are not looking like real
+buttons, the widgets in the status bar can be clicked. The widgets
+showing the current position (line or page, respectively), for
+example, open a dialog to enter a line or page to jump to when
+clicked. The other widgets typically open contextual menus where
+some settings can be changed. <!--l. 42--></p>
+
<p class="noindent"></p>
<h3 class="sectionHead"><span class="titlemark">3.2</span> <a id=
"x11-110003.2" name="x11-110003.2"></a>Creating a document</h3>
-<!--l. 42-->
+<!--l. 44-->
<p class="noindent"></p>
<h4 class="subsectionHead"><span class="titlemark">3.2.1</span>
<a id="x11-120003.2.1" name="x11-120003.2.1"></a>Writing the
-document</h4><!--l. 44-->
+document</h4><!--l. 46-->
<p class="noindent">As an example of the use of
T<sub>E</sub>Xworks, we will work with
@@ -131,13 +138,13 @@ non-Latin alphabets, etc.—the X<sub>E</sub>T<sub>E</sub>X system is
very powerful.<span class="footnote-mark"><a href=
"index14.html#fn3x4"><sup class=
"textsuperscript">3</sup></a></span><a id="x11-12003f3" name=
-"x11-12003f3"></a> <!--l. 46--></p>
+"x11-12003f3"></a> <!--l. 48--></p>
-<p class="indent">Let’s create now our first document<a id=
-"dx11-12004" name="dx11-12004"></a>. Enter the following text
-exactly as shown. To show some of the features of
+<p class="indent">Let’s create our first document<a id="dx11-12004"
+name="dx11-12004"></a> now. Enter the following text exactly as
+shown. To show some of the features of
T<sub>E</sub>Xworks/L<sup>A</sup>T<sub>E</sub>X, it is in French
-intentionally. <!--l. 48--></p>
+intentionally. <!--l. 50--></p>
<p class="indent"></p>
@@ -215,7 +222,7 @@ intentionally. <!--l. 48--></p>
<a id="x11-12042r19" name="x11-12042r19"></a><span class=
"ec-lmtt-10x-x-109">&nbsp;</span><span class=
"ec-lmtt-10x-x-109">&nbsp;\end{document}</span>
-</div><!--l. 70-->
+</div><!--l. 72-->
<p class="indent">Save the file in a folder for test documents
(e.g., <span class="path">&lt;home&gt;\TeXworks_tests</span>); call
@@ -225,7 +232,7 @@ name="dx11-12043"></a>.</p>
<h4 class="subsectionHead"><span class="titlemark">3.2.2</span>
<a id="x11-130003.2.2" name="x11-130003.2.2"></a>Typesetting the
-document and viewing it</h4><!--l. 74-->
+document and viewing it</h4><!--l. 76-->
<p class="noindent">Next we start typesetting<a id="dx11-13001"
name="dx11-13001"></a><span class="footnote-mark"><a href=
@@ -236,7 +243,7 @@ name="dx11-13001"></a><span class="footnote-mark"><a href=
"keystroke">Ctrl</span><span class="keystroke">T</span><a id=
"dx11-13003" name="dx11-13003"></a> (Mac OS X: <span class=
"keystroke"><img src="images/MacCmdKey.png" alt=
-"pict" /></span><span class="keystroke">T</span>). <!--l. 77--></p>
+"pict" /></span><span class="keystroke">T</span>). <!--l. 79--></p>
<p class="indent">A new panel opens between the typing area and the
status bar: the <em>output panel<a id="dx11-13004" name=
@@ -252,13 +259,13 @@ appear; in this new window, the <em>Preview window<a id=
"dx11-13008"></a>, you can see a page with a title “Premier
document” followed by the name of the author “Un TeXnicien”, both
centred, the text “Voici un texte accentué en français !”, and a
-page number at the bottom centre. <!--l. 80--></p>
+page number at the bottom centre. <!--l. 82--></p>
<p class="indent">Notice that the mouse cursor is like a magnifier
in the new window. If you press (and hold) the left button of the
mouse you can see the text under the magnifier much bigger (it is a
magnifier, isn’t it!); you can move the magnifier and so inspect
-the text in detail. <!--l. 82--></p>
+the text in detail. <!--l. 84--></p>
<p class="indent">To go back to the source, you can just click in
its window or better use <span class=
@@ -273,7 +280,7 @@ specific location in the output from the source or vice versa.</p>
<h4 class="subsectionHead"><span class="titlemark">3.2.3</span>
<a id="x11-140003.2.3" name="x11-140003.2.3"></a>The work of
-L<sup>A</sup>T<sub>E</sub>X</h4><!--l. 86-->
+L<sup>A</sup>T<sub>E</sub>X</h4><!--l. 88-->
<p class="noindent">Let’s shortly analyse the result to understand
what L<sup>A</sup>T<sub>E</sub>X did and why, now. Introductions
@@ -286,11 +293,11 @@ T<sub>E</sub>X distribution, and is also available from CTAN<a id=
"dx11-14002" name="dx11-14002"></a>.<span class=
"footnote-mark"><a href="index18.html#fn7x4"><sup class=
"textsuperscript">7</sup></a></span><a id="x11-14003f7" name=
-"x11-14003f7"></a> <!--l. 88--></p>
+"x11-14003f7"></a> <!--l. 90--></p>
<p class="indent">First, we ask to create a document of the
<em>article</em> class: this defines the global layout of the
-document. <!--l. 90--></p>
+document. <!--l. 92--></p>
<p class="indent">Next, we say that the input document (the source)
is saved with the Unicode encoding <em>utf-8<a id="dx11-14004"
@@ -306,18 +313,18 @@ should follow the French rules using the <b><span class=
"textsuperscript">8</sup></a></span><a id="x11-14006f8" name=
"x11-14006f8"></a> Those general instructions for the work are done
by packages<a id="dx11-14007" name="dx11-14007"></a> called with
-options. <!--l. 92--></p>
+options. <!--l. 94--></p>
<p class="indent">Lastly, we finish the declaration part of the
document, the <em>preamble</em><a id="dx11-14008" name=
"dx11-14008"></a>, giving the title, the author, and the date of
-the document; here we specify no date. <!--l. 94--></p>
+the document; here we specify no date. <!--l. 96--></p>
<p class="indent">Next comes the body of the document, which
describes the actual content, between the lines <span class=
"obeylines-h verb ec-lmtt-12">\begin{document}</span> and
<span class="obeylines-h verb ec-lmtt-12">\end{document}</span>
-(these are L<sup>A</sup>T<sub>E</sub>X commands). <!--l. 96--></p>
+(these are L<sup>A</sup>T<sub>E</sub>X commands). <!--l. 98--></p>
<p class="indent">Let’s do some experiments to show the effect of
these instructions. For this, we put a % in front of the
@@ -326,7 +333,7 @@ comment<a id="dx11-14009" name="dx11-14009"></a>, which will be
ignored by L<sup>A</sup>T<sub>E</sub>X.<span class=
"footnote-mark"><a href="index20.html#fn9x4"><sup class=
"textsuperscript">9</sup></a></span><a id="x11-14010f9" name=
-"x11-14010f9"></a> <!--l. 98--></p>
+"x11-14010f9"></a> <!--l. 100--></p>
<p class="indent">Comment out the line <span class=
"obeylines-h verb ec-lmtt-12">\usepackage[utf8]{inputenc}</span>,
@@ -337,7 +344,7 @@ addition, you also comment out the line <span class=
L<sup>A</sup>T<sub>E</sub>X will give an error. Just hit
<span class="keystroke"><img src="images/index2x.png" alt="←'"
class="hookleftarrow" /></span>to continue the typesetting.
-<!--l. 103--></p>
+<!--l. 105--></p>
<p class="indent">After these experiments, let’s modify the text as
follows:</p>
@@ -465,7 +472,7 @@ follows:</p>
"ec-lmtt-10x-x-109">&nbsp;</span><span class=
"ec-lmtt-10x-x-109">&nbsp;\end{document}</span>
</div>Redo the previous experiments and observe the changes which
-appear. <!--l. 124-->
+appear. <!--l. 126-->
<p class="indent">Note that entering only one carriage return
doesn’t create a new paragraph. In L<sup>A</sup>T<sub>E</sub>X, one
@@ -475,34 +482,36 @@ the lines created with carriage return, not the wrapped lines.</p>
<h3 class="sectionHead"><span class="titlemark">3.3</span> <a id=
"x11-150003.3" name="x11-150003.3"></a>And when errors
-occur?</h3><a id="dx11-15001" name="dx11-15001"></a> <!--l. 128-->
+occur?</h3><a id="dx11-15001" name="dx11-15001"></a> <!--l. 130-->
<p class="noindent">When you create a document for typesetting with
L<sup>A</sup>T<sub>E</sub>X, you cannot avoid making mistakes:
forgetting a closing brace or an <span class=
-"obeylines-h verb ec-lmtt-12">\end{}</span> command to close an
+"obeylines-h verb ec-lmtt-12">\end{}</span> to close an
environment, using mathematical commands without switching to
mathematical mode, etc. When you compile and there is an error,
L<sup>A</sup>T<sub>E</sub>X stops, giving you a chance to deal with
the problem. This is shown by the stopping of the scrolling action
in the output panel, and an error message being displayed, with
L<sup>A</sup>T<sub>E</sub>X waiting for an instruction to know what
-it should do. One sees the <em>typing cursor<a id="dx11-15002"
-name="dx11-15002"></a></em> in the line between the output panel
-and the status bar: the <em>console bar<a id="dx11-15003" name=
-"dx11-15003"></a></em>.</p>
+it should do.</p>
<div class="center">
-<!--l. 130-->
+<!--l. 132-->
-<p class="noindent"><!--l. 131--></p>
+<p class="noindent"><!--l. 133--></p>
<p class="noindent"><img src="images/consoleOutput.png" alt=
"pict" /></p>
-</div><!--l. 134-->
+</div><!--l. 136-->
+
+<p class="indent">One sees the <em>typing cursor<a id="dx11-15002"
+name="dx11-15002"></a></em> in the line between the output panel
+and the status bar: the <em>console bar<a id="dx11-15003" name=
+"dx11-15003"></a></em>. <!--l. 138--></p>
<p class="indent">The error message is on many lines, for example
-like this: <!--l. 137--></p>
+like this: <!--l. 141--></p>
<p class="indent"></p>
@@ -576,7 +585,7 @@ like this: <!--l. 137--></p>
<a id="x11-15011r4" name="x11-15011r4"></a><span class=
"ec-lmtt-10x-x-109">&nbsp;</span><span class=
"ec-lmtt-10x-x-109">&nbsp;?</span>
-</div><!--l. 144-->
+</div><!--l. 148-->
<p class="indent">L<sup>A</sup>T<sub>E</sub>X says that it doesn’t
recognize the command name, sometimes suggests to see the manual or
@@ -590,7 +599,7 @@ number where it noticed the error<span class=
the cut of the line (here at <span class=
"obeylines-h verb ec-lmtt-12">\veb</span>). Finally, it shows that
it waits for an action from us by displaying a single question
-mark. <!--l. 146--></p>
+mark. <!--l. 150--></p>
<p class="indent">There are different possible actions:</p>
@@ -621,7 +630,7 @@ L<sup>A</sup>T<sub>E</sub>X never changes that.</li>
"keystroke"><img src="images/index8x.png" alt="←'" class=
"hookleftarrow" /></span>to stop compilation. This is the
traditional (L<sup>A</sup>)T<sub>E</sub>X way to kill a typesetting
-process. <!--l. 153-->
+process. <!--l. 157-->
<p class="noindent">We can also kill the typesetting by repeating
the action used to start it: the green typesetting button will have
@@ -634,7 +643,7 @@ that button or by hitting <span class=
L<sup>A</sup>T<sub>E</sub>X process is terminated. The output panel
is still visible and so one can still see the error message.</p>
</li>
-</ul><!--l. 157-->
+</ul><!--l. 161-->
<p class="indent">You should note that sometimes an error appears
far from its actual position. For example, when opening an
@@ -643,7 +652,7 @@ see the error before it encounters another end of environment
without closing of the first one. The error is often only picked up
at the <span class=
"obeylines-h verb ec-lmtt-12">\end{document}</span> command, which
-shows that another environment was not closed! <!--l. 159--></p>
+shows that another environment was not closed! <!--l. 163--></p>
<p class="indent">Sometimes, an error still occurs during
subsequent runs of (L<sup>A</sup>)T<sub>E</sub>X even after it was
@@ -654,7 +663,27 @@ Therefore, it is advisable to remove those files after fixing an
error. T<sub>E</sub>Xworks provides a command to facilitate
this—see section <a href=
"GoingfurtherOthertools.html#x31-360005.6">5.6
-<!--tex4ht:ref: sec:remove-aux-files --></a>. <!--l. 161--></p>
+<!--tex4ht:ref: sec:remove-aux-files --></a>. <!--l. 165--></p>
+
+<p class="indent">After an error occurred, the output panel remains
+open—even after consecutive typesetting runs—to help you fix the
+problem (which can sometimes take several attempts and restarts of
+(L<sup>A</sup>)T<sub>E</sub>X). Once all problems are solved, you
+can close the panel by the <em class="c8">Windows</em><span class=
+"lmsy-10x-x-120">→</span><em class="c8">Hide Output
+Panel</em><a id="dx11-15013" name="dx11-15013"></a> menu item. As
+an alternative, you can also configure to output panel to hide
+automatically as soon as the typesetting process finishes
+successfully by setting <em class="c8">Edit</em> <span class=
+"lmsy-10x-x-120">→</span><em class=
+"c8">Preferences…</em><span class=
+"lmsy-10x-x-120">→</span><em class=
+"c8">Typesetting</em><span class="lmsy-10x-x-120">→</span><em class="c8">Hide
+output panel</em> to <em>On success</em>. Since one can easily
+overlook other problems in the document (e.g., undefined
+references) that do not cause (L<sup>A</sup>)T<sub>E</sub>X to
+fail, this option is only recommended to expert users.
+<!--l. 167--></p>
<p class="indent">To help you in finding and fixing error (at least
if you are using L<sup>A</sup>T<sub>E</sub>X), T<sub>E</sub>Xworks
@@ -663,13 +692,13 @@ other noteworthy messages from the console output and presents them
to you in a simple, tabular form.</p>
<div class="center">
-<!--l. 163-->
+<!--l. 169-->
-<p class="noindent"><!--l. 164--></p>
+<p class="noindent"><!--l. 170--></p>
<p class="noindent"><img src="images/errorParsingScript.png" alt=
"pict" /></p>
-</div><!--l. 167-->
+</div><!--l. 173-->
<p class="indent">Here, you see a list of
L<sup>A</sup>T<sub>E</sub>X messages, color-coded and sorted by
@@ -682,7 +711,7 @@ output telling you what the error was. Moreover, the filename is a
link which will take you to the file (and, if a line number could
be determined, also the line) where L<sup>A</sup>T<sub>E</sub>X
reported the error. Hopefully, you can quickly fix any errors that
-may occur this way. <!--l. 169--></p>
+may occur this way. <!--l. 175--></p>
<p class="indent">In case you are not using
L<sup>A</sup>T<sub>E</sub>X, this script may be of little use,
@@ -694,7 +723,7 @@ this case, you can simply disable the error parsing hook script
<h3 class="sectionHead"><span class="titlemark">3.4</span> <a id=
"x11-160003.4" name="x11-160003.4"></a>Changing T<sub>E</sub>Xworks
parameters for convenience</h3><a id="dx11-16001" name=
-"dx11-16001"></a> <!--l. 174-->
+"dx11-16001"></a> <!--l. 180-->
<p class="noindent">If the default font<a id="dx11-16002" name=
"dx11-16002"></a> of the editor doesn’t suit you, it is possible to
@@ -702,12 +731,12 @@ change it from <em class="c8">Format</em><span class=
"lmsy-10x-x-120">→</span><em class="c8">Font…</em> by selecting a
new one in the dialogue box which appears. This change will apply
only to the current window, and until T<sub>E</sub>Xworks is
-restarted. <!--l. 176--></p>
+restarted. <!--l. 182--></p>
<p class="indent">From the <em class="c8">Typeset</em> menu or from
the drop-down on the <em class="c8">Typesetting tool bar</em>, you
can change the compilation format. Again this change will only be
-temporary and for the current document. <!--l. 178--></p>
+temporary and for the current document. <!--l. 184--></p>
<p class="indent">To have permanent changes, you need to change the
<em>preferences<a id="dx11-16003" name="dx11-16003"></a></em>