To use TeXoMaker, after installing it you must have a LaTeX distribution installed (note that TeXoMaker will launch even without a LaTeX distribution, but it will be impossible to import any exercises).
At first launch, you arrive at the main window :
![]() |
Now it is time to create our first database.
Click on the appropriate button :
![]() |
to see the next window, where we have to choose a name for our database (which extension will be xml) :
![]() |
This file can be created anywhere you like, but if you wish to move or rename it, be warned that it is coupled to a hidden configuration file : if the database file is physics.xml, the associated configuration file will be .physics. So if you want to move or rename it, you have to do the same with the configuration file.
This file is very import because it contains all the informations about your database (including LaTeX preamble, type of compilation ...since version 1.60).
Just click on Save to create the file. Te Settings windows open then automatically.
Note that you can create as many databases as you want and navigate from one to another by clicking on the following button :
![]() |
At first launch, the following window will appear :
![]() |
It is where the user can decide which metadatas are going to be used by TeXoMaker to caracterize, classify and filter the exercises. The above figure shows the defaults settings. The list begins with 4 metadata types than cannot be modified :
- filepath
-
path to the .tex exercise file. It is automatically added to the xml database.
- importdate
-
importation date of the exercise. Automatically added to the database.
- figure
-
associated with the existence of a figure in the exercise. It belongs to the user to warn (in a sense) TeXoMaker that there is a figure, by adding in the .tex file (anywhere, one line by figure) :
%@ figure: _figure-filename_._extension_ - metapost
-
associated with a metapost file in the exercise. The user has again to add a comment line in the exercise file (one for each metapost file) :
%@ metapost: _filename_.mpNote that TeXoMaker will automatically detect that the .mp file has to be compiled before, with the dedicated tool (mpost most of the time, but it can be changed as you will see below).
Here come the "user" metadatas : the ones you'll choose to classify and filter your exercises. By default TeXoMaker proposes 3 of them : Title, Domain and Chapter. You are fully free to remove, rename or add a metadata.
The exercises have to be prepared to contain the metadatas you choosed (same principle as for figure or metapost). The listing above shows an example of an exercise file ready to be imported (note that the order and the position of the metadatas in the exercise does not matter) :
%@ Titre: Recherche du trajet le plus court
%@ Domaine: Mécanique
%@ Chapitre: Cinématique
\large \textbf{Recherche du trajet le plus court}
\normalsize
\vspace{0.3cm}
\begin{figure}[H]
\centering
\includegraphics[width=8cm]{fig-exo-recherche-du-trajet-le-plus-court}
%@ figure: fig-exo-recherche-du-trajet-le-plus-court.pdf
\end{figure}
Un sauveteur se trouve sur la plage au point $A$ lorsque soudain il aperçoit une (très) jolie naïade en détresse au point $B$ dans la mer. Sachant que notre homme court sur la plage à la vitesse $v_1$ et nage à la vitesse $v_2$ et sachant bien sur que la durée du trajet doit être minimale, il faut l'aider à trouver la position du point $O$ d'entrée dans l'eau.
Pour que cette belle romance aquatique ne soit pas gâchée par un vulgaire problème de physique, il s'agit tout simplement de trouver la relation entre $i_1$, $i_2$, $v_1$, $v_2$ qui traduit la condition de durée minimale.
You can notice that the existence of all the metadatas you defined in an exercise is optionnal. For example you can define a new metadata like Given in to indicate in which year you gave the exercise last time : of course, this field will be empty for all the exercises you never gave.
Then you can also choose which metadatas will be visible in the exercises list, and in which order.
The above screenshot shows an example of choice you could make :
![]() |
which will lead to an exercise list with the above header :
![]() |
![]() |
In this tab you can choose the path of the binaries that will be used by the program, and also the compilation strategy.
Usualy the default choices should work (the checkable box on the right side indicates the existence or not of the file you choosed). If you want to use Plain TeX, just enter the path to tex in the latex/tex line.Note that for example for those who will compile with pdflatex, the lack of the binary ps2pdf for example is not a problem.
You can add one or more compilation options (-shell-escape for example)
Warning
In the case of a compilation with latex the software uses a script called ltx2pdf which is in the directory bin of the package. It can happen that you have to make it executable manually using the above command in a terminal :
macbook:bin gwenael$chmod +x ltx2pdf
This field has to be filled with the LaTeX preamble that you want to be used by TeXoMaker for all LaTeX compilations (exercises imports and exercises sheets creations).
You can see an example above :
![]() |
If you have to import an (or several) personal macro file, please do it in the field below (probably using \input or \usepackage).
Below you can if you want use something different than the classic \begin{document}...\end{document}. It will be the case if you use Plain TeX for example.
Some settings concerning the exercises sheets creation :
![]() |
You'll find here four optional fields :
-
Header : LaTeX code which will be positioned just before the first exercise. Typically something like :
\large \textbf{Mechanics - Exercises}The default is an empty line.
-
\exo : this is the macro which introduces each exercises. The default is a macro called \exo, that has to be defined somewhere in your preamble; for example :
\newcounter{num} \renewcommand{\thenum}{\arabic{num}} \newcommand{\exo}{\addtocounter{num}{1} {\noindent \large\textbf{Exercice~\thenum~: }}}It is now possible in this field to use the value of a metadata you defined. All you have to do is to write the metadata name between %@ and @. TeXoMaker will automatically replace it by its value for the current exercise. For example :
\exo \large \textbf{%@Titre@} \normalsize \vspace{0.3cm} -
The next field contains the LaTeX code that will be inserted between two exercises. The default is a 0.3 cm vertical space.
-
Footer : LaTeX code inserted just after the last exercise. The default is an empty line. Note concerning exercises answers, that the LaTeX package
answersseems to be fully functional with TeXoMaker.
After an empty base has been created, the main windows looks like above : :
![]() |
Lets assume that we have some exercises "prepared" with the defined metadatas.
Warning
By default, TeXoMaker opens and reads the LaTeX files using the encoding of the system (UTF-8 on Debian and Ubuntu for example). If you have files using ISO-8859-15 (Latin), you can select it in the Tools menu.
![]() |
To import exercises, click on the button :
![]() |
Choose one or several files to import :
![]() |
If everything is ok, you will see the exercises appear in TeXoMaker window :
![]() |
You can navigate, change the ordering criteria, and apply a filter using the dedicated line ::
![]() |
If the mouse focuses a moment on an exercise's name, a box with all the properties of the exercise appears :
![]() |
In case an error occurs during the LaTeX compilation, you will see the following window :
![]() |
The standard error output of the compiler will allow you to correct the problem most of the time :
![]() |
Here the problem was an unclosed $. In case of a more tricky problem the file _filename_-preview.tex still exists, allowing you to make some trials before importing the exercise again.
It is now possible (since version 1.60) to launch from TeXoMaker an external editor to edit the selected exercise :
![]() |
Be warned that after any modification in an external editor, you'll have to update the exercise manually from TeXoMaker.
It is also possible to edit the metadatas of the selected exercise by clicking :
![]() |
The following dialog box will pop up :
![]() |
You can then add, modify or suppress metadatas. After clicking on "Apply and quit", the exercise is automatically updated..






























