diff options
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.html | 121 |
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"> </span><span class= "ec-lmtt-10x-x-109"> \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"><home>\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"> </span><span class= "ec-lmtt-10x-x-109"> \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"> </span><span class= "ec-lmtt-10x-x-109"> ?</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> |