<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Ktexmaker : user manual</title><style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #004faf; text-decoration: none }body { background: white; color: black; }
--></style></head><body bgcolor="#ffffff">
<h1 align=center><A NAME="top"><font face="sans-serif">Ktexmaker2 : User Manual</a></font></h1>
<table width="100%"><tr bgcolor=#A2C511><td align="center"><b><font face="sans-serif" size="+2">The LaTeX editor </font> </b></td></tr></table>
<font face="sans-serif">The </font><b><font color="#805417" face="sans-serif">K</font></b><font face="sans-serif">texmaker2 editor is a "multi-document" version of Kwrite for ".tex" and ".bib" files (and only for these files!).
For all the classical editor's functionality, see the Kwrite Handbook.</font>
<BR>
<P>
<font face="sans-serif">In addition to normal editors, </font><b><font color="#805417" face="sans-serif">K</font></b><font face="sans-serif">texmaker2 contains specific commands to make easier the edition of LaTeX source code :</font>
<UL>
<LI><font face="sans-serif">With the "LaTeX", "Math" and "Greek" menus, you can insert the principal LaTeX tags. (a contextual help is displayed in the "about" frame)</font>
</LI>
<LI><font face="sans-serif">The "Wizard" menu can generate the code for "tabular" and "array" environments.</font>
</LI>
<LI><font face="sans-serif">The "User" menu enables you to insert 10 personnal "fragments" of LaTeX source code. (Use the "Edit user menu" command to define them)</font>
</LI>
<LI><font face="sans-serif">The standard Bibtex entry types can be inserted in the ".bib" file with the "Bibliography" menu.</font>
</LI>
<LI><font face="sans-serif">A "structure view" of the document makes easier the navigation into the current file .
By clicking on an item, you can jump directly to the the corresponding part of your document
(except for "input" and "include" items - see below).<br>
The "structure view" is not automatically refreshed : use the "Refresh Structure" command if it's necessary.
You can choose your own criteria to create the "structure view" with the "Change Structure View items" command in the "Options" menu.</font>
</LI>
<LI><font face="sans-serif">A large documentation about LaTeX (html format) is available (menu "Help" -> "LaTeX Reference").<br>
To navigate into this documentation, use the "Back", "Forward" and "Index" buttons
(click on the "Return to Editor View" button to display again the editor).</font>
</LI>
<LI><font face="sans-serif">A table of the LaTeX Math symbols can be displayed with the "Table of maths symbols" command in the "Help" menu
(click on the "Return to Editor View" button to display again the editor).</font>
</LI>
</UL>
<table width="100%"><tr bgcolor=#A2C511><td align="center"><b><font face="sans-serif" size="+2">The TeX shell </font> </b></td></tr></table>
<b><font color="#805417" face="sans-serif">K</font></b><font face="sans-serif">texmaker2 enables you to launch easily the LaTeX-related programs via the "Tools" menu or the toolbar buttons with the following features :</font>
<UL>
<LI><font face="sans-serif">The current TeX file is automatically saved before launching external programs.</font>
</LI>
<LI><font face="sans-serif">To have a quick preview of your document, use the "Compile" button : your document is compiled with LaTeX
in the "latex" mode and with PdfLaTeX in the "pdflatex" mode (you can change the current mode with the "Options" menu).<br>
Then, use the "Preview" button to display the postscript file in the "latex" mode (the "dvitops" command is launched automatically before by the program)
and the pdf file in the "pdflatex" mode. (click on the "Return to Editor View" button
to display again the editor).</font>
</LI>
<LI><font face="sans-serif">After the compilation, you can display the log file by clicking on the "view log" button. Then, the "Next
LaTeX error" and "Previous LaTeX error" commands let you reach the errors detected in the log file. By clicking on the
number of a line in the "Message/Log File" frame, the cursor jumps to the corresponding line in the editor.</font>
</LI>
<LI><font face="sans-serif">The DVI file is displayed by "Kdvi" in the "KDE" mode and "Xdvi" in the "X" mode. For the postscript file,
</font><b><font color="#805417" face="sans-serif">K</font></b><font face="sans-serif">texmaker2 uses "Kghostview" in the "KDE" mode and "GV" in the "X" mode. The current mode is displayed in the status bar.
The "Options" menu enables you to change the mode.</font>
</LI>
<LI><font face="sans-serif">The "latex", "pdflatex", "dvips", "ps2pdf", "latex2html", "makeindex" and "bibtex" commands are launched via the "TeX Terminal".
For "latex2html", the program lets you enter some options before launching this command.</font>
</LI>
<LI><font face="sans-serif">The "TeX Terminal" allows you to launch commands which are not included in the "Tools" menu.
The bash variables (texname, dviname...) are generated automatically by </font><b><font color="#805417" face="sans-serif">K</font></b><font face="sans-serif">texmaker2 . So, you don't need to type the full files names.<br>
(See the "About" frame in this context, for more details)
</font>
</LI>
<LI><font face="sans-serif">With the "Clean" command, you can delete the output files ('.aux', '.log' ...) generated by the compilation of the current document.</font>
</LI>
</UL>
<table width="100%"><tr bgcolor=#A2C511><td align="center"><b><font face="sans-serif" size="+2">For the documents divided into several files</font> </b></td></tr></table>
<UL>
<LI><font face="sans-serif">Open the "master" document and then, select the "Multi" mode ("Options" menu).
</font>
</LI>
<LI><font face="sans-serif">In this mode, all the commands of the "Tools" menu use your "master" document (even if you select an other document) and
the log file of the "master" document (displayed in the "Messages/Log File" frame) is not cleared
when you select an other document. So, you can reach lines in the "children" files by clicking on their numbers
in the log file. (you must select the corresponding file manually in the "editor view" before).<br>
The name of the "master" document is displayed in the staus bar.<br>
To return to a "normal" configuration, select the "Single" mode.
</font>
</LI>
<LI><font face="sans-serif">By double-clicking on the "input" and "include" items in the "structure view" of the "root" file, the "children" files are opened by
</font> <b><font color="#805417" face="sans-serif">K</font></b><font face="sans-serif">texmaker2
(if they are in the same directory)</font>
</LI>
</UL>
<table width="100%"><tr bgcolor=#A2C511><td align="center"><b><font face="sans-serif" size="+2">Other features</font> </b></td></tr></table>
<UL>
<LI><font face="sans-serif">You can remove the "structure" and the "output" frames from the main window with the "Options" menu.</font>
</LI>
<LI>
<font face="sans-serif">The "Configure Tools" command of the menu "Options" enables you to configure the commands launched by the "Tools" menu .<br>
You can add options or change the commands used by the program (except for latex2html). (Warning : you must use the variables $texname, $dviname...)<br>
Example : "acroread $pdfname" can be replaced by "xpdf $pdfname".</font>
</LI>
<LI>
<font face="sans-serif">With the "Change Structure View Items" command of the menu "options", you can replace the default items (part, chapter, section...) by items working with the same process
and classified hierarchically.<br>
If you insert "word" as an item, the program will only search for the "\word{}" and "\word*{}" environments.<br>
This option concerns principally these ones who are using personnal LaTeX commands instead of the classicals "section, subsection..." tags.<br>
Empty items are not authorized.<br>
Example : "chapter,mysection,subsection,subsubsection,paragraph"
</font>
</LI>
</UL>
<table width="100%"><tr bgcolor=#A2C511><td align="center"><b><font face="sans-serif" size="+2">Working with the Gnuplot Front End</font> </b></td></tr></table>
<font face="sans-serif">The Gnuplot Front End is an adaptation for <b><font color="#805417" face="sans-serif">K</font></b><font face="sans-serif">texmaker2
of the Xgfe (X Windows GUI front end to Gnuplot) program created by David Ishee.<br>
A good knowledge of Gnuplot is required to use this tool.<br><br>
<b>Example 1:</b> sinus function</font>
<UL>
<LI><font face="sans-serif">Chech "Function" and enter "sin(x)" in the corresponding field.
</font></LI>
<LI><font face="sans-serif">Enter "x" in the "Variable X" field, "-5" in the "Start" field and "5" in the "End" field .
</font></LI>
<LI><font face="sans-serif">Click on the "Plot" button.
</font></LI>
<LI><font face="sans-serif">To export the plot for Xfig : select "fig" in the "Terminal" menu,
click on the "Output File" button , select or type a file name and click on the "Plot" button.
</font></LI>
</UL>
<font face="sans-serif">
<b>Example 2:</b> parametric function</font>
<UL>
<LI><font face="sans-serif">Chech "Function" and enter "sin(4*t),cos(3*t)" in the corresponding field.
</font></LI>
<LI><font face="sans-serif">Enter "t" in the "Variable X" field, "0" in the "Start" field and "7" in the "End" field .
</font></LI>
<LI><font face="sans-serif">Click on the "Add Gnuplot commands" button and type "set parametric"
</font></LI>
<LI><font face="sans-serif">Click on the "Plot" button.
</font></LI>
</UL>
<table width="100%"><tr bgcolor=#A2C511><td align="center"><b><font face="sans-serif" size="+2">Copyright</font> </b></td></tr></table>
<p>
<b><font color="#805417" face="sans-serif">K</font></b><font face="sans-serif">texmaker2 - Copyright 2001 <b>Pascal Brachet - France</b> , <a href="mailto:pascal.brachet@free.fr">pascal.brachet@free.fr</a><br>
<br>Home Page : <a href="http://xm1.net.free.fr/linux/index.html">http://xm1.net.free.fr/linux/index.html</a><br>
<br>Thanks to Christophe Caignaert.<br><br>
</font><b><font color="#805417" face="sans-serif">K</font></b><font face="sans-serif">texmaker2 contains source code from these free (GPL) programs :<br>
<b>Xgfe</b> (X Windows GUI front end to Gnuplot) : Copyright (C) 1998 <b>David Ishee</b><br>
<b>Kwrite</b> : Copyright (C) 1998, 1999 <b>Jochen Wilhelmy</b><br>
<b>Konsole</b> : Copyright (C) 1997, 1998 <b>Lars Doelle</b><br>
<br>This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
<br>This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
<br>You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</font>
</p>
<p><address><hr><div align="center">
<table width="100%" cellspacing="0" border="0"><tr>
<td><font face="sans-serif">User Manual</font><td>
<td align="right"><div align="right"><font face="sans-serif">Ktexmaker2</font></div>
</table></div></address>
</body>
</html>
distrib
>
Mandriva
>
8.2
>
i586
>
media
>
contrib
>
by-pkgid
>
82d89d497f87a7807ac40c74b0eab77c
>
files
>
158
