summaryrefslogtreecommitdiff
path: root/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/manual006.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/manual006.html')
-rw-r--r--Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/manual006.html78
1 files changed, 0 insertions, 78 deletions
diff --git a/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/manual006.html b/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/manual006.html
deleted file mode 100644
index fcede844c35..00000000000
--- a/Master/tlpkg/texworks/texworks-help/TeXworks-manual/en/manual006.html
+++ /dev/null
@@ -1,78 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
- "http://www.w3.org/TR/REC-html40/loose.dtd">
-<HTML>
-<HEAD>
-
-<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<META name="GENERATOR" content="hevea 1.10">
-<LINK rel="stylesheet" type="text/css" href="manual.css">
-<TITLE>Going further: Other tools</TITLE>
-</HEAD>
-<BODY >
-<A HREF="manual005.html"><IMG SRC="previous_motif.gif" ALT="Previous"></A>
-<A HREF="index.html"><IMG SRC="contents_motif.gif" ALT="Up"></A>
-<A HREF="manual007.html"><IMG SRC="next_motif.gif" ALT="Next"></A>
-<HR>
-<table width="80%" align="center" >
- <tr>
- <td><H2 CLASS="section"><A NAME="htoc28">5</A>  Going further: Other tools</H2><H3 CLASS="subsection"><A NAME="toc15"></A><A NAME="htoc29">5.1</A>  SyncTeX-ing<A NAME="@default87"></A> between source and preview</H3><P>
-<A NAME="psourvue"></A></P>
-<P>When you are reading a document in preview and see something to change, it is convenient to go immediately to the same place in the source. To do that, hold down <CODE>[Ctrl]</CODE> (Mac OS X <CODE>[Cmd]</CODE>) and click at the appropriate place in the preview window: the cursor will jump and highlight the same location in the source window. The same is true in the other direction: <CODE>[Ctrl]+[click]</CODE> in the source will highlight the same line in the preview window.
-
-
- It is also possible to use a [Right-click] to open a context window and select &ldquo;jumpt to PDF&rdquo;' or &ldquo;jump to source&rdquo;'.</P>
-<P>Here a remark for users under Windows: this only works if <B>all</B> the names for folders/files/…do <B>not</B> have accented characters. If, for example, your document is in <TT>C:\Documents and Settings\Propriétaire\My Documents\thesis</TT> it will not work because of the <CODE>é</CODE> of <TT>Propriétaire</TT>!</P>
-<H3 CLASS="subsection"><A NAME="toc16"></A><A NAME="htoc30">5.2</A>  Special comment strings</H3><P>Special comments, at the very beginning of the files, can be used to manage two other aspects of the compilation. By default, T<sub>E</sub>Xworks uses the “utf8” encoding for saving files, but some files could be saved in another format. To ask another encoding<A NAME="@default88"></A> for a specific file one can put at the beginning of this file:</P><P><CODE>% !TeX encoding = latin1</CODE> : another encoding often used.
-<A NAME="@default89"></A></P><P>If we want to compile a file with another programme<A NAME="@default90"></A> than the default T<sub>E</sub>X or L<sup>A</sup>T<sub>E</sub>X, we put at the beginning of the file:</P><P><CODE>% !TeX program = the_programme</CODE>
-<A NAME="@default91"></A>
-for example:</P><P><CODE>% !TeX program = xelatex</CODE></P>
-<P>Pay attention about this last instruction: you have to use here the name of the programme which should be used for the whole project, as it is the programme name which is first encountered when starting typesetting (the one from the sub-document in which you are), T<sub>E</sub>Xworks will use that programme, even if another name appears in the main document!</P>
-<P>When opening a document with a specified programme name, this will become the programme to use (its name will appear in the drop down menu in the Tools bar); but if you then manually change the programme, it is the one shown in the drop down menu which will be used.</P>
-<H3 CLASS="subsection"><A NAME="toc17"></A><A NAME="htoc31">5.3</A>  Formatting the source for legibility</H3>
-<P>To facilitate legibility of the source, one can use indentation<A NAME="@default92"></A> as programmers do:
-</P>
-<PRE CLASS="verbatim">\begin{itemize}
- \item First element of the list;
- \item second element;
- \item last element:
- \begin{itemize} % beginning of a sub-list
- \item first sub-element;
- \item second sub-element.
- \end{itemize}
-\end{itemize}
-</PRE>
-<P>this increases legibility, but works well only on short lines, without text wrapping; or if one chooses not to use text wrapping by un-checking <I><FONT COLOR=maroon><B>Format / Wrap lines</B></FONT></I><A NAME="@default93"></A>.</P>
-<P>The command <I><FONT COLOR=maroon><B>Format / Indent</B></FONT></I> or the short-cut “<CODE>Ctrl+]</CODE>” (Mac OS X “<CODE>Cmd+]</CODE>”) will indent the line, or the selected lines, by inserting a tab character. You can repeat the process to increase the indent. </P><P>To remove one indentation: <I><FONT COLOR=maroon><B>Format / Unindent</B></FONT></I> or the short-cut “<CODE>[Ctrl+[</CODE>” (“<CODE>Cmd+[</CODE>” on Mac OS X) <SUP><A NAME="text19" HREF="manual010.html#note19">18</A></SUP>.</P>
-<P>As <I><FONT COLOR=maroon>indent</FONT></I> only indents the first line of multiline (if wrapped) lines, this is not very satisfactory. But one can ask T<sub>E</sub>Xworks to split a long line (longer than the width of the editing panel) into short ones adding a hard coded line feed: <EM><B>Format / Hard Wrap...</B></EM><A NAME="@default94"></A> opens a dialog box in which you can specify the width of the lines; you can also re-format lines which have already been split.</P>
-<DIV CLASS="center">
-<IMG SRC="HardWrap.jpeg" width="283" height="219"></DIV>
-<H3 CLASS="subsection"><A NAME="toc18"></A><A NAME="htoc32">5.4</A>  Showing the tags<A NAME="@default95"></A></H3><P>When a document is becoming long and you want to move to a specific place (a chapter, a section, a sub-section, …)<A NAME="@default96"></A> you need to scroll the editing window to find the desired location.</P>
-<P>You can also use the structural information in the document to navigate the source: <I><FONT COLOR=maroon><B>Window / Show / Tags</B></FONT></I> opens a panel showing the information detected by T<sub>E</sub>Xworks. Clicking on an item in the panel selects the corresponding part of the source. That panel, like any other, can be resized by dragging its border.<br>
-</P>
-<P>The same action is possible in the .pdf window from <I><FONT COLOR=maroon><B>Window / Show / Table of contents</B></FONT></I><A NAME="@default97"></A>, but this only works if one has created structure tags in the .pdf file using the package <CODE>hyperref</CODE>.</P><H3 CLASS="subsection"><A NAME="toc19"></A><A NAME="htoc33">5.5</A>  Organising the windows<A NAME="@default98"></A></H3><P>By default, the editor/source window opens on the left and the preview one on the right (when the corresponding PDF file exists), thus splitting the screen in two.</P><P>You can change the position of the windows in the menu <I><FONT COLOR=maroon><B>Window</B></FONT></I>. <I><FONT COLOR=maroon><B>Stack</B></FONT></I> and <I><FONT COLOR=maroon><B>Side by side</B></FONT></I> give the same effect if there is only one document open, if not, <I><FONT COLOR=maroon>Stack</FONT></I> creates a mosaic with all the windows. The other options allow to place the windows for your convenience. It is also always possible to resize and move the windows.</P><P>For the preview you can change the way it is presented and of course the zoom by <I><FONT COLOR=maroon><B>Actual size</B></FONT></I>, <I><FONT COLOR=maroon><B>Fit to width</B></FONT></I> and <I><FONT COLOR=maroon><B>Fit to window</B></FONT></I> using the options of the <I><FONT COLOR=maroon><B>View</B></FONT></I> menu; you can also zoom <B>in</B> and <B>out</B>. Shortcuts exist for all these actions and are shown next to the option in the menu.</P><H3 CLASS="subsection"><A NAME="toc20"></A><A NAME="htoc34">5.6</A>  Cleaning the working folder<A NAME="@default99"></A></H3><P>Very soon when one uses (L<sup>A</sup>)T<sub>E</sub>X, one discovers that the working folder is cluttered by many files which have the name of the source file but different extensions: <CODE>.aux</CODE>, <CODE>.log</CODE>, <CODE>.toc</CODE>, <CODE>.lof</CODE>, <CODE>.lot</CODE>, <CODE>.bbl</CODE>,…</P>
-<P>All these are files needed by (L<sup>A</sup>)T<sub>E</sub>X to be able to create the table of contents, lists of figures/tables, the bibliography, the cross references and, also very important, to keep track of what it did (the .log file).</P>
-<P>Apart from the external files, images, pictures,…, the only files required are the <CODE>.tex</CODE> files, the sources of the document. One can erase all the others.</P><P>This can be done using a T<sub>E</sub>Xworks command from the <I><FONT COLOR=maroon><B>File</B></FONT></I> menu: <I><FONT COLOR=maroon><B>Remove Aux files</B></FONT></I><A NAME="@default100"></A><I><FONT COLOR=maroon><B>…</B></FONT></I>.</P><P>When you ask for this command, a dialog box opens in which you can check/uncheck the files you want to remove <SUP><A NAME="text20" HREF="manual010.html#note20">19</A></SUP>; you have the choice for <TT>aux</TT>, <TT>log</TT>, <TT>toc</TT> and others depending of what you did. If you already removed some of these files, the choices may differ in the dialog box; if you removed all, you get a message box saying that there is no file to remove at the moment.</P>
-<P>The list of auxilliary files which are shown is in the file <TT>texworks-config.txt</TT><A NAME="@default101"></A> in the <TT>configuration</TT> folder of the T<sub>E</sub>Xworks resources folder. You could add some if required.
-</P>
-<H3 CLASS="subsection"><A NAME="toc21"></A><A NAME="htoc35">5.7</A>  Changing the configuration<A NAME="@default102"></A></H3>
-<P>We have seen in section <A HREF="manual003.html#insta">2</A> that at first use T<sub>E</sub>Xworks creates a resource folder in <TT>home</TT> (variable on the different systems) and also that it saves preference information (under Windows in a registry key).</P>
-<P>But it is possible to define a personal place where one wants the resource folder and the preferences. This can be handy when one wants a portable system or when one wants to easily access the templates or completion folders for modifications.</P><P>For this create in the programme folder a file <TT>texworks-setup.ini</TT><A NAME="@default103"></A> in which one specifies the path to the folder containing the completion, configuration, dictionaries,…folder and the configuration file (<TT>texworks.ini</TT><A NAME="@default104"></A>); there will be two lines:
-</P><PRE CLASS="verbatim">inipath=C:/myfolder/TW_conf/\index{configuration!inipath}
-libpath=C:/myfolder/TW_conf/\index{configuration!libpath}
-</PRE>
-<P><TT>inipath</TT> for the configuration file and <TT>libpath</TT> for the necessary folders. Here <TT>TW_conf</TT> would replace the resource folder <TT>TeXworks</TT>. Notice first that the referenced folder (here <TT>TW_conf</TT>) should exist, it will not be created, and second the use of <CODE>/</CODE> and not the backslash generally used under Windows.</P>
-<P>If one wants to put the resource folder in the programme folder, as a sub-folder, one can use an instruction like <TT>&ldquo;inipath=./TW_conf/</TT>&rdquo;; this reference and the other relative references are always related to the T<sub>E</sub>Xworks programme folder.</P>
-<P>One could add a first line:<BR>
-<TT>defaultbinpaths=C:/Program Files/MiKTeX 2.7/miktex/bin
-</TT><A NAME="@default105"></A><BR>
-to specify where are the programmes of the T<sub>E</sub>X distribution; but this instruction is not yet completely operational, especially under Windows.
-</P>
- </td>
- </tr>
-</table>
-<HR>
-<A HREF="manual005.html"><IMG SRC="previous_motif.gif" ALT="Previous"></A>
-<A HREF="index.html"><IMG SRC="contents_motif.gif" ALT="Up"></A>
-<A HREF="manual007.html"><IMG SRC="next_motif.gif" ALT="Next"></A>
-</BODY>
-</HTML>