summaryrefslogtreecommitdiff
path: root/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/GoingfurtherEditingtools.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/GoingfurtherEditingtools.html')
-rw-r--r--Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/GoingfurtherEditingtools.html680
1 files changed, 416 insertions, 264 deletions
diff --git a/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/GoingfurtherEditingtools.html b/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/GoingfurtherEditingtools.html
index e7f4c7460a8..dfa4b287396 100644
--- a/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/GoingfurtherEditingtools.html
+++ b/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/GoingfurtherEditingtools.html
@@ -9,23 +9,27 @@
<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.c9 {font-weight: bold}
+ img.c20 {width:67.97ex}
+ img.c19 {width:2.54ex}
+ img.c18 {width:48.2ex}
+ img.c17 {width:1.82ex}
+ em.c16 {font-weight: bold}
/*]]>*/
</style>
</head>
<body>
-<!--l. 5-->
+<!--l. 6-->
<p class="noindent"></p>
<div id="container">
-<!--l. 5-->
+<!--l. 6-->
<div class="crosslinks">
<p class="noindent">[<a href=
"GoingfurtherOthertools.html">next</a>] [<a href=
@@ -33,48 +37,48 @@
"Firststeps.html#tailFirststeps.html">prev-tail</a>] [<a href=
"#tailGoingfurtherEditingtools.html">tail</a>] [<a href=
"index.html#GoingfurtherEditingtools.html">up</a>]</p>
-</div><!--l. 5-->
+</div><!--l. 6-->
<p class="indent"></p>
<div class="chapternumber">
4
</div>
<h1><a id="x20-170004" name="x20-170004"></a>Going further: Editing
-tools</h1><!--l. 7-->
+tools</h1><!--l. 8-->
<p class="indent">When you have had some practise with
T<sub>E</sub>Xworks, you’ll find the need for more effective tools.
Many of them are bundled with T<sub>E</sub>Xworks. We are going to
see some of them now.</p>
<h3 class="sectionHead"><span class="titlemark">4.1</span> <a id=
"x20-180004.1" name="x20-180004.1"></a>Creating a document from a
-template</h3><a id="dx20-18001" name="dx20-18001"></a> <!--l. 11-->
+template</h3><a id="dx20-18001" name="dx20-18001"></a> <!--l. 12-->
<p class="noindent">Most documents you will create will use the
same instructions in the preamble, the same layout settings,
similar heading and so on. You can use predefined templates to get
started quickly or create your own with all of these settings
-already in place. <!--l. 13--></p>
-<p class="indent">Use <em class="c9">File</em><span class=
-"lmsy-10x-x-120">→</span><em class="c9">New from template…</em> or
+already in place. <!--l. 14--></p>
+<p class="indent">Use <em class="c16">File</em><span class=
+"lmsy-10x-x-120">→</span><em class="c16">New from template…</em> or
<span class="keystroke">Ctrl</span><span class="keystroke">Shift
<span class="lmsy-10x-x-120">⇑</span></span><span class=
"keystroke">N</span> (macOS: <span class="keystroke"><img src=
-"images/MacCmdKey.png" alt="pict" /></span><span class=
-"keystroke">Shift <span class=
+"images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">Shift <span class=
"lmsy-10x-x-120">⇑</span></span><span class="keystroke">N</span>).
A dialogue box opens to allow you to select one of the templates.
After selecting one and pressing <span class=
"obeylines-h verb ec-lmtt-12">OK</span>, a document is created and
-you can start to work. <!--l. 15--></p>
+you can start to work. <!--l. 16--></p>
<p class="indent">If you want to create a personal template, you
just have to create a suitable document with everything you always
want to do (and perhaps marking places to fill in the rest) and
save it as a <span class="path">.tex</span> file in the
<span class="path">&lt;resources&gt;\templates</span> folder, or a
-sub-folder of it, if you wish. <!--l. 17--></p>
+sub-folder of it, if you wish. <!--l. 18--></p>
<p class="noindent"></p>
<h3 class="sectionHead"><span class="titlemark">4.2</span> <a id=
"x20-190004.2" name="x20-190004.2"></a>Creating a project using
several source files</h3><a id="dx20-19001" name="dx20-19001"></a>
-<!--l. 19-->
+<!--l. 20-->
<p class="noindent">When the source becomes long, it is sometimes
difficult to navigate and maintain it. In that case, it is useful
to split the source into different smaller files: one file will be
@@ -84,34 +88,31 @@ as calls to the “sub-documents”<span class="footnote-mark"><a href=
"index21.html#fn1x5"><sup class=
"textsuperscript">1</sup></a></span><a id="x20-19002f1" name=
"x20-19002f1"></a>, which could in turn contain separate chapters,
-for example. <!--l. 22--></p>
+for example. <!--l. 23--></p>
<p class="indent">But there might be a problem if you want to start
typesetting/compilation in a sub-document: as there is neither a
preamble nor a <span class=
"obeylines-h verb ec-lmtt-12">document</span> environment there,
-L<sup>A</sup>T<sub>E</sub>X will stop immediately with an error.
-<!--l. 24--></p>
+LaTeX will stop immediately with an error. <!--l. 25--></p>
<p class="indent">To tell T<sub>E</sub>Xworks that it should
typeset the main document, one adds at the very beginning of the
sub-document the instruction:<a id="dx20-19003" name=
"dx20-19003"></a></p>
-<div class="fancyvrb" id="fancyvrb5">
-<a id="x20-19005r1" name="x20-19005r1"></a><span class=
+<pre class="fancyvrb" id="fancyvrb5" xml:space="preserve"><a id=
+"x20-19005r1" name="x20-19005r1"></a><span class=
"ec-lmtt-10x-x-109">%</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;!TeX</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;root</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;=</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;path/main_file.tex</span>
-</div><!--l. 28-->
+"ec-lmtt-10x-x-109"> !TeX</span><span class=
+"ec-lmtt-10x-x-109"> root</span><span class=
+"ec-lmtt-10x-x-109"> =</span><span class=
+"ec-lmtt-10x-x-109"> path/main_file.tex</span></pre><!--l. 29-->
<p class="noindent">for example:</p>
-<div class="fancyvrb" id="fancyvrb6">
-<a id="x20-19007r1" name="x20-19007r1"></a><span class=
+<pre class="fancyvrb" id="fancyvrb6" xml:space="preserve"><a id=
+"x20-19007r1" name="x20-19007r1"></a><span class=
"ec-lmtt-10x-x-109">%</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;!TeX</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;root</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;=</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;manual.tex</span>
-</div><!--l. 33-->
+"ec-lmtt-10x-x-109"> !TeX</span><span class=
+"ec-lmtt-10x-x-109"> root</span><span class=
+"ec-lmtt-10x-x-109"> =</span><span class=
+"ec-lmtt-10x-x-109"> manual.tex</span></pre><!--l. 34-->
<p class="indent">If the main file is in the same folder, its name
is enough, as in the above example. Otherwise, you must also give
the path to the main document (preferably relative to the
@@ -119,40 +120,40 @@ sub-document in question, e.g., <span class=
"path">../manual.tex</span>). Notice that the slash <span class=
"obeylines-h verb ec-lmtt-12">/</span> and not the backslash
<span class="obeylines-h verb ec-lmtt-12">\</span> should be used
-as directory separator even on Windows. <!--l. 35--></p>
+as directory separator even on Windows. <!--l. 36--></p>
<p class="indent">Further, with MiKTeX, the call to a sub-document
<span class="obeylines-h verb ec-lmtt-12">\input{name.tex}</span>
should include the extension <span class="path">.tex</span> to
ensure proper SyncTeX functionality (see section&nbsp;<a href=
-"GoingfurtherOthertools.html#x29-310005.1">5.1
+"GoingfurtherOthertools.html#x29-330005.1">5.1
<!--tex4ht:ref: sec.synctex --></a>).</p>
<h3 class="sectionHead"><span class="titlemark">4.3</span> <a id=
"x20-200004.3" name="x20-200004.3"></a>Spell-checking</h3>
-<!--l. 39-->
+<!--l. 40-->
<p class="noindent">You can turn on automatic spell-checking<a id=
"dx20-20001" name="dx20-20001"></a> of your source document from
-<em class="c9">Edit</em> <span class=
-"lmsy-10x-x-120">→</span><em class="c9">Spelling</em><span class=
-"lmsy-10x-x-120">→</span><em class="c9">&lt;language&gt;</em>. It
+<em class="c16">Edit</em> <span class=
+"lmsy-10x-x-120">→</span><em class="c16">Spelling</em><span class=
+"lmsy-10x-x-120">→</span><em class="c16">&lt;language&gt;</em>. It
is also possible to ask T<sub>E</sub>Xworks to enable
spell-checking by default by setting a dictionary in <em class=
-"c9">Edit</em><span class="lmsy-10x-x-120">→</span><em class=
-"c9">Preferences…</em><span class=
-"lmsy-10x-x-120">→</span><em class="c9">Editor</em><span class=
-"lmsy-10x-x-120">→</span><em class="c9">Spell-check language</em>.
-<!--l. 41--></p>
+"c16">Edit</em><span class="lmsy-10x-x-120">→</span><em class=
+"c16">Preferences…</em><span class=
+"lmsy-10x-x-120">→</span><em class="c16">Editor</em><span class=
+"lmsy-10x-x-120">→</span><em class="c16">Spell-check language</em>.
+<!--l. 42--></p>
<p class="indent">During typing, every word the spell-checker
considers wrong is underlined by a red wavy line. A right-click on
the word opens a contextual menu in which there are some
replacement suggestions. Click on the desired word to make the
-replacement. <!--l. 43--></p>
+replacement. <!--l. 44--></p>
<p class="indent">Before using the spell-checker, you need to
install dictionaries in the right folder of T<sub>E</sub>Xworks:
<span class="path">&lt;resources&gt;\dictionaries</span>. The
<span class="path">&lt;resources&gt;</span> folder can be accessed
-easily via <em class="c9">Help</em><span class=
-"lmsy-10x-x-120">→</span><em class="c9">Settings and
-Resources…</em>. <!--l. 45--></p>
+easily via <em class="c16">Help</em><span class=
+"lmsy-10x-x-120">→</span><em class="c16">Settings and
+Resources…</em>. <!--l. 46--></p>
<p class="indent"></p>
<div class="OSspecific">
<div class="OSspecificLogo OSLinux"></div>On Linux, the
@@ -164,7 +165,7 @@ file system layout of your Linux distribution. You can override
this default by setting the <span class=
"obeylines-h verb ec-lmtt-12">TW_DICPATH</span> environment
variable before running T<sub>E</sub>Xworks.
-</div><!--l. 49-->
+</div><!--l. 50-->
<p class="indent">One can use the available dictionaries for
OpenOffice.org and other free software;<span class=
"footnote-mark"><a href="index22.html#fn2x5"><sup class=
@@ -177,15 +178,15 @@ for example.</p>
<h3 class="sectionHead"><span class="titlemark">4.4</span> <a id=
"x20-210004.4" name="x20-210004.4"></a>Search and
replace</h3><a id="dx20-21001" name="dx20-21001"></a> <a id=
-"dx20-21002" name="dx20-21002"></a> <!--l. 54-->
+"dx20-21002" name="dx20-21002"></a> <!--l. 55-->
<p class="noindent"></p>
<h4 class="subsectionHead"><span class="titlemark">4.4.1</span>
<a id="x20-220004.4.1" name="x20-220004.4.1"></a>Standard
-functions</h4><!--l. 56-->
+functions</h4><!--l. 57-->
<p class="noindent">The options of the menu <em class=
-"c9">Search</em>—<em class="c9">Find…</em>, <em class="c9">Find
-again</em>, <em class="c9">Replace…</em>, <em class="c9">Replace
-again</em>, and <em class="c9">Go to Line…</em> (<span class=
+"c16">Search</em>—<em class="c16">Find…</em>, <em class="c16">Find
+again</em>, <em class="c16">Replace…</em>, <em class="c16">Replace
+again</em>, and <em class="c16">Go to Line…</em> (<span class=
"keystroke">Ctrl</span><span class="keystroke">F</span>,
<span class="keystroke">Ctrl</span><span class=
"keystroke">G</span>, <span class=
@@ -195,68 +196,80 @@ again</em>, and <em class="c9">Go to Line…</em> (<span class=
"keystroke">R</span>, and <span class=
"keystroke">Ctrl</span><span class="keystroke">L</span>,
respectively)—are standard actions (macOS: <span class=
-"keystroke"><img src="images/MacCmdKey.png" alt=
-"pict" /></span><span class="keystroke">F</span>, <span class=
-"keystroke"><img src="images/MacCmdKey.png" alt=
-"pict" /></span><span class="keystroke">G</span>, <span class=
-"keystroke"><img src="images/MacCmdKey.png" alt=
-"pict" /></span><span class="keystroke">R</span>, <span class=
-"keystroke"><img src="images/MacCmdKey.png" alt=
-"pict" /></span><span class="keystroke">Shift <span class=
+"keystroke"><img src="images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">F</span>, <span class=
+"keystroke"><img src="images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">G</span>, <span class=
+"keystroke"><img src="images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">R</span>, <span class=
+"keystroke"><img src="images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">Shift <span class=
"lmsy-10x-x-120">⇑</span></span><span class="keystroke">R</span>,
-and <span class="keystroke"><img src="images/MacCmdKey.png" alt=
-"pict" /></span><span class="keystroke">L</span>); the first and
-the third open a dialogue box:</p>
+and <span class="keystroke"><img src="images//MacCmdKey-.png" alt=
+"PIC" class="c17" /></span><span class="keystroke">L</span>); the
+first and the third open a dialogue box:</p>
<div class="center">
-<!--l. 58-->
-<p class="noindent"><!--l. 59--></p>
-<p class="noindent"><img src="images/replaceDialog.png" alt=
-"pict" /></p>
-</div><!--l. 62-->
+<!--l. 59-->
+<p class="noindent"><!--l. 60--></p>
+<p class="noindent"><img src="images//replaceDialog.png" alt="PIC"
+class="c18" /></p>
+</div><!--l. 63-->
<p class="indent">Here, the usual options are available: <em>Wrap
around</em>, <em>Find backwards</em>, <em>Search/Replace within
selection</em>, or <em>Find all occurrences</em>. The following
options are also usual: <em>Case sensitive</em> and <em>Whole
words</em>. By default, the search is forward, towards the end of
-the document. <!--l. 64--></p>
+the document. <!--l. 65--></p>
<p class="indent">The option <em>Search/Replace in all open
files</em> is also a frequent choice, but not as much as the
others; this allows, for example, replacement in all the files of a
project—pay attention, though, as this is very powerful.
-<!--l. 66--></p>
+<!--l. 67--></p>
<p class="indent">The last option, <em>Regular expression</em>, is
-detailed in the next sub-section. <!--l. 68--></p>
-<p class="indent">In the <em class="c9">Search</em> menu there are
+detailed in the next sub-section. <!--l. 69--></p>
+<p class="indent">In the <em class="c16">Search</em> menu there are
other options:</p>
<dl class="description">
-<dt class="description"><span class="ec-lmbx-12">Copy to
-Find</span></dt>
-<dd class="description">copies the currently selected text into the
+<dt class="description"><!--l. 71--><br class="noindent" />
+<span class="ec-lmbx-12">Copy to Find</span></dt>
+<dd class="description">
+<!--l. 71-->
+<p class="noindent">copies the currently selected text into the
<b><span class="ec-lmro-12">Find</span></b> field of the Find
dialogue or the <b><span class="ec-lmro-12">Replace</span></b>
field of the Replace dialogue; you still need to open the dialogues
-separately</dd>
-<dt class="description"><span class="ec-lmbx-12">Copy to
-Replace</span></dt>
-<dd class="description">copies the currently selected text into the
+separately</p>
+</dd>
+<dt class="description"><!--l. 72--><br class="noindent" />
+<span class="ec-lmbx-12">Copy to Replace</span></dt>
+<dd class="description">
+<!--l. 72-->
+<p class="noindent">copies the currently selected text into the
<b><span class="ec-lmro-12">With</span></b> field of the
-<b><span class="ec-lmro-12">Replace</span></b> dialogue</dd>
-<dt class="description"><span class="ec-lmbx-12">Find
-Selection</span></dt>
-<dd class="description">uses the current selection for a search
-without opening the <b><span class="ec-lmro-12">Find</span></b>
-dialogue—very fast</dd>
-<dt class="description"><span class="ec-lmbx-12">Show
-selection</span></dt>
-<dd class="description">scrolls the view to the currently selected
+<b><span class="ec-lmro-12">Replace</span></b> dialogue</p>
+</dd>
+<dt class="description"><!--l. 73--><br class="noindent" />
+<span class="ec-lmbx-12">Find Selection</span></dt>
+<dd class="description">
+<!--l. 73-->
+<p class="noindent">uses the current selection for a search without
+opening the <b><span class="ec-lmro-12">Find</span></b>
+dialogue—very fast</p>
+</dd>
+<dt class="description"><!--l. 74--><br class="noindent" />
+<span class="ec-lmbx-12">Show selection</span></dt>
+<dd class="description">
+<!--l. 74-->
+<p class="noindent">scrolls the view to the currently selected
text—useful if word wrapping is turned off and you moved in the
-document using the vertical scroll bar on the right</dd>
-</dl><!--l. 76-->
+document using the vertical scroll bar on the right</p>
+</dd>
+</dl><!--l. 77-->
<p class="noindent"></p>
<h4 class="subsectionHead"><span class="titlemark">4.4.2</span>
<a id="x20-230004.4.2" name="x20-230004.4.2"></a>Advanced search
and replace (regular expressions)</h4><a id="dx20-23001" name=
-"dx20-23001"></a> <!--l. 78-->
+"dx20-23001"></a> <!--l. 79-->
<p class="noindent">The regular expressions provide a very powerful
tool, but they require some effort to be well understood. To
understand them fully would require a manual of its own<span class=
@@ -264,106 +277,110 @@ understand them fully would require a manual of its own<span class=
"textsuperscript">3</sup></a></span><a id="x20-23002f3" name=
"x20-23002f3"></a>, so we’ll only give some simple ideas of use.
For more advanced uses, as well as lists of the most used codes,
-see section <a href="Regularexpressions.html#x43-52000B">B
-<!--tex4ht:ref: sec:regexp --></a>. <!--l. 80--></p>
+see section <a href="Regularexpressions.html#x43-54000B">B
+<!--tex4ht:ref: sec:regexp --></a>. <!--l. 81--></p>
<p class="indent">Suppose we have the following text:</p>
-<div class="fancyvrb" id="fancyvrb7">
-<a id="x20-23004r1" name="x20-23004r1"></a><span class=
+<pre class="fancyvrb" id="fancyvrb7" xml:space="preserve"><a id=
+"x20-23004r1" name="x20-23004r1"></a><span class=
"ec-lmtt-10x-x-109">Voici</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;du</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;texte</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;pour</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;tester</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;les</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;expressions</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;r</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"> pour</span><span class=
+"ec-lmtt-10x-x-109"> tester</span><span class=
+"ec-lmtt-10x-x-109"> les</span><span class=
+"ec-lmtt-10x-x-109"> expressions</span><span class=
+"ec-lmtt-10x-x-109"> r</span><span class=
"ec-lmtt-10x-x-109">éguli</span><span class=
"ec-lmtt-10x-x-109">ères</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;dans</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;du</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;texte</span><br class="fancyvrb" />
+"ec-lmtt-10x-x-109"> dans</span><span class=
+"ec-lmtt-10x-x-109"> du</span><span class=
+"ec-lmtt-10x-x-109"> texte</span>
<a id="x20-23006r2" name="x20-23006r2"></a><span class=
"ec-lmtt-10x-x-109">accentu</span><span class=
-"ec-lmtt-10x-x-109">é.</span><br class="fancyvrb" />
+"ec-lmtt-10x-x-109">é.</span>
<a id="x20-23008r3" name="x20-23008r3"></a><span class=
"ec-lmtt-10x-x-109">Voici</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;du</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;texte</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;pour</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;tester</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;les</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;expressions</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;r</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"> pour</span><span class=
+"ec-lmtt-10x-x-109"> tester</span><span class=
+"ec-lmtt-10x-x-109"> les</span><span class=
+"ec-lmtt-10x-x-109"> expressions</span><span class=
+"ec-lmtt-10x-x-109"> r</span><span class=
"ec-lmtt-10x-x-109">éguli</span><span class=
"ec-lmtt-10x-x-109">ères</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;dans</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;du</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;texte</span><br class="fancyvrb" />
+"ec-lmtt-10x-x-109"> dans</span><span class=
+"ec-lmtt-10x-x-109"> du</span><span class=
+"ec-lmtt-10x-x-109"> texte</span>
<a id="x20-23010r4" name="x20-23010r4"></a><span class=
"ec-lmtt-10x-x-109">accentu</span><span class=
-"ec-lmtt-10x-x-109">é.</span><br class="fancyvrb" />
+"ec-lmtt-10x-x-109">é.</span>
<a id="x20-23012r5" name="x20-23012r5"></a><span class=
"ec-lmtt-10x-x-109">Voici</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;du</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;texte</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;pour</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;tester</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;les</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;expressions</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;r</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"> pour</span><span class=
+"ec-lmtt-10x-x-109"> tester</span><span class=
+"ec-lmtt-10x-x-109"> les</span><span class=
+"ec-lmtt-10x-x-109"> expressions</span><span class=
+"ec-lmtt-10x-x-109"> r</span><span class=
"ec-lmtt-10x-x-109">éguli</span><span class=
"ec-lmtt-10x-x-109">ères.</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;Voici</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;du</span><br class="fancyvrb" />
+"ec-lmtt-10x-x-109"> Voici</span><span class=
+"ec-lmtt-10x-x-109"> du</span>
<a id="x20-23014r6" name="x20-23014r6"></a><span class=
"ec-lmtt-10x-x-109">texte</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;pour</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;tester</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;les</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;expressions</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;r</span><span class=
+"ec-lmtt-10x-x-109"> pour</span><span class=
+"ec-lmtt-10x-x-109"> tester</span><span class=
+"ec-lmtt-10x-x-109"> les</span><span class=
+"ec-lmtt-10x-x-109"> expressions</span><span class=
+"ec-lmtt-10x-x-109"> r</span><span class=
"ec-lmtt-10x-x-109">éguli</span><span class=
-"ec-lmtt-10x-x-109">ères.</span><br class="fancyvrb" />
+"ec-lmtt-10x-x-109">ères.</span>
<a id="x20-23016r7" name="x20-23016r7"></a><span class=
"ec-lmtt-10x-x-109">truc</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;truc</span><br class="fancyvrb" />
+"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"> truc</span>
<a id="x20-23018r8" name="x20-23018r8"></a><span class=
"ec-lmtt-10x-x-109">t</span><span class=
"ec-lmtt-10x-x-109">él.:</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;010-99-99-99</span><br class=
-"fancyvrb" />
+"ec-lmtt-10x-x-109"> 010-99-99-99</span>
<a id="x20-23020r9" name="x20-23020r9"></a><span class=
"ec-lmtt-10x-x-109">t</span><span class=
"ec-lmtt-10x-x-109">él.:</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;00.32.10.99.99.99</span><br class=
-"fancyvrb" />
+"ec-lmtt-10x-x-109"> 00.32.10.99.99.99</span>
<a id="x20-23022r10" name="x20-23022r10"></a><span class=
"ec-lmtt-10x-x-109">t</span><span class=
"ec-lmtt-10x-x-109">él.:</span><span class=
-"ec-lmtt-10x-x-109">&nbsp;00/32-10/99.99.99</span>
-</div><!--l. 93-->
+"ec-lmtt-10x-x-109"> 00/32-10/99.99.99</span></pre><!--l. 94-->
<p class="noindent">We want to</p>
<ol class="enumerate1">
-<li class="enumerate" id="x20-23024x1">insert an empty line after
-each “accentué” (to create paragraphs in
-L<sup>A</sup>T<sub>E</sub>X), but not after the three telephone
-numbers;</li>
-<li class="enumerate" id="x20-23026x2">replace each <span class=
+<li class="enumerate" id="x20-23024x1">
+<!--l. 96-->
+<p class="noindent">insert an empty line after each “accentué” (to
+create paragraphs in LaTeX), but not after the three telephone
+numbers;</p>
+</li>
+<li class="enumerate" id="x20-23026x2">
+<!--l. 97-->
+<p class="noindent">replace each <span class=
"ec-lmro-12">tab</span> character between the two words “truc” of
-the fourth paragraph by three spaces; and finally</li>
-<li class="enumerate" id="x20-23028x3">make the telephone numbers
-consistent by replacing the various punctuation characters by
-spaces.</li>
-</ol><!--l. 100-->
+the fourth paragraph by three spaces; and finally</p>
+</li>
+<li class="enumerate" id="x20-23028x3">
+<!--l. 98-->
+<p class="noindent">make the telephone numbers consistent by
+replacing the various punctuation characters by spaces.</p>
+</li>
+</ol><!--l. 101-->
<p class="indent">For 1., in the dialogue box <b><span class=
"ec-lmro-12">Replace</span></b> (<span class=
"keystroke">Ctrl</span><span class="keystroke">R</span>) for
@@ -382,7 +399,7 @@ empty line has been inserted after each line, select the telephone
lines and do the reverse action: replace ›<span class=
"obeylines-h verb ec-lmtt-12">\n\n</span>‹ by ›<span class=
"obeylines-h verb ec-lmtt-12">\n</span>‹. So we replaced one line
-feed by two, creating an empty line. <!--l. 102--></p>
+feed by two, creating an empty line. <!--l. 103--></p>
<p class="indent">For 2., use ›<span class=
"obeylines-h verb ec-lmtt-12">\t</span>‹ and ›<span class=
"obeylines-h verb ec-lmtt-12">␣␣␣</span>‹<span class=
@@ -392,7 +409,7 @@ feed by two, creating an empty line. <!--l. 102--></p>
"obeylines-h verb ec-lmtt-12">\t</span>‹ is the code which
represents a tab, while a space is typed in literally (here
represented as <span class="obeylines-h verb ec-lmtt-12">␣</span>).
-<!--l. 104--></p>
+<!--l. 105--></p>
<p class="indent">For 3., find ›<span class=
"obeylines-h verb ec-lmtt-12">-|\.|/</span>‹ and replace with
›<span class="obeylines-h verb ec-lmtt-12">␣</span>‹. Here,
@@ -406,14 +423,14 @@ character and we would have replaced all the characters by spaces!
We therefore have to use a code—prefixing the dot with a backslash
tells specifies that the normal meaning of the dot should be used
instead of the special meaning it usually has in regular
-expressions. <!--l. 106--></p>
+expressions. <!--l. 107--></p>
<p class="indent">If one has strings of the same character but of
different lengths (for example 3, 4, or 5 times the sames character
e) and one wants to truncate all these strings to a string with
less characters (for example 2), one can ask to replace the string
›<span class="obeylines-h verb ec-lmtt-12">e{3,5}</span>‹ by
›<span class="obeylines-h verb ec-lmtt-12">ee</span>‹.
-<!--l. 108--></p>
+<!--l. 109--></p>
<p class="indent">If one wants to insert the same string at the
beginning of some paragraphs separated or not by an empty line, for
example ›<span class=
@@ -431,7 +448,7 @@ in front of <span class=
because <span class="obeylines-h verb ec-lmtt-12">\</span> is an
escape character in regular expressions (we’ve met it before in the
expression <span class="obeylines-h verb ec-lmtt-12">\.</span>)!
-<!--l. 110--></p>
+<!--l. 111--></p>
<p class="indent">If it were making sense, we could replace all the
letters between “a” and “m” by “$” using ›<span class=
"obeylines-h verb ec-lmtt-12">[a-m]</span>‹ and ›<span class=
@@ -439,33 +456,34 @@ letters between “a” and “m” by “$” using ›<span class=
<h3 class="sectionHead"><span class="titlemark">4.5</span> <a id=
"x20-240004.5" name="x20-240004.5"></a>Other tools for editing and
error tracking</h3><a id="dx20-24001" name="dx20-24001"></a>
-<!--l. 114-->
+<!--l. 115-->
<p class="noindent"></p>
<h4 class="subsectionHead"><span class="titlemark">4.5.1</span>
<a id="x20-250004.5.1" name="x20-250004.5.1"></a>Standard
-tools</h4><!--l. 116-->
+tools</h4><!--l. 117-->
<p class="noindent">It is always possible to undo<a id="dx20-25001"
name="dx20-25001"></a> an action using <em class=
-"c9">Edit</em><span class="lmsy-10x-x-120">→</span><em class=
-"c9">Undo</em> or <span class="keystroke">Ctrl</span><span class=
+"c16">Edit</em><span class="lmsy-10x-x-120">→</span><em class=
+"c16">Undo</em> or <span class="keystroke">Ctrl</span><span class=
"keystroke">Z</span> (macOS: <span class="keystroke"><img src=
-"images/MacCmdKey.png" alt="pict" /></span><span class=
-"keystroke">Z</span>): this way you can undo stepwise! The inverse
-action, redo, is available as <em class="c9">Edit</em><span class=
-"lmsy-10x-x-120">→</span><em class="c9">Redo</em><a id="dx20-25002"
-name="dx20-25002"></a> or <span class=
-"keystroke">Ctrl</span><span class="keystroke">Shift <span class=
-"lmsy-10x-x-120">⇑</span></span><span class="keystroke">Z</span>
-(macOS: <span class="keystroke"><img src="images/MacCmdKey.png"
-alt="pict" /></span><span class="keystroke">Shift <span class=
+"images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">Z</span>): this way you can
+undo stepwise! The inverse action, redo, is available as <em class=
+"c16">Edit</em><span class="lmsy-10x-x-120">→</span><em class=
+"c16">Redo</em><a id="dx20-25002" name="dx20-25002"></a> or
+<span class="keystroke">Ctrl</span><span class="keystroke">Shift
+<span class="lmsy-10x-x-120">⇑</span></span><span class=
+"keystroke">Z</span> (macOS: <span class="keystroke"><img src=
+"images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">Shift <span class=
"lmsy-10x-x-120">⇑</span></span><span class=
"keystroke">Z</span>).<span class="footnote-mark"><a href=
"index26.html#fn6x5"><sup class=
"textsuperscript">6</sup></a></span><a id="x20-25003f6" name=
-"x20-25003f6"></a> <!--l. 118--></p>
+"x20-25003f6"></a> <!--l. 119--></p>
<p class="indent">T<sub>E</sub>Xworks also provides the standard
editing tools such as the clipboard; therefore one can select,
-cut/copy and paste a piece of text normally. <!--l. 120--></p>
+cut/copy and paste a piece of text normally. <!--l. 121--></p>
<p class="indent">You can select with the mouse by dragging over
the desired text, or by double-clicking to select a word. Using the
keyboard, holding down <span class="keystroke">Shift <span class=
@@ -474,63 +492,64 @@ will select text. You can also move and select word by word moving
left or right holding <span class=
"keystroke">Ctrl</span><span class="keystroke">Shift <span class=
"lmsy-10x-x-120">⇑</span></span> down ( <span class=
-"keystroke"><img src="images/MacCmdKey.png" alt=
-"pict" /></span><span class="keystroke">Shift <span class=
+"keystroke"><img src="images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">Shift <span class=
"lmsy-10x-x-120">⇑</span></span> on macOS). The clipboard shortcuts
are the ones you’ll find in almost every program: <span class=
"keystroke">Ctrl</span><span class="keystroke">X</span> to cut,
<span class="keystroke">Ctrl</span><span class="keystroke">C</span>
to copy, and <span class="keystroke">Ctrl</span><span class=
"keystroke">V</span> to paste ( <span class="keystroke"><img src=
-"images/MacCmdKey.png" alt="pict" /></span><span class=
-"keystroke">X</span>, <span class="keystroke"><img src=
-"images/MacCmdKey.png" alt="pict" /></span><span class=
-"keystroke">C</span> and <span class="keystroke"><img src=
-"images/MacCmdKey.png" alt="pict" /></span><span class=
-"keystroke">V</span>, respectively, on macOS). <!--l. 122--></p>
+"images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">X</span>, <span class=
+"keystroke"><img src="images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">C</span> and <span class=
+"keystroke"><img src="images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">V</span>, respectively, on
+macOS). <!--l. 123--></p>
<p class="indent">You can easily change the case<a id="dx20-25004"
name="dx20-25004"></a> of a selection—put everything upper case or
-lower case—using <em class="c9">Edit</em><span class=
-"lmsy-10x-x-120">→</span><em class="c9">Change case</em> and next,
-depending on the desired effect, <em class="c9">ALL UPPERCASE</em>,
-<em class="c9">all lowercase</em>, or <em class="c9">Toggle
-Case</em> (which toggles the case of each letter individually).
-<!--l. 124--></p>
+lower case—using <em class="c16">Edit</em><span class=
+"lmsy-10x-x-120">→</span><em class="c16">Change case</em> and next,
+depending on the desired effect, <em class="c16">ALL
+UPPERCASE</em>, <em class="c16">all lowercase</em>, or <em class=
+"c16">Toggle Case</em> (which toggles the case of each letter
+individually). <!--l. 125--></p>
<p class="indent">It is also convenient to show the line
numbers<a id="dx20-25005" name="dx20-25005"></a>, as all error
messages refer to these numbers; you can toggle the line numbers,
on the left of the editing panel, from <em class=
-"c9">Format</em><span class="lmsy-10x-x-120">→</span><em class=
-"c9">Line Numbers</em>.</p>
+"c16">Format</em><span class="lmsy-10x-x-120">→</span><em class=
+"c16">Line Numbers</em>.</p>
<h4 class="subsectionHead"><span class="titlemark">4.5.2</span>
<a id="x20-260004.5.2" name="x20-260004.5.2"></a>Commenting</h4>
-<!--l. 128-->
+<!--l. 129-->
<p class="noindent">When preparing a document with
(L<sup>A</sup>)T<sub>E</sub>X, it is often useful to prevent
compilation of a portion of text to be able to locate an error; you
can do this piece by piece until you find the part which causes the
error. For that, commenting the source block by block is needed.
-<!--l. 130--></p>
+<!--l. 131--></p>
<p class="indent">We have seen that the symbol <span class=
"obeylines-h verb ec-lmtt-12">%</span> marks the beginning of a
comment. To comment<a id="dx20-26001" name="dx20-26001"></a> a big
piece of text, it is sufficient to select it and ask to mark it as
-comment <em class="c9">Format</em> <span class=
-"lmsy-10x-x-120">→</span><em class="c9">Comment</em> or
+comment <em class="c16">Format</em> <span class=
+"lmsy-10x-x-120">→</span><em class="c16">Comment</em> or
<span class="keystroke">Ctrl</span><span class="keystroke">Shift
<span class="lmsy-10x-x-120">⇑</span></span><span class=
"keystroke">]</span> (macOS: <span class="keystroke"><img src=
-"images/MacCmdKey.png" alt="pict" /></span><span class=
-"keystroke">Shift <span class=
+"images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">Shift <span class=
"lmsy-10x-x-120">⇑</span></span><span class="keystroke">]</span>).
To remove the comment, select the lines and choose <em class=
-"c9">Format</em><span class="lmsy-10x-x-120">→</span><em class=
-"c9">Uncomment</em><a id="dx20-26002" name="dx20-26002"></a> or
+"c16">Format</em><span class="lmsy-10x-x-120">→</span><em class=
+"c16">Uncomment</em><a id="dx20-26002" name="dx20-26002"></a> or
<span class="keystroke">Ctrl</span><span class="keystroke">Shift
<span class="lmsy-10x-x-120">⇑</span></span><span class=
"keystroke">[</span> (macOS: <span class="keystroke"><img src=
-"images/MacCmdKey.png" alt="pict" /></span><span class=
-"keystroke">Shift <span class=
+"images//MacCmdKey-.png" alt="PIC" class=
+"c17" /></span><span class="keystroke">Shift <span class=
"lmsy-10x-x-120">⇑</span></span><span class=
"keystroke">[</span>).<span class="footnote-mark"><a href=
"index27.html#fn7x5"><sup class=
@@ -538,26 +557,26 @@ To remove the comment, select the lines and choose <em class=
"x20-26003f7"></a></p>
<h4 class="subsectionHead"><span class="titlemark">4.5.3</span>
<a id="x20-270004.5.3" name="x20-270004.5.3"></a>Matching
-delimiters</h4><!--l. 135-->
+delimiters</h4><!--l. 136-->
<p class="noindent">A frequent error is to forget a closing symbol:
parenthesis, bracket, square bracket, <em>etc</em>.
T<sub>E</sub>Xworks helps with a tool to show the pairs of symbols:
when the cursor moves over one of these symbols, its partner is
briefly highlighted. You can also select an entire block<a id=
"dx20-27001" name="dx20-27001"></a> using <em class=
-"c9">Edit</em><span class="lmsy-10x-x-120">→</span><em class=
-"c9">Balance Delimiters</em> or by the shortcut <span class=
+"c16">Edit</em><span class="lmsy-10x-x-120">→</span><em class=
+"c16">Balance Delimiters</em> or by the shortcut <span class=
"keystroke">Ctrl</span><span class="keystroke">B</span> (macOS:
-<span class="keystroke"><img src="images/MacCmdKey.png" alt=
-"pict" /></span><span class="keystroke">B</span>). Thus, you will
-immediately see the scope of the block. <!--l. 137--></p>
+<span class="keystroke"><img src="images//MacCmdKey-.png" alt="PIC"
+class="c17" /></span><span class="keystroke">B</span>). Thus, you
+will immediately see the scope of the block. <!--l. 138--></p>
<p class="noindent"></p>
<h4 class="subsectionHead"><span class="titlemark">4.5.4</span>
<a id="x20-280004.5.4" name="x20-280004.5.4"></a>Smart quotes</h4>
-<!--l. 139-->
+<!--l. 140-->
<p class="noindent">Another similar error, but this time semantic
and not hindering typesetting, is in the use of quotes when one
-wants to give focus to some text. <!--l. 141--></p>
+wants to give focus to some text. <!--l. 142--></p>
<p class="indent">There are two types of quotation marks in
English: the ‘single’ quotes and the “double” quotes. They are
formed by ‘ and ’; these are not the quotation marks used in
@@ -566,51 +585,50 @@ programming and found on the keyboard: <span class=
"obeylines-h verb ts1-lmtt12-">'</span>. Using the
T<sub>E</sub>Xworks smart quotes system, one can use the latter as
normal to automatically produce the typographically correct
-single/double opening and close quotes. <!--l. 143--></p>
+single/double opening and close quotes. <!--l. 144--></p>
<p class="indent">In a <span class="path">.tex</span> document,
-select one of the smart quotes system: <em class="c9">Format</em>
-<span class="lmsy-10x-x-120">→</span><em class="c9">Smart
-Quotes</em><span class="lmsy-10x-x-120">→</span><em class="c9">TeX
-Ligatures</em>, <span class="lmsy-10x-x-120">→</span><em class=
-"c9">TeX Commands</em>, <span class=
-"lmsy-10x-x-120">→</span><em class="c9">Unicode Characters</em>.
-Then, when you want to start a quoted section in your text, let’s
-say enclosed in double quotes, type <span class=
-"obeylines-h verb ec-lmtt-12">"</span>, then the text to be quoted,
-and finish again by <span class=
+select one of the smart quotes system: <em class=
+"c16">Format</em><span class="lmsy-10x-x-120">→</span><em class=
+"c16">Smart Quotes</em><span class=
+"lmsy-10x-x-120">→</span><em class="c16">TeX Ligatures</em>,
+<span class="lmsy-10x-x-120">→</span><em class="c16">TeX
+Commands</em>, <span class="lmsy-10x-x-120">→</span><em class=
+"c16">Unicode Characters</em>. Then, when you want to start a
+quoted section in your text, let’s say enclosed in double quotes,
+type <span class="obeylines-h verb ec-lmtt-12">"</span>, then the
+text to be quoted, and finish again by <span class=
"obeylines-h verb ec-lmtt-12">"</span>; T<sub>E</sub>Xworks will
automatically insert the correct opening quotes <span class=
"obeylines-h verb ts1-lmtt12-">``</span> and later the correct
closing ones <span class="obeylines-h verb ts1-lmtt12-">''</span>.
The three options give the same result in the typeset document, but
-<em class="c9">TeX Ligatures</em> should work best in most cases.
-<!--l. 145--></p>
+<em class="c16">TeX Ligatures</em> should work best in most cases.
+<!--l. 146--></p>
<p class="indent">Finally, it is possible to define personal
quotation marks systems (in the file <span class=
"path">smart-quotes-modes.txt</span> in the <span class=
"path">configuration</span> folder of the resource folder).
-<!--l. 147--></p>
+<!--l. 148--></p>
<p class="noindent"></p>
<h3 class="sectionHead"><span class="titlemark">4.6</span> <a id=
"x20-290004.6" name="x20-290004.6"></a>Auto-completion</h3><a id=
-"dx20-29001" name="dx20-29001"></a> <!--l. 149-->
+"dx20-29001" name="dx20-29001"></a> <!--l. 150-->
<p class="noindent">Another tool which rapidly becomes
indispensable is auto-completion. Indeed, when you use
(L<sup>A</sup>)T<sub>E</sub>X, you have to continuously enter codes
to, for example, create environments; you also have to remember to
-close every group you open. <!--l. 151--></p>
+close every group you open. <!--l. 152--></p>
<p class="indent">Auto-completion allows you to type a keyword, hit
the <span class="keystroke msam-10x-x-120">⇆</span> key, and have
T<sub>E</sub>Xworks insert the (L<sup>A</sup>)T<sub>E</sub>X
-command or environment code automatically. <!--l. 153--></p>
-<p class="indent">As an example to insert
-“L<sup>A</sup>T<sub>E</sub>X”, we have to type <span class=
-"obeylines-h verb ec-lmtt-12">\LaTeX</span>. This is not difficult,
-but entering “<span class="obeylines-h verb ec-lmtt-12">\</span>”
-followed by the word “<span class=
-"obeylines-h verb ec-lmtt-12">LaTeX</span>” with alternating
-capitals and lower case letters could become annoying after a
-while.<span class="footnote-mark"><a href=
+command or environment code automatically. <!--l. 154--></p>
+<p class="indent">As an example to insert “LaTeX”, we have to type
+<span class="obeylines-h verb ec-lmtt-12">\LaTeX</span>. This is
+not difficult, but entering “<span class=
+"obeylines-h verb ec-lmtt-12">\</span>” followed by the word
+“<span class="obeylines-h verb ec-lmtt-12">LaTeX</span>” with
+alternating capitals and lower case letters could become annoying
+after a while.<span class="footnote-mark"><a href=
"index28.html#fn8x5"><sup class=
"textsuperscript">8</sup></a></span><a id="x20-29002f8" name=
"x20-29002f8"></a> With auto-completion, you just enter
@@ -621,40 +639,38 @@ care that there is no <em>letter</em> directly preceding or
succeeding <span class=
"obeylines-h verb ec-lmtt-12">latex</span>—e.g., <span class=
"obeylines-h verb ec-lmtt-12">alatex</span>—, or else the mechanism
-might not pick up the correct keyword. <!--l. 156--></p>
+might not pick up the correct keyword. <!--l. 157--></p>
<p class="indent">Another example is <span class=
"obeylines-h verb ec-lmtt-12">bmin</span>, which gives</p>
-<div class="fancyvrb" id="fancyvrb8">
-<a id="x20-29004r1" name="x20-29004r1"></a><span class=
-"ec-lmtt-10x-x-109">\begin{minipage}{}</span><br class=
-"fancyvrb" />
+<pre class="fancyvrb" id="fancyvrb8" xml:space="preserve"><a id=
+"x20-29004r1" name="x20-29004r1"></a><span class=
+"ec-lmtt-10x-x-109">\begin{minipage}{}</span>
<a id="x20-29006r2" name="x20-29006r2"></a><span class=
-"ts1-lmtt10-x-x-109">∙</span><br class="fancyvrb" />
+"ts1-lmtt10-x-x-109">∙</span>
<a id="x20-29008r3" name="x20-29008r3"></a><span class=
"ec-lmtt-10x-x-109">\end{minipage}</span><span class=
-"ts1-lmtt10-x-x-109">∙</span>
-</div><!--l. 162-->
+"ts1-lmtt10-x-x-109">∙</span></pre><!--l. 163-->
<p class="noindent">with the cursor between the empty pair of curly
brackets where you need to enter the size of the minipage. See the
-section <a href="CustomizingTw.html#x37-51000A.3">A.3
+section <a href="CustomizingTw.html#x37-53000A.3">A.3
<!--tex4ht:ref: sec.autocompletion --></a> for a list of the
keywords for auto-completion. Notice the “<span class=
"ts1-lmr12-">∙</span>” in the minipage environment. They are
placeholders which can be reached by <span class=
"keystroke">Ctrl</span><span class=
"keystroke msam-10x-x-120">⇆</span> ( <span class=
-"keystroke"><img src="images/MacOptKey.png" alt=
-"pict" /></span><span class="keystroke msam-10x-x-120">⇆</span> on
+"keystroke"><img src="images//MacOptKey-.png" alt="PIC" class=
+"c19" /></span><span class="keystroke msam-10x-x-120">⇆</span> on
the Mac), repeating this shortcut cycles forward through the
placeholders; by <span class="keystroke">Ctrl</span><span class=
"keystroke">Shift <span class=
"lmsy-10x-x-120">⇑</span></span><span class=
"keystroke msam-10x-x-120">⇆</span> ( <span class=
-"keystroke"><img src="images/MacOptKey.png" alt=
-"pict" /></span><span class="keystroke">Shift <span class=
+"keystroke"><img src="images//MacOptKey-.png" alt="PIC" class=
+"c19" /></span><span class="keystroke">Shift <span class=
"lmsy-10x-x-120">⇑</span></span><span class=
"keystroke msam-10x-x-120">⇆</span>), you can also cycle backwards.
-<!--l. 164--></p>
+<!--l. 165--></p>
<p class="indent">If a partial keyword is given, repeatedly hitting
<span class="keystroke msam-10x-x-120">⇆</span> will cycle through
possible completions. For example, <span class=
@@ -679,19 +695,17 @@ which start by <span class=
"obeylines-h verb ec-lmtt-12">baliats</span>, <span class=
"obeylines-h verb ec-lmtt-12">balied</span>, <span class=
"obeylines-h verb ec-lmtt-12">baliedat</span> and <span class=
-"obeylines-h verb ec-lmtt-12">baliedato</span>). <!--l. 166--></p>
+"obeylines-h verb ec-lmtt-12">baliedato</span>). <!--l. 167--></p>
<p class="indent">If you want to create your own keywords, you can
add a <span class="path">.txt</span> file in the <span class=
"path">completion</span> folder inside the resources folder. The
entries in the file should have the following format:</p>
-<div class="fancyvrb" id="fancyvrb9">
-<a id="x20-29010r1" name="x20-29010r1"></a><span class=
-"ec-lmtt-10x-x-109">bfigo:=\begin{figure}[#INS#]#RET##RET#\end{figure}</span><span class="ts1-lmtt10-x-x-109">∙</span><br class="fancyvrb" />
-
+<pre class="fancyvrb" id="fancyvrb9" xml:space="preserve"><a id=
+"x20-29010r1" name="x20-29010r1"></a><span class=
+"ec-lmtt-10x-x-109">bfigo:=\begin{figure}[#INS#]#RET##RET#\end{figure}</span><span class="ts1-lmtt10-x-x-109">∙</span>
<a id="x20-29012r2" name="x20-29012r2"></a><span class=
"ec-lmtt-10x-x-109">\bibliography{#INS#}</span><span class=
-"ts1-lmtt10-x-x-109">∙</span>
-</div><!--l. 172-->
+"ts1-lmtt10-x-x-109">∙</span></pre><!--l. 173-->
<p class="indent">In the first case, <span class=
"obeylines-h verb ec-lmtt-12">bfigo</span> is the assigned keyword
(with <span class="obeylines-h verb ec-lmtt-12">:=</span>) to be
@@ -704,17 +718,155 @@ and the cursor is placed between the square brackets (at the
position of <span class=
"obeylines-h verb ec-lmtt-12">#INS#</span>). “<span class=
"ts1-lmr12-">∙</span>” is a place holder as introduced before.
-<!--l. 174--></p>
+<!--l. 175--></p>
<p class="indent">In the second case, we give ourselves a shortcut,
which will let us type the first part of <span class=
"obeylines-h verb ec-lmtt-12">\bibliography{}</span> and have
T<sub>E</sub>Xworks convert it to the full name plus braces (with
the cursor between them). In this case, the keyword is the
-instruction itself. <!--l. 176--></p>
+instruction itself. <!--l. 177--></p>
<p class="indent">Note that the <span class="path">.txt</span> file
containing the auto-completion information needs to be UTF-8
encoded—this is the default encoding for all files created with
-T<sub>E</sub>Xworks. <!--l. 5--></p>
+T<sub>E</sub>Xworks.</p>
+<h3 class="sectionHead"><span class="titlemark">4.7</span> <a id=
+"x20-300004.7" name="x20-300004.7"></a>Citations &amp;
+References</h3><a id="dx20-30001" name="dx20-30001"></a> <a id=
+"dx20-30002" name="dx20-30002"></a> <!--l. 181-->
+<p class="noindent">Referencing other works is common practice,
+particularly in scientific writing. A common way for doing this in
+(L<sup>A</sup>)T<sub>E</sub>X is to use a bibliography database (in
+<span class="ec-lmcsc-10x-x-120">Bib</span>T<sub>E</sub>X format)
+together with a program such as <span class=
+"ec-lmcsc-10x-x-120">Bib</span>T<sub>E</sub>X or biber for
+extracting the necessary bibliographic data for typesetting. For
+inserting citations, typically a command such as <span class=
+"obeylines-h verb ec-lmtt-12">\cite{dkn1}</span> is used, where
+<span class="obeylines-h verb ec-lmtt-12">dkn1</span> is the unique
+<span class="ec-lmcsc-10x-x-120">Bib</span>T<sub>E</sub>X-key
+associated with the work to cite. <!--l. 183--></p>
+<p class="indent">As is apparent from the example above,
+<span class="ec-lmcsc-10x-x-120">Bib</span>T<sub>E</sub>X-keys are
+not always self-explanatory or easy to remember, particularly when
+working with large bibliography databases with hundreds of entries.
+For that reason, T<sub>E</sub>Xworks has a built-in dialog to
+facilitate working with citations. Before it can be used, however,
+you have to make sure a special comment (see sec.&nbsp;<a href=
+"GoingfurtherOthertools.html#x29-340005.2">5.2
+<!--tex4ht:ref: sec.special_comments --></a>) such as the following
+is present at the top of your file:</p>
+<pre class="fancyvrb" id="fancyvrb10" xml:space="preserve"><a id=
+"x20-30004r1" name="x20-30004r1"></a><span class=
+"ec-lmtt-10x-x-109">%</span><span class=
+"ec-lmtt-10x-x-109"> !TeX</span><span class=
+"ec-lmtt-10x-x-109"> bibfiles</span><span class=
+"ec-lmtt-10x-x-109"> =</span><span class=
+"ec-lmtt-10x-x-109"> file1.bib,file2.bib</span></pre><!--l. 187-->
+<p class="noindent">Here, <span class=
+"obeylines-h verb ec-lmtt-12">file1.bib</span> and <span class=
+"obeylines-h verb ec-lmtt-12">file2.bib</span> are examples of
+bibliography database files (of course you can also specify one, or
+three, or more files). Note that the special comment has to be
+present in the file you are working on (having it in another file,
+such as the root file, currently doesn’t work). <!--l. 189--></p>
+<p class="indent">When the special comment is present, use
+<em class="c16">Edit</em><span class=
+"lmsy-10x-x-120">→</span><em class="c16">Insert Citations…</em> to
+open the citations dialog box:</p>
+<div class="center">
+<!--l. 190-->
+<p class="noindent"><!--l. 191--></p>
+<p class="noindent"><img src="images//citationsDialog.png" alt=
+"PIC" class="c20" /></p>
+</div><!--l. 194-->
+<p class="indent">This screenshots shows an example using the
+bibliography database used for typesetting this manual. It shows a
+list of authors, titles, publication years (and journals in case of
+articles) for all database entries. The list can be filtered
+conveniently by using the “Filter…” textbox at the top. Then, you
+simply select the items you want to cite, and hit “OK”. This will
+insert a new <span class="obeylines-h verb ec-lmtt-12">\cite</span>
+command with a comma-separated list of the <span class=
+"ec-lmcsc-10x-x-120">Bib</span>T<sub>E</sub>X-keys of all the items
+you selected. <!--l. 196--></p>
+<p class="indent">If you position the cursor inside an existing
+<span class="obeylines-h verb ec-lmtt-12">\cite</span> command, the
+dialog will automatically check the cited items. You can uncheck
+items or check additional entries, hit “OK”, and
+T<sub>E</sub>Xworks will automatically update the list of
+<span class="ec-lmcsc-10x-x-120">Bib</span>T<sub>E</sub>X-keys in
+the existing <span class="obeylines-h verb ec-lmtt-12">\cite</span>
+command accordingly. <!--l. 198--></p>
+<p class="noindent"></p>
+<h4 class="subsectionHead"><span class="titlemark">4.7.1</span>
+<a id="x20-310004.7.1" name="x20-310004.7.1"></a>Customizing the
+“Insert Citations…” dialog</h4><!--l. 199-->
+<p class="noindent">There are two aspects of the “Insert
+Citations…” dialog that can be customized, if necessary. However,
+this customization is intended solely for expert users, as it is
+not included in the normal preferences dialog but instead involves
+manually editing configuration files. To figure out where settings
+are stored, use <em class="c16">Help</em> <span class=
+"lmsy-10x-x-120">→</span><em class="c16">Settings and
+Resources…</em>. <!--l. 201--></p>
+<p class="indent"></p>
+<div class="OSspecific">
+<div class="OSspecificLogo OSWindows"></div>On Windows, the
+settings are stored in the registry by default. It is <em>not
+recommended</em> to modify the registry, as mistakes may damage the
+system. In such situations, it is recommended to use
+T<sub>E</sub>Xworks’s portable mode instead (see sec.&nbsp;<a href=
+"GoingfurtherOthertools.html#x29-390005.7">5.7
+<!--tex4ht:ref: sec.portable_configuration --></a>).
+</div><!--l. 205-->
+<p class="indent">To customize which <span class=
+"ec-lmcsc-10x-x-120">Bib</span>T<sub>E</sub>X fields are shown in
+the dialog, set the <span class=
+"obeylines-h verb ec-lmtt-12">citationDialogBibTeXFields</span>
+configuration value to a semi-colon separated list of
+(case-insensitive) <span class=
+"ec-lmcsc-10x-x-120">Bib</span>T<sub>E</sub>X field names, e.g.</p>
+<pre class="fancyvrb" id="fancyvrb11" xml:space="preserve"><a id=
+"x20-31002r1" name="x20-31002r1"></a><span class=
+"ec-lmtt-10x-x-109">citationDialogBibTeXFields="Type;Author;Title;Year;Journal"</span></pre><!--l. 209-->
+<p class="noindent">The following field names are handled
+specially:</p>
+<dl class="description">
+<dt class="description"><!--l. 211--><br class="noindent" />
+<span class="ec-lmbx-12">Key</span></dt>
+<dd class="description">
+<!--l. 211-->
+<p class="noindent">displays the <span class=
+"ec-lmcsc-10x-x-120">Bib</span>T<sub>E</sub>X keys</p>
+</dd>
+<dt class="description"><!--l. 212--><br class="noindent" />
+<span class="ec-lmbx-12">Type</span></dt>
+<dd class="description">
+<!--l. 212-->
+<p class="noindent">displays the entry type (e.g., article, book,
+phdthesis, …)</p>
+</dd>
+<dt class="description"><!--l. 213--><br class="noindent" />
+<span class="ec-lmbx-12">Journal</span></dt>
+<dd class="description">
+<!--l. 213-->
+<p class="noindent">displays the first non-empty field out of
+“howpublished”, “journal”, and “booktitle”</p>
+</dd>
+</dl><!--l. 216-->
+<p class="indent">To customize which citation command is inserted
+by default, set the <span class=
+"obeylines-h verb ec-lmtt-12">citeCommand</span> configuration
+value in the following way:</p>
+<pre class="fancyvrb" id="fancyvrb12" xml:space="preserve"><a id=
+"x20-31004r1" name="x20-31004r1"></a><span class=
+"ec-lmtt-10x-x-109">citeCommand="\cite{%1}"</span></pre>
+<!--l. 220-->
+<p class="noindent">where %1 will be replaced by a comma-separated
+list of <span class=
+"ec-lmcsc-10x-x-120">Bib</span>T<sub>E</sub>X-keys. Note that this
+command is not used when updating an existing citation command
+(which will be preserved). <!--l. 5--></p>
<div class="crosslinks">
<p class="noindent">[<a href=
"GoingfurtherOthertools.html">next</a>] [<a href=