diff options
author | Akira Kakuto <kakuto@fuk.kindai.ac.jp> | 2024-02-12 09:16:07 +0000 |
---|---|---|
committer | Akira Kakuto <kakuto@fuk.kindai.ac.jp> | 2024-02-12 09:16:07 +0000 |
commit | e7711759f3a0b332136a6977ef413e26d5ae5d92 (patch) | |
tree | d35037447cd79a4bc1900fd3dc006221d0655e47 /Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Firststeps.html | |
parent | 981938bd7ed6947d169d1e8094d3a62c0fc2de33 (diff) |
texworks 0.6.9
git-svn-id: svn://tug.org/texlive/trunk@69823 c570f23f-e606-0410-a88d-b1316a301751
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 | 670 |
1 files changed, 338 insertions, 332 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 434221b00f5..e8ebb423868 100644 --- a/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Firststeps.html +++ b/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/Firststeps.html @@ -9,15 +9,22 @@ <meta http-equiv="Content-Type" content= "text/html; charset=utf-8" /> <meta name="generator" content= -"TeX4ht (http://www.tug.org/tex4ht/)" /> +"TeX4ht (https://tug.org/tex4ht/)" /> <meta name="originator" content= -"TeX4ht (http://www.tug.org/tex4ht/)" /> -<!-- info,2,imgdir:images/,sec-filename,next,index=2,url-enc,html --> +"TeX4ht (https://tug.org/tex4ht/)" /> +<!-- info,2,sec-filename,next,index=2,url-enc,charset=utf-8,html --> <meta name="src" content="index.tex" /> <link rel="stylesheet" type="text/css" href="index.css" /> <style type="text/css" xml:space="preserve"> /*<![CDATA[*/ - em.c8 {font-weight: bold} + img.c15 {width:2.5ex} + img.c14 {width:38.3ex} + img.c13 {width:2.29ex} + img.c12 {width:80ex} + img.c11 {width:34.32ex} + em.c10 {font-weight: bold} + img.c9 {width:1.82ex} + img.c8 {width:18.99ex} /*]]>*/ </style> </head> @@ -52,7 +59,7 @@ instructions for formatting it and you’ll see the result only after quickly gets used to it and it is well worth the effort.</p> <h3 class="sectionHead"><span class="titlemark">3.1</span> <a id= "x9-100003.1" name="x9-100003.1"></a>Interface summary</h3><a id= -"dx9-10001" name="dx9-10001"></a> <!--l. 15--> +"dx9-10001" name="dx9-10001"></a> <!--l. 12--> <p class="noindent">When one opens the editor, it shows a very sparse interface: a title bar, a menu bar, two small toolbars<a id= "dx9-10002" name="dx9-10002"></a>, a large typing zone (white) and, @@ -61,49 +68,48 @@ at the bottom, a status bar. We are in the <em>source/editor<a id= typeset the document previously, the resulting <span class= "path">.pdf</span> will be shown on the right hand side in the <em>preview</em><a id="dx9-10004" name="dx9-10004"></a> window.</p> -<div class="wrapfig-l"><img src="images/toolbar1.png" alt= -"pict" /></div><!--l. 24--> +<div class="wrapfig-l"><img src="images//toolbar1.png" alt="PIC" +class="c8" /></div><!--l. 19--> <p class="noindent">The first toolbar has a button to typeset and an drop-down menu to choose the format for typesetting (we’ll choose <span class="obeylines-h verb ec-lmtt-12">pdfLaTeX</span>). Knowing that the keyboard shortcut for typesetting is <span class= "keystroke">Ctrl</span><span class="keystroke">T</span> (macOS: -<span class="keystroke"><img src="images/MacCmdKey.png" alt= -"pict" /></span><span class="keystroke">T</span>) and that we +<span class="keystroke"><img src="images//MacCmdKey-.png" alt="PIC" +class="c9" /></span><span class="keystroke">T</span>) and that we almost never change the format, we could even hide this toolbar. The selection of a format for compiling can also be changed through -the <em class="c8">Typeset</em><a id="dx9-10005" name= +the <em class="c10">Typeset</em><a id="dx9-10005" name= "dx9-10005"></a> menu.</p> -<div class="wrapfig-l"><img src="images/toolbar2.png" alt= -"pict" /></div><!--l. 34--> +<div class="wrapfig-l"><img src="images//toolbar2.png" alt="PIC" +class="c11" /></div><!--l. 26--> <p class="noindent">The second toolbar provides the standard functions: New document, Open, Save | Undo, Redo | Cut, Copy, Paste | Search, Replace.</p> <div class="center"> -<!--l. 36--> -<p class="noindent"><!--l. 37--></p> -<p class="noindent"><img src="images/interface-summary.png" alt= -"pict" /></p> -</div><!--l. 40--> +<!--l. 28--> +<p class="noindent"><!--l. 29--></p> +<p class="noindent"><img src="images//interface-summary-.png" alt= +"PIC" class="c12" /></p> +</div><!--l. 32--> <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> +some settings can be changed. <!--l. 34--></p> <p class="noindent"></p> <h3 class="sectionHead"><span class="titlemark">3.2</span> <a id= "x9-110003.2" name="x9-110003.2"></a>Creating a document</h3> -<!--l. 44--> +<!--l. 36--> <p class="noindent"></p> <h4 class="subsectionHead"><span class="titlemark">3.2.1</span> <a id="x9-120003.2.1" name="x9-120003.2.1"></a>Writing the -document</h4><!--l. 46--> +document</h4><!--l. 38--> <p class="noindent">As an example of the use of -T<sub>E</sub>Xworks, we will work with -L<sup>A</sup>T<sub>E</sub>X<a id="dx9-12001" name="dx9-12001"></a>, -but any other T<sub>E</sub>X system is possible. In particular, if -you need to use some special fonts<span class= +T<sub>E</sub>Xworks, we will work with LaTeX<a id="dx9-12001" name= +"dx9-12001"></a>, but any other T<sub>E</sub>X system is possible. +In particular, if you need to use some special fonts<span class= "footnote-mark"><a href="index11.html#fn2x4"><sup class= "textsuperscript">2</sup></a></span><a id="x9-12002f2" name= "x9-12002f2"></a>—a mandatory font for an official template, @@ -111,64 +117,56 @@ non-Latin alphabets, etc.—the X<sub>E</sub>T<sub>E</sub>X system is very powerful.<span class="footnote-mark"><a href= "index12.html#fn3x4"><sup class= "textsuperscript">3</sup></a></span><a id="x9-12003f3" name= -"x9-12003f3"></a> <!--l. 48--></p> +"x9-12003f3"></a> <!--l. 40--></p> <p class="indent">Let’s create our first document<a id="dx9-12004" name="dx9-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. 50--></p> +shown. To show some of the features of T<sub>E</sub>Xworks/LaTeX, +it is in French intentionally. <!--l. 42--></p> <p class="indent"></p> <div class="example"> -<div class="fancyvrb" id="fancyvrb2"> -<a id="x9-12006r1" name="x9-12006r1"></a><span class= -"ec-lmtt-10x-x-109">\documentclass{article}</span><br class= -"fancyvrb" /> -<a id="x9-12008r2" name="x9-12008r2"></a><br class="fancyvrb" /> +<pre class="fancyvrb" id="fancyvrb2" xml:space="preserve"><a id= +"x9-12006r1" name="x9-12006r1"></a><span class= +"ec-lmtt-10x-x-109">\documentclass{article}</span> +<a id="x9-12008r2" name="x9-12008r2"></a> <a id="x9-12010r3" name="x9-12010r3"></a><span class= -"ec-lmtt-10x-x-109">\usepackage[utf8]{inputenc}</span><br class= -"fancyvrb" /> +"ec-lmtt-10x-x-109">\usepackage[utf8]{inputenc}</span> <a id="x9-12012r4" name="x9-12012r4"></a><span class= -"ec-lmtt-10x-x-109">\usepackage[T1]{fontenc}</span><br class= -"fancyvrb" /> +"ec-lmtt-10x-x-109">\usepackage[T1]{fontenc}</span> <a id="x9-12014r5" name="x9-12014r5"></a><span class= -"ec-lmtt-10x-x-109">\usepackage{geometry}</span><br class= -"fancyvrb" /> +"ec-lmtt-10x-x-109">\usepackage{geometry}</span> <a id="x9-12016r6" name="x9-12016r6"></a><span class= -"ec-lmtt-10x-x-109">\geometry{a4paper}</span><br class= -"fancyvrb" /> -<a id="x9-12018r7" name="x9-12018r7"></a><br class="fancyvrb" /> +"ec-lmtt-10x-x-109">\geometry{a4paper}</span> +<a id="x9-12018r7" name="x9-12018r7"></a> <a id="x9-12020r8" name="x9-12020r8"></a><span class= -"ec-lmtt-10x-x-109">\usepackage[frenchb]{babel}</span><br class= -"fancyvrb" /> -<a id="x9-12022r9" name="x9-12022r9"></a><br class="fancyvrb" /> +"ec-lmtt-10x-x-109">\usepackage[frenchb]{babel}</span> +<a id="x9-12022r9" name="x9-12022r9"></a> <a id="x9-12024r10" name="x9-12024r10"></a><span class= "ec-lmtt-10x-x-109">\title{Premier</span><span class= -"ec-lmtt-10x-x-109"> document}</span><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> document}</span> <a id="x9-12026r11" name="x9-12026r11"></a><span class= "ec-lmtt-10x-x-109">\author{Un</span><span class= -"ec-lmtt-10x-x-109"> TeXnicien}</span><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> TeXnicien}</span> <a id="x9-12028r12" name="x9-12028r12"></a><span class= -"ec-lmtt-10x-x-109">\date{}</span><br class="fancyvrb" /> -<a id="x9-12030r13" name="x9-12030r13"></a><br class="fancyvrb" /> +"ec-lmtt-10x-x-109">\date{}</span> +<a id="x9-12030r13" name="x9-12030r13"></a> <a id="x9-12032r14" name="x9-12032r14"></a><span class= -"ec-lmtt-10x-x-109">\begin{document}</span><br class="fancyvrb" /> +"ec-lmtt-10x-x-109">\begin{document}</span> <a id="x9-12034r15" name="x9-12034r15"></a><span class= -"ec-lmtt-10x-x-109">\maketitle</span><br class="fancyvrb" /> -<a id="x9-12036r16" name="x9-12036r16"></a><br class="fancyvrb" /> +"ec-lmtt-10x-x-109">\maketitle</span> +<a id="x9-12036r16" name="x9-12036r16"></a> <a id="x9-12038r17" name="x9-12038r17"></a><span class= "ec-lmtt-10x-x-109">Voici</span><span class= -"ec-lmtt-10x-x-109"> un</span><span class= -"ec-lmtt-10x-x-109"> texte</span><span class= -"ec-lmtt-10x-x-109"> accentu</span><span class= +"ec-lmtt-10x-x-109"> un</span><span class= +"ec-lmtt-10x-x-109"> texte</span><span class= +"ec-lmtt-10x-x-109"> accentu</span><span class= "ec-lmtt-10x-x-109">é</span><span class= -"ec-lmtt-10x-x-109"> en</span><span class= -"ec-lmtt-10x-x-109"> fran</span><span class= -"ec-lmtt-10x-x-109">çais!</span><br class="fancyvrb" /> -<a id="x9-12040r18" name="x9-12040r18"></a><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> en</span><span class= +"ec-lmtt-10x-x-109"> fran</span><span class= +"ec-lmtt-10x-x-109">çais!</span> +<a id="x9-12040r18" name="x9-12040r18"></a> <a id="x9-12042r19" name="x9-12042r19"></a><span class= -"ec-lmtt-10x-x-109">\end{document}</span> -</div> -</div><!--l. 72--> +"ec-lmtt-10x-x-109">\end{document}</span></pre> +</div><!--l. 64--> <p class="indent">Save the file in a folder for test documents (e.g., <span class="path"><home>\TeXworks_tests</span>); call the file <span class="path">first.tex</span>. Note that it should @@ -176,53 +174,54 @@ have a <span class="path">.tex</span> extension<a id="dx9-12043" name="dx9-12043"></a>.</p> <h4 class="subsectionHead"><span class="titlemark">3.2.2</span> <a id="x9-130003.2.2" name="x9-130003.2.2"></a>Typesetting the -document and viewing it</h4><!--l. 76--> +document and viewing it</h4><!--l. 68--> <p class="noindent">Next we start typesetting<a id="dx9-13001" name="dx9-13001"></a><span class="footnote-mark"><a href= "index13.html#fn4x4"><sup class= "textsuperscript">4</sup></a></span><a id="x9-13002f4" name= "x9-13002f4"></a> by clicking the green button <img src= -"images/iconTypeset.png" alt="pict" /> or by <span class= -"keystroke">Ctrl</span><span class="keystroke">T</span><a id= -"dx9-13003" name="dx9-13003"></a> (macOS: <span class= -"keystroke"><img src="images/MacCmdKey.png" alt= -"pict" /></span><span class="keystroke">T</span>). <!--l. 79--></p> +"images//iconTypeset-.png" alt="PIC" class="c13" /> or by +<span class="keystroke">Ctrl</span><span class= +"keystroke">T</span><a id="dx9-13003" name="dx9-13003"></a> (macOS: +<span class="keystroke"><img src="images//MacCmdKey-.png" alt="PIC" +class="c9" /></span><span class="keystroke">T</span>). +<!--l. 71--></p> <p class="indent">A new panel opens between the typing area and the status bar: the <em>output panel<a id="dx9-13004" name= "dx9-13004"></a></em>, labeled <em>Log<a id="dx9-13005" name= -"dx9-13005"></a></em>; everything L<sup>A</sup>T<sub>E</sub>X is -doing is displayed there<span class="footnote-mark"><a href= +"dx9-13005"></a></em>; everything LaTeX is doing is displayed +there<span class="footnote-mark"><a href= "index14.html#fn5x4"><sup class= "textsuperscript">5</sup></a></span><a id="x9-13006f5" name= -"x9-13006f5"></a>. When L<sup>A</sup>T<sub>E</sub>X finishes this -panel disappears (if there no error occurred) and a new window will -appear; in this new window, the <em>Preview window<a id="dx9-13007" -name="dx9-13007"></a></em><a id="dx9-13008" name="dx9-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 +"x9-13006f5"></a>. When LaTeX finishes this panel disappears (if +there no error occurred) and a new window will appear; in this new +window, the <em>Preview window<a id="dx9-13007" name= +"dx9-13007"></a></em><a id="dx9-13008" name="dx9-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. 82--></p> +centre. <!--l. 74--></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. 84--></p> +the text in detail. <!--l. 76--></p> <p class="indent">To go back to the source, you can just click in its window or better use <span class= "keystroke">Ctrl</span><span class="keystroke">’</span><a id= "dx9-13009" name="dx9-13009"></a> (macOS <span class= -"keystroke"><img src="images/MacCmdKey.png" alt= -"pict" /></span><span class="keystroke">’</span>). This shortcut +"keystroke"><img src="images//MacCmdKey-.png" alt="PIC" class= +"c9" /></span><span class="keystroke">’</span>). This shortcut toggles between the two windows. See also section <a href= -"GoingfurtherOthertools.html#x29-310005.1">5.1 +"GoingfurtherOthertools.html#x29-330005.1">5.1 <!--tex4ht:ref: sec.synctex --></a> to automatically move to a specific location in the output from the source or vice versa.</p> <h4 class="subsectionHead"><span class="titlemark">3.2.3</span> <a id="x9-140003.2.3" name="x9-140003.2.3"></a>The work of -L<sup>A</sup>T<sub>E</sub>X</h4><!--l. 88--> +LaTeX</h4><!--l. 80--> <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 -and full tutorials can be found on the internet: see for example +what LaTeX did and why, now. Introductions and full tutorials can +be found on the internet: see for example <em>lshort</em><span class="footnote-mark"><a href= "index15.html#fn6x4"><sup class= "textsuperscript">6</sup></a></span><a id="x9-14001f6" name= @@ -231,10 +230,10 @@ T<sub>E</sub>X distribution, and is also available from CTAN<a id= "dx9-14002" name="dx9-14002"></a>.<span class= "footnote-mark"><a href="index16.html#fn7x4"><sup class= "textsuperscript">7</sup></a></span><a id="x9-14003f7" name= -"x9-14003f7"></a> <!--l. 90--></p> +"x9-14003f7"></a> <!--l. 82--></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. 92--></p> +document. <!--l. 84--></p> <p class="indent">Next, we say that the input document (the source) is saved with the Unicode encoding <em>utf-8<a id="dx9-14004" name= "dx9-14004"></a><a id="dx9-14005" name="dx9-14005"></a></em> and @@ -249,297 +248,303 @@ package.<span class="footnote-mark"><a href= "textsuperscript">8</sup></a></span><a id="x9-14006f8" name= "x9-14006f8"></a> Those general instructions for the work are done by packages<a id="dx9-14007" name="dx9-14007"></a> called with -options. <!--l. 94--></p> +options. <!--l. 86--></p> <p class="indent">Lastly, we finish the declaration part of the document, the <em>preamble</em><a id="dx9-14008" name= "dx9-14008"></a>, giving the title, the author, and the date of the -document; here we specify no date. <!--l. 96--></p> +document; here we specify no date. <!--l. 88--></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. 98--></p> +(these are LaTeX commands). <!--l. 90--></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 instructions; the % and everything after it will be considered as comment<a id="dx9-14009" name="dx9-14009"></a>, which will be -ignored by L<sup>A</sup>T<sub>E</sub>X.<span class= -"footnote-mark"><a href="index18.html#fn9x4"><sup class= +ignored by LaTeX.<span class="footnote-mark"><a href= +"index18.html#fn9x4"><sup class= "textsuperscript">9</sup></a></span><a id="x9-14010f9" name= -"x9-14010f9"></a> <!--l. 100--></p> +"x9-14010f9"></a> <!--l. 92--></p> <p class="indent">Comment out the line <span class= "obeylines-h verb ec-lmtt-12">\usepackage[utf8]{inputenc}</span>, and typeset the file. You should see that the accented characters are now displayed incorrectly in the preview window. If, in addition, you also comment out the line <span class= "obeylines-h verb ec-lmtt-12">\usepackage[frenchb]{babel}</span>, -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. 105--></p> +LaTeX will give an error. Just hit <span class= +"keystroke"><img src="index1x.png" alt="←'" class= +"hookleftarrow" /></span>to continue the typesetting. +<!--l. 97--></p> <p class="indent">After these experiments, let’s modify the text as follows:</p> <div class="example"> -<div class="fancyvrb" id="fancyvrb3"> -<a id="x9-14012r1" name="x9-14012r1"></a><span class= -"ec-lmtt-10x-x-109">\begin{document}</span><br class="fancyvrb" /> +<pre class="fancyvrb" id="fancyvrb3" xml:space="preserve"><a id= +"x9-14012r1" name="x9-14012r1"></a><span class= +"ec-lmtt-10x-x-109">\begin{document}</span> <a id="x9-14014r2" name="x9-14014r2"></a><span class= -"ec-lmtt-10x-x-109">\maketitle</span><br class="fancyvrb" /> +"ec-lmtt-10x-x-109">\maketitle</span> <a id="x9-14016r3" name="x9-14016r3"></a><span class= -"ec-lmtt-10x-x-109">\tableofcontents</span><br class="fancyvrb" /> -<a id="x9-14018r4" name="x9-14018r4"></a><br class="fancyvrb" /> +"ec-lmtt-10x-x-109">\tableofcontents</span> +<a id="x9-14018r4" name="x9-14018r4"></a> <a id="x9-14020r5" name="x9-14020r5"></a><span class= "ec-lmtt-10x-x-109">\section{Petite</span><span class= -"ec-lmtt-10x-x-109"> d</span><span class= -"ec-lmtt-10x-x-109">émonstration}</span><br class="fancyvrb" /> -<a id="x9-14022r6" name="x9-14022r6"></a><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> d</span><span class= +"ec-lmtt-10x-x-109">émonstration}</span> +<a id="x9-14022r6" name="x9-14022r6"></a> <a id="x9-14024r7" name="x9-14024r7"></a><span class= "ec-lmtt-10x-x-109">Voici</span><span class= -"ec-lmtt-10x-x-109"> un</span><span class= -"ec-lmtt-10x-x-109"> texte</span><span class= -"ec-lmtt-10x-x-109"> accentu</span><span class= +"ec-lmtt-10x-x-109"> un</span><span class= +"ec-lmtt-10x-x-109"> texte</span><span class= +"ec-lmtt-10x-x-109"> accentu</span><span class= "ec-lmtt-10x-x-109">é</span><span class= -"ec-lmtt-10x-x-109"> en</span><span class= -"ec-lmtt-10x-x-109"> fran</span><span class= -"ec-lmtt-10x-x-109">çais!</span><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> en</span><span class= +"ec-lmtt-10x-x-109"> fran</span><span class= +"ec-lmtt-10x-x-109">çais!</span> <a id="x9-14026r8" name="x9-14026r8"></a><span class= "ec-lmtt-10x-x-109">Suite</span><span class= -"ec-lmtt-10x-x-109"> du</span><span class= -"ec-lmtt-10x-x-109"> texte</span><span class= -"ec-lmtt-10x-x-109"> entr</span><span class= +"ec-lmtt-10x-x-109"> du</span><span class= +"ec-lmtt-10x-x-109"> texte</span><span class= +"ec-lmtt-10x-x-109"> entr</span><span class= "ec-lmtt-10x-x-109">é</span><span class= -"ec-lmtt-10x-x-109"> apr</span><span class= +"ec-lmtt-10x-x-109"> apr</span><span class= "ec-lmtt-10x-x-109">ès</span><span class= -"ec-lmtt-10x-x-109"> avoir</span><span class= -"ec-lmtt-10x-x-109"> fait</span><span class= -"ec-lmtt-10x-x-109"> un</span><span class= -"ec-lmtt-10x-x-109"> retour</span><span class= -"ec-lmtt-10x-x-109"> chariot.</span><span class= -"ec-lmtt-10x-x-109"> Dans</span><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> avoir</span><span class= +"ec-lmtt-10x-x-109"> fait</span><span class= +"ec-lmtt-10x-x-109"> un</span><span class= +"ec-lmtt-10x-x-109"> retour</span><span class= +"ec-lmtt-10x-x-109"> chariot.</span><span class= +"ec-lmtt-10x-x-109"> Dans</span> <a id="x9-14028r9" name="x9-14028r9"></a><span class= "ec-lmtt-10x-x-109">l</span><span class= "ts1-lmtt10-x-x-109">'</span><span class= "ec-lmtt-10x-x-109">éditeur</span><span class= -"ec-lmtt-10x-x-109"> on</span><span class= -"ec-lmtt-10x-x-109"> peut</span><span class= -"ec-lmtt-10x-x-109"> demander</span><span class= -"ec-lmtt-10x-x-109"> un</span><span class= -"ec-lmtt-10x-x-109"> passage</span><span class= -"ec-lmtt-10x-x-109"> automatique</span><span class= -"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> on</span><span class= +"ec-lmtt-10x-x-109"> peut</span><span class= +"ec-lmtt-10x-x-109"> demander</span><span class= +"ec-lmtt-10x-x-109"> un</span><span class= +"ec-lmtt-10x-x-109"> passage</span><span class= +"ec-lmtt-10x-x-109"> automatique</span><span class= +"ec-lmtt-10x-x-109"> </span><span class= "ec-lmtt-10x-x-109">à</span><span class= -"ec-lmtt-10x-x-109"> la</span><span class= -"ec-lmtt-10x-x-109"> ligne</span><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> la</span><span class= +"ec-lmtt-10x-x-109"> ligne</span> <a id="x9-14030r10" name="x9-14030r10"></a><span class= "ec-lmtt-10x-x-109">du</span><span class= -"ec-lmtt-10x-x-109"> texte</span><span class= -"ec-lmtt-10x-x-109"> saisi;</span><span class= -"ec-lmtt-10x-x-109"> mais</span><span class= -"ec-lmtt-10x-x-109"> le</span><span class= -"ec-lmtt-10x-x-109"> num</span><span class= +"ec-lmtt-10x-x-109"> texte</span><span class= +"ec-lmtt-10x-x-109"> saisi;</span><span class= +"ec-lmtt-10x-x-109"> mais</span><span class= +"ec-lmtt-10x-x-109"> le</span><span class= +"ec-lmtt-10x-x-109"> num</span><span class= "ec-lmtt-10x-x-109">éro</span><span class= -"ec-lmtt-10x-x-109"> de</span><span class= -"ec-lmtt-10x-x-109"> ligne</span><span class= -"ec-lmtt-10x-x-109"> n</span><span class= +"ec-lmtt-10x-x-109"> de</span><span class= +"ec-lmtt-10x-x-109"> ligne</span><span class= +"ec-lmtt-10x-x-109"> n</span><span class= "ts1-lmtt10-x-x-109">'</span><span class= "ec-lmtt-10x-x-109">est</span><span class= -"ec-lmtt-10x-x-109"> incr</span><span class= +"ec-lmtt-10x-x-109"> incr</span><span class= "ec-lmtt-10x-x-109">ément</span><span class= "ec-lmtt-10x-x-109">é</span><span class= -"ec-lmtt-10x-x-109"> que</span><span class= -"ec-lmtt-10x-x-109"> par</span><span class= -"ec-lmtt-10x-x-109"> un</span><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> que</span><span class= +"ec-lmtt-10x-x-109"> par</span><span class= +"ec-lmtt-10x-x-109"> un</span> <a id="x9-14032r11" name="x9-14032r11"></a><span class= "ec-lmtt-10x-x-109">retour</span><span class= -"ec-lmtt-10x-x-109"> chariot.</span><br class="fancyvrb" /> -<a id="x9-14034r12" name="x9-14034r12"></a><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> chariot.</span> +<a id="x9-14034r12" name="x9-14034r12"></a> <a id="x9-14036r13" name="x9-14036r13"></a><span class= "ec-lmtt-10x-x-109">Nouvelle</span><span class= -"ec-lmtt-10x-x-109"> ligne</span><span class= -"ec-lmtt-10x-x-109"> en</span><span class= -"ec-lmtt-10x-x-109"> passant</span><span class= -"ec-lmtt-10x-x-109"> une</span><span class= -"ec-lmtt-10x-x-109"> ligne</span><span class= -"ec-lmtt-10x-x-109"> dans</span><span class= -"ec-lmtt-10x-x-109"> la</span><span class= -"ec-lmtt-10x-x-109"> source:</span><span class= -"ec-lmtt-10x-x-109"> c</span><span class= +"ec-lmtt-10x-x-109"> ligne</span><span class= +"ec-lmtt-10x-x-109"> en</span><span class= +"ec-lmtt-10x-x-109"> passant</span><span class= +"ec-lmtt-10x-x-109"> une</span><span class= +"ec-lmtt-10x-x-109"> ligne</span><span class= +"ec-lmtt-10x-x-109"> dans</span><span class= +"ec-lmtt-10x-x-109"> la</span><span class= +"ec-lmtt-10x-x-109"> source:</span><span class= +"ec-lmtt-10x-x-109"> c</span><span class= "ts1-lmtt10-x-x-109">'</span><span class= "ec-lmtt-10x-x-109">est</span><span class= -"ec-lmtt-10x-x-109"> la</span><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> la</span> <a id="x9-14038r14" name="x9-14038r14"></a><span class= "ec-lmtt-10x-x-109">mani</span><span class= "ec-lmtt-10x-x-109">ère</span><span class= -"ec-lmtt-10x-x-109"> d</span><span class= +"ec-lmtt-10x-x-109"> d</span><span class= "ts1-lmtt10-x-x-109">'</span><span class= "ec-lmtt-10x-x-109">indiquer</span><span class= -"ec-lmtt-10x-x-109"> un</span><span class= -"ec-lmtt-10x-x-109"> changement</span><span class= -"ec-lmtt-10x-x-109"> de</span><span class= -"ec-lmtt-10x-x-109"> paragraphe.</span><br class="fancyvrb" /> -<a id="x9-14040r15" name="x9-14040r15"></a><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> un</span><span class= +"ec-lmtt-10x-x-109"> changement</span><span class= +"ec-lmtt-10x-x-109"> de</span><span class= +"ec-lmtt-10x-x-109"> paragraphe.</span> +<a id="x9-14040r15" name="x9-14040r15"></a> <a id="x9-14042r16" name="x9-14042r16"></a><span class= -"ec-lmtt-10x-x-109">\end{document}</span> -</div> +"ec-lmtt-10x-x-109">\end{document}</span></pre> </div>Redo the previous experiments and observe the changes which -appear. <!--l. 126--> +appear. <!--l. 118--> <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 -has to have an empty line for that. In T<sub>E</sub>Xworks, the -line number of the source (on the right in the status bar) numbers -the lines created with carriage return, not the wrapped lines.</p> +doesn’t create a new paragraph. In LaTeX, one has to have an empty +line for that. In T<sub>E</sub>Xworks, the line number of the +source (on the right in the status bar) numbers the lines created +with carriage return, not the wrapped lines.</p> <h3 class="sectionHead"><span class="titlemark">3.3</span> <a id= "x9-150003.3" name="x9-150003.3"></a>And when errors -occur?</h3><a id="dx9-15001" name="dx9-15001"></a> <!--l. 130--> +occur?</h3><a id="dx9-15001" name="dx9-15001"></a> <!--l. 122--> <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> 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.</p> +LaTeX, you cannot avoid making mistakes: forgetting a closing brace +or an <span class="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, +LaTeX 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 LaTeX waiting for an +instruction to know what it should do.</p> <div class="center"> -<!--l. 132--> -<p class="noindent"><!--l. 133--></p> -<p class="noindent"><img src="images/consoleOutput.png" alt= -"pict" /></p> -</div><!--l. 136--> +<!--l. 124--> +<p class="noindent"><!--l. 125--></p> +<p class="noindent"><img src="images//consoleOutput-.png" alt="PIC" +class="c14" /></p> +</div><!--l. 128--> <p class="indent">One sees the <em>typing cursor<a id="dx9-15002" name="dx9-15002"></a></em> in the line between the output panel and the status bar: the <em>console bar<a id="dx9-15003" name= -"dx9-15003"></a></em>. <!--l. 138--></p> +"dx9-15003"></a></em>. <!--l. 130--></p> <p class="indent">The error message is on many lines, for example -like this: <!--l. 141--></p> +like this: <!--l. 133--></p> <p class="indent"></p> -<div class="fancyvrb" id="fancyvrb4"> -<a id="x9-15005r1" name="x9-15005r1"></a><span class= +<pre class="fancyvrb" id="fancyvrb4" xml:space="preserve"><a id= +"x9-15005r1" name="x9-15005r1"></a><span class= "ec-lmtt-10x-x-109">!</span><span class= -"ec-lmtt-10x-x-109"> Undefined</span><span class= -"ec-lmtt-10x-x-109"> control</span><span class= -"ec-lmtt-10x-x-109"> sequence.</span><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> Undefined</span><span class= +"ec-lmtt-10x-x-109"> control</span><span class= +"ec-lmtt-10x-x-109"> sequence.</span> <a id="x9-15007r2" name="x9-15007r2"></a><span class= "ec-lmtt-10x-x-109">l.168</span><span class= -"ec-lmtt-10x-x-109"> ...</span><span class= -"ec-lmtt-10x-x-109"> fermante</span><span class= -"ec-lmtt-10x-x-109"> ou</span><span class= -"ec-lmtt-10x-x-109"> d</span><span class= +"ec-lmtt-10x-x-109"> ...</span><span class= +"ec-lmtt-10x-x-109"> fermante</span><span class= +"ec-lmtt-10x-x-109"> ou</span><span class= +"ec-lmtt-10x-x-109"> d</span><span class= "ts1-lmtt10-x-x-109">'</span><span class= "ec-lmtt-10x-x-109">une</span><span class= -"ec-lmtt-10x-x-109"> commande</span><span class= -"ec-lmtt-10x-x-109"> \veb</span><br class="fancyvrb" /> +"ec-lmtt-10x-x-109"> commande</span><span class= +"ec-lmtt-10x-x-109"> \veb</span> <a id="x9-15009r3" name="x9-15009r3"></a><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> </span><span class= -"ec-lmtt-10x-x-109"> +\end{}+</span><span class= -"ec-lmtt-10x-x-109"> de</span><span class= -"ec-lmtt-10x-x-109"> fermeture</span><span class= -"ec-lmtt-10x-x-109"> d</span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> </span><span class= +"ec-lmtt-10x-x-109"> +\end{}+</span><span class= +"ec-lmtt-10x-x-109"> de</span><span class= +"ec-lmtt-10x-x-109"> fermeture</span><span class= +"ec-lmtt-10x-x-109"> d</span><span class= "ts1-lmtt10-x-x-109">'</span><span class= -"ec-lmtt-10x-x-109">un...</span><br class="fancyvrb" /> +"ec-lmtt-10x-x-109">un...</span> <a id="x9-15011r4" name="x9-15011r4"></a><span class= -"ec-lmtt-10x-x-109">?</span> -</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 -to type <span class="obeylines-h verb ec-lmtt-12">h</span> (plus -<span class="keystroke"><img src="images/index3x.png" alt="←'" -class="hookleftarrow" /></span>) for help, points to the line -number where it noticed the error<span class= -"footnote-mark"><a href="index19.html#fn10x4"><sup class= +"ec-lmtt-10x-x-109">?</span></pre><!--l. 140--> +<p class="indent">LaTeX says that it doesn’t recognize the command +name, sometimes suggests to see the manual or to type <span class= +"obeylines-h verb ec-lmtt-12">h</span> (plus <span class= +"keystroke"><img src="index2x.png" alt="←'" class= +"hookleftarrow" /></span>) for help, points to the line number +where it noticed the error<span class="footnote-mark"><a href= +"index19.html#fn10x4"><sup class= "textsuperscript">10</sup></a></span><a id="x9-15012f10" name= "x9-15012f10"></a> (here 168), and shows the place of the error at 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. 150--></p> +mark. <!--l. 142--></p> <p class="indent">There are different possible actions:</p> <ul class="itemize1"> -<li class="itemize">Type <span class="keystroke"><img src= -"images/index4x.png" alt="←'" class="hookleftarrow" /></span>and -ask to continue as if nothing happened; sometimes this allows to -finish compiling, but there will be an error in the result.</li> -<li class="itemize">Type <span class= +<li class="itemize"> +<!--l. 144--> +<p class="noindent">Type <span class="keystroke"><img src= +"index3x.png" alt="←'" class="hookleftarrow" /></span>and ask to +continue as if nothing happened; sometimes this allows to finish +compiling, but there will be an error in the result.</p> +</li> +<li class="itemize"> +<!--l. 145--> +<p class="noindent">Type <span class= "obeylines-h verb ec-lmtt-12">h</span><span class= -"keystroke"><img src="images/index5x.png" alt="←'" class= +"keystroke"><img src="index4x.png" alt="←'" class= "hookleftarrow" /></span>to ask for help; this help is not always -clearer than the error message, but often gives a clue.</li> -<li class="itemize">Type <span class= +clearer than the error message, but often gives a clue.</p> +</li> +<li class="itemize"> +<!--l. 146--> +<p class="noindent">Type <span class= "obeylines-h verb ec-lmtt-12">i</span><span class= -"keystroke"><img src="images/index6x.png" alt="←'" class= -"hookleftarrow" /></span>to tell L<sup>A</sup>T<sub>E</sub>X that -we will propose a replacement text. Enter the text followed by -<span class="keystroke"><img src="images/index7x.png" alt="←'" -class="hookleftarrow" /></span>; it will be used, beginning at the -start of the error, but you should correct the source afterwards as -L<sup>A</sup>T<sub>E</sub>X never changes that.</li> -<li class="itemize">Type <span class= +"keystroke"><img src="index5x.png" alt="←'" class= +"hookleftarrow" /></span>to tell LaTeX that we will propose a +replacement text. Enter the text followed by <span class= +"keystroke"><img src="index6x.png" alt="←'" class= +"hookleftarrow" /></span>; it will be used, beginning at the start +of the error, but you should correct the source afterwards as LaTeX +never changes that.</p> +</li> +<li class="itemize"> +<!--l. 147--> +<p class="noindent">Type <span class= "obeylines-h verb ec-lmtt-12">x</span><span class= -"keystroke"><img src="images/index8x.png" alt="←'" class= +"keystroke"><img src="index7x.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. 157--> +process. <!--l. 149--></p> <p class="noindent">We can also kill the typesetting by repeating the action used to start it: the green typesetting button will have changed to a red one with a white cross <img src= -"images/iconAbortTypesetting.png" alt="pict" />. By clicking on -that button or by hitting <span class= +"images//iconAbortTypesetting-.png" alt="PIC" class="c15" />. By +clicking on that button or by hitting <span class= "keystroke">Ctrl</span><span class="keystroke">T</span> (macOS: -<span class="keystroke"><img src="images/MacCmdKey.png" alt= -"pict" /></span><span class="keystroke">T</span>) again, the -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> +<span class="keystroke"><img src="images//MacCmdKey-.png" alt="PIC" +class="c9" /></span><span class="keystroke">T</span>) again, the +LaTeX process is terminated. The output panel is still visible and +so one can still see the error message.</p> </li> -</ul><!--l. 161--> +</ul><!--l. 153--> <p class="indent">You should note that sometimes an error appears far from its actual position. For example, when opening an -environment but not closing it, L<sup>A</sup>T<sub>E</sub>X doesn’t -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= +environment but not closing it, LaTeX doesn’t 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. 163--></p> +shows that another environment was not closed! <!--l. 155--></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 corrected in the document. This can happen because @@ -548,78 +553,79 @@ files which can still contain the original, erroneous code. 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#x29-360005.6">5.6 -<!--tex4ht:ref: sec:remove-aux-files --></a>. <!--l. 165--></p> +"GoingfurtherOthertools.html#x29-380005.6">5.6 +<!--tex4ht:ref: sec:remove-aux-files --></a>. <!--l. 157--></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 +can close the panel by the <em class="c10">Windows</em><span class= +"lmsy-10x-x-120">→</span><em class="c10">Hide Output Panel</em><a id="dx9-15013" name="dx9-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= +successfully by setting <em class="c10">Edit</em> <span class= "lmsy-10x-x-120">→</span><em class= -"c8">Preferences…</em><span class= +"c10">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> +"c10">Typesetting</em><span class= +"lmsy-10x-x-120">→</span><em class="c10">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. 159--></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 -comes with a small script that extracts all errors, warnings, and -other noteworthy messages from the console output and presents them -to you in a simple, tabular form.</p> +if you are using LaTeX), T<sub>E</sub>Xworks comes with a small +script that extracts all errors, warnings, and other noteworthy +messages from the console output and presents them to you in a +simple, tabular form.</p> <div class="center"> -<!--l. 169--> -<p class="noindent"><!--l. 170--></p> -<p class="noindent"><img src="images/errorParsingScript.png" alt= -"pict" /></p> -</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 -severity. Red represents errors, yellow indicates warnings, and -blue stands for over- and underfull box warnings. Next to the -colour bar, you see the name of the file in which the error was -detected. Next to that, you see the line number (if the script was -able to determine that), as well as an excerpt from the console -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 +<!--l. 161--> +<p class="noindent"><!--l. 162--></p> +<p class="noindent"><img src="images//errorParsingScript-.png" alt= +"PIC" class="c14" /></p> +</div><!--l. 165--> +<p class="indent">Here, you see a list of LaTeX messages, +color-coded and sorted by severity. Red represents errors, yellow +indicates warnings, and blue stands for over- and underfull box +warnings. Next to the colour bar, you see the name of the file in +which the error was detected. Next to that, you see the line number +(if the script was able to determine that), as well as an excerpt +from the console 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 LaTeX reported the error. Hopefully, you can quickly fix any errors that -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, -particularly if the console output is formatted differently. In -this case, you can simply disable the error parsing hook script -(see section <a href="AdvanceduseScripting.html#x33-400006.2">6.2 +may occur this way. <!--l. 167--></p> +<p class="indent">In case you are not using LaTeX, this script may +be of little use, particularly if the console output is formatted +differently. In this case, you can simply disable the error parsing +hook script (see section <a href= +"AdvanceduseScripting.html#x33-420006.2">6.2 <!--tex4ht:ref: sec:installing-scripts --></a>).</p> <h3 class="sectionHead"><span class="titlemark">3.4</span> <a id= "x9-160003.4" name="x9-160003.4"></a>Changing T<sub>E</sub>Xworks parameters for convenience</h3><a id="dx9-16001" name= -"dx9-16001"></a> <!--l. 180--> +"dx9-16001"></a> <!--l. 172--> <p class="noindent">If the default font<a id="dx9-16002" name= "dx9-16002"></a> of the editor doesn’t suit you, it is possible to -change it from <em class="c8">Format</em><span class= -"lmsy-10x-x-120">→</span><em class="c8">Font…</em> by selecting a +change it from <em class="c10">Format</em><span class= +"lmsy-10x-x-120">→</span><em class="c10">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. 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. 184--></p> +restarted. <!--l. 174--></p> +<p class="indent">From the <em class="c10">Typeset</em> menu or +from the drop-down on the <em class="c10">Typesetting tool +bar</em>, you can change the compilation format. Again this change +will only be temporary and for the current document. +<!--l. 176--></p> <p class="indent">To have permanent changes, you need to change the <em>preferences<a id="dx9-16003" name="dx9-16003"></a></em> through -the <em class="c8">Edit</em><span class= -"lmsy-10x-x-120">→</span><em class="c8">Preferences…</em> menu -item, using the <em class="c8">Editor</em> tab for the font and the -<em class="c8">Typesetting</em> tab for the compilation format: the -default format is at the bottom of the tab. <!--l. 5--></p> +the <em class="c10">Edit</em><span class= +"lmsy-10x-x-120">→</span><em class="c10">Preferences…</em> menu +item, using the <em class="c10">Editor</em> tab for the font and +the <em class="c10">Typesetting</em> tab for the compilation +format: the default format is at the bottom of the tab. +<!--l. 6--></p> <div class="crosslinks"> <p class="noindent">[<a href= "GoingfurtherEditingtools.html">next</a>] [<a href= @@ -627,7 +633,7 @@ default format is at the bottom of the tab. <!--l. 5--></p> "Installation.html#tailInstallation.html">prev-tail</a>] [<a href= "Firststeps.html">front</a>] [<a href= "index.html#Firststeps.html">up</a>]</p> -</div><!--l. 5--> +</div><!--l. 6--> <p class="indent"><a id="tailFirststeps.html" name= "tailFirststeps.html"></a></p> </div> |