TexMakerX : user manual

# Tutoriel TexMakerX

Attention: Parties de ce document elles obsolète. Confe aussi le English translation.

## Sommaire:

- 1. Configurer TexMakerX

- 1.1 Configurer l'éditeur
- 1.2 Configurer les commandes associées à LaTeX
- 1.3 Configurer la vérification orthographique

- 2. Rédaction d'un document avec l'éditeur

- 2.1 Commandes usuelles
- 2.2 Préambule du document
- 2.3 Structuration du document
- 2.4 Navigation à l'intérieur d'un document
- 2.5 Mise en forme du texte avec TexMakerX
- 2.6 Espacement - Sauts de ligne
- 2.7 Insertion d'une liste
- 2.8 Insertion d'un tableau
- 2.9 Tabulation
- 2.10 Insertion d'images
- 2.11 Références croisées et notes
- 2.12 Insertion de formules mathématiques

- 3. Compiler son document

- 3.1 Compiler son document
- 3.2 Les fichiers log

- 4. Autres caractéristiques de TexMakerX

- 4.1 Documents scindés en plusieurs fichiers
- 4.2 Bibliographie
- 4.3 Balises et commandes personnelles
- 4.4 Support Pstricks
- 4.5 Support Metapost
- 4.6 Convertir son document en Html
- 4.7 "Forward/Inverse search" avec TexMakerX
- 4.8 Synopsis de la commande TexMakerX
- 4.9 Raccourcis clavier

# 1. Configurer TexMakerX

Avant d'utiliser TexMakerX, il faut d'abord configurer l'éditeur et les commandes associées à LaTeX via l'option "Configurer TexMakerX" du menu "Options" ("Préférences" sous macosx).

## 1.1 Configurer l'éditeur

Avant de compiler son premier document, il faut d'abors régler l'encodage utilisé par l'éditeur ("Configurer TexMakerX" -> "Editeur" -> "Encodage"). Il faut ensuite utiliser l'encodage correspondant dans le préambule des documents LaTeX (Exemple : \usepackage[latin]{inputenc}, si l'on utilise l'encodage "ISO-8859-1" pour l'éditeur).

## 1.2 Configurer les commandes associées à LaTeX

Pour pouvoir compiler les documents avec TexMakerX, les chemins vers les commandes associées à LaTeX doivent être définis correctement.
Les commandes par défaut devraient fonctionner avec les distributions LaTeX standards, mais des changements peuvent quand même être nécessaires ("Configurer TexMakerX" -> "Commandes"). Pour modifier une commande, il suffit d'utiliser le bouton en fin de ligne et de sélectionner le programme correspondant avec le sélecteur de fichiers : TexMakerX adaptera automatiquement la syntaxe (les modifications manuelles sont déconseillées).
Le caractére % représente le nom du fichier courant (sans l'extension) et le caractére @ sera automatiquement remplacé par le numéro de la ligne courante dans l'éditeur.

## 1.3 Configurer la vérification orthographique

Le système interne de vérification orthographique utilise les mêmes dictionnaires qu'OpenOffice.org. Seuls les dictionnaires GPL français et anglais sont distribués avec TexMakerX.
Il est possible de télécharger d'autres dictionnaires à cette adresse : http://wiki.services.openoffice.org/wiki/Dictionaries
Pour configurer le fonctionnement d'aspell dans TexMakerX : "Configurer TexMakerX" -> "Editeur" -> "Dictionnaire" et utiliser le bouton en fin de ligne pour sélectionner le dictionnaire avec le sélecteur de fichiers.
Attention : la correction orthographique commence désormais à partir de la position du curseur et non plus à partir du début du document.

# 2. Rédaction d'un document avec l'éditeur

## 2.1 Commandes usuelles

TexMakerX comporte les commandes habituelles d'un éditeur classique : Copier, Coller...
Elles sont accessibles via le menu "Edition" et la première barre d'outils.

## 2.2 Préambule du document

Il y a plusieurs façons de rédiger le préambule de son document LaTeX.
La première consiste à utiliser la commande "Démarrage rapide" du menu "Assistants" :

on peut y fixer les principales caractéristiques de son document (classe, format...). Les boutons "+" permettent de rajouter ses propres options. Tous ces réglages sont enregistrés : l'utilisateur les retrouvera à la prochaine utilisation de l'assistant.
On peut aussi utiliser un modèle de préambule que l'on a préalablement enregistré. Il suffit alors d'utiliser "Enregistrer sous" ou un "copier/coller" pour l'utiliser comme base de son nouveau document.

## 2.3 Structuration du document

L'un des points forts de LaTeX est la structuration des documents. Pour définir une nouvelle "section" avec TexMakerX, il suffit d'utiliser cette liste de la barre d'outils :

On n'a plus qu'à indiquer le titre voulu et si l'on désire que cette section soit numérotée (elle fera alors partie de la table des matières) :

## 2.4 Navigation à l'intérieur d'un document

TexMakerX facilite la navigation dans un long document LaTeX grâce à la vue structure située à gauche de l'interface :

Un simple clic sur un item permet d'atteindre la ligne correspondante dans l'éditeur. Cette vue structure est actualisée à chaque enregistrement ou compilation du document. L'utilisateur peut aussi utiliser la commande "Rafraîchir Structure" du menu "Edition" à tout moment.

Pour chaque fichier, l'utilisateur peut définir trois "signets" pour accelérer la navigation dans un document. Pour ajouter ou supprimer un "signet", il suffit de cliquer sur un numéro de ligne. Quand vous avez déja défini trois signets, il faut en supprimer un pour pouvoir en ajouter un nouveau. Pour atteindre la ligne correspondante à un signet, il suffit de cliquer sur les boutons "1,2,3" dans la barre d'état de TexMakerX.

## 2.5 Mise en forme du texte avec TexMakerX

Le formatage du texte peut se faire rapidement grâce à cette barre d'outils :

Une des caractéristiques de TexMakerX est la possibilité de sélectionner le texte à formater avant de cliquer sur ces boutons. Les balises LaTeX adéquates entourent alors automatiquement le texte sélectionné.

## 2.6 Espacement - Sauts de ligne

Les commandes d'espacement usuelles sont disponibles dans le menu "LaTeX - Espacement". Le bouton "Retour à la ligne" (raccourci-clavier : Ctrl+Return) permet aussi d'insérer rapidement le code LaTeX pour un retour à la ligne.

## 2.7 Insertion d'une liste

Le menu "LaTeX - Listes" permet d'insérer rapidement le squelette des environnements listes traditionnels de LaTeX. Le raccourci-clavier pour insérer rapidement un item est : Ctrl+Alt+H.

## 2.8 Insertion d'un tableau

TexMakerX propose un assistant permettant d'insérer le code adéquat pour la plupart des tableaux standards. Il suffit d'utiliser la commande "Assistant tableau" du menu "Assistants". On se retrouve alors devant la boîte de dialogue ci-dessous.

On peut y définir les caractéristiques du tableau (nombre de lignes et de colonnes, alignement, séparateur...). Il est même possible d'entrer directement le texte de chaque cellule (on peut aussi les laisser vides et compléter la tableau alors dans l'éditeur). Le code LaTeX adéquat est alors automatiquement inséré.

## 2.9 Tabulation

L'"Assistant Tabulation" du menu "Assistants" permet d'insérer automatiquement le code LaTeX d'une tabulation simple grâce à la boîte de dialogue ci-dessous.

## 2.10 Insertion d'images

L'insertion d'une image se fait grâce à la commande "\includegraphics{}" du menu "LaTeX". En cliquant sur l'icône "fichier" de la boîte de dialogue ci-dessous, on peut alors sélectionner l'image à inclure.

Remarques :

- Il est conseillé d'inclure un environnement "figure" (menu "LaTeX - Environnements") avant d'insérer une image.
- L'option scale permet de fixer l'échelle du graphique.
- Si l'image est au format Eps, ses dimensions sont affichées dans le panneau "Messages".

## 2.11 Références croisées et notes

La deuxième liste de la barre d'outils est à la disposition des utilisateurs pour insérer rapidement les commandes LaTeX usuelles pour les références croisées et les notes de bas de page. Les labels utilisés dans le document apparaissent dans la vue structure : un clic suffit à les atteindre dans l'éditeur.

Remarque : Pour la commande \ref , TexMakerX propose de sélectionner un label parmi la liste de labels détectés dans le document (utiliser la commande "Rafraîchir Structure" du menu "Edition" pour actualiser éventuellement la liste).

## 2.12 Insertion de formules mathématiques

Le passage en mode mathématique (en ligne) se fait avec le bouton "f(x)" de la barre d'outils "Math" ou grâce au raccourci-clavier Ctrl+Alt+M. Pour le mode hors-ligne, on peut utiliser la commande "$$...$$" du menu "Math" ou le raccourci-clavier Alt+Shift+M.
La barre d'outils mathématiques permet aussi d'insérer d'un seul clic les formes mathématiques les plus courantes (fraction, racine...) ainsi que les balises \left et \right.

Les panneaux de symboles mathématiques situés à gauche permettent d'insérer d'un clic le code LaTeX de près de 400 symboles.

Le menu "Math" permet aussi de définir le style du texte en mode mathématique (accents, styles de caractères,espacement)
Pour les matrices, un assistant basé sur le même principe que celui pour les tableaux est disponible dans le menu "Assistants". Il permet en plus de fixer l'environnement (array, matrix, pmatrix...). Les cellules peuvent être complétées directement dans l'assistant.

# 3. Compiler son document

## 3.1 Compiler son document

Le plus rapide pour compiler un document est d'utiliser la commande "Compilation rapide" (bouton "Quick" - raccourci-clavier : F1). Cette commande, dont le comportement est à fixer dans la boîte de dialogue de configuration de TexMakerX permet d'enchaîner plusieurs commandes à la suite afin de passer directement du document LaTeX à la visualisation du fichier dvi, postscript ou pdf.
Sinon, on peut aussi lancer les commandes une par une selon ses besoins via le menu "Outils" (raccourcis-claviers : F2...F12).

Remarques :

- Tous les noms des documents doivent avoir une extension (en minuscule) et ne pas comporter d'espaces, sans quoi les commandes échoueront. De même, un fichier "sans nom" ne peut pas être compilé par TexMakerX : il doit d'abord être enregistré.
- Si les chemins vers les outils LaTeX sont mal définis, des messages "Impossible de lancer la commande" apparaîtront.
- La commande "Nettoyer" (menu "Outils") permet d'effacer tous les fichiers générés par LaTeX (sauf le fichier postscript et pdf)

## 3.2 Les fichiers log

Lors de l'utilisation de la commande "Compilation rapide", le fichier log généré par LaTeX est automatiquement affiché dans le panneau "Messages / Fichier Log" si une erreur de compilation est détectée. Un clic dans la colonne "Line" permet alors d'atteindre directement cette ligne dans l'éditeur et le détail de l'erreur est affichée en dessous.

Dans les autres cas, un simple clic sur les boutons "Erreur LaTeX suivante" et "Erreur LaTeX précédente" permet d'afficher le fichier log et d'atteindre directement l'erreur recherchée.

# 4. Autres caractéristiques de TexMakerX

## 4.1 Documents scindés en plusieurs fichiers

TexMakerX permet aussi de travailler sur un document composé de plusieurs fichiers.
Pour inclure un fichier .tex dans son document, il suffit d'utiliser la commande "\include{file}" du menu "LaTeX". Une boîte de dialogue permet alors de sélectionner le fichier à inclure. Ce fichier apparaît alors à la fin de la vue "Structure". Un clic sur son nom permet de l'ouvrir automatiquement.
Il est conseillé alors de déclarer le document "racine" comme "document maître" à l'aide du menu "Options". Dès lors, toute compilation ne se fera plus à partir du document ouvert dans l'éditeur mais à partir du "document maître". On peut ainsi facilement travailler sur les documents "enfants" tout en compilant le document "racine" (qui peut même être fermé). Le menu "Options" permet aussi de retourner au mode "normal" (en désactivant la définition d'un document "maître").

## 4.2 Bibliographie

TexMakerX facilite la rédaction d'un fichier de bibliographie (au format standard .bib) grâce au menu "Bibliographie". Un clic sur un item de ce menu insère directement le code standard associé à ce style de bibliographie. Les commandes optionnelles signalées par "OPT" sont automatiquement effacées par la commande "Clean" du menu "Bibliographie" : il faut donc effacer le "OPT" pour les conserver.

## 4.3 Balises et commandes personnelles

TexMakerX permet à l'utilisateur d'enregistrer dix extraits de code LaTeX accessibles par le menu "Utilisateur - Balises utilisateur" et par les raccourcis-claviers (Shift+F1 à Shift+F10). Pour définir ces extraits, il faut lancer la commande "Editer balises utilisateur" dans ce même menu.
Remarque : le fait d'entrer "%monenvironnement" dans le champ "code LaTeX" insérera le code suivant dans l'éditeur:
\begin{monenvironnement}
\end{monenvironnement}

Il est aussi possible de définir des commandes personnelles via le menu "Utilisateur - Commandes utilisateurs". Un % représente le nom du fichier à traiter sans extension. Les commandes, une fois définies, peuvent-être lancées par les raccourcis-claviers Alt+Shift+F1...Alt+Shift+F5 .

## 4.4 Support Pstricks

Les principales commandes Pstricks peuvent être insérées directement dans le code à partir de l'onglet "Pstricks".

## 4.5 Support Metapost

L'onglet "Commandes Metapost" permet d'insérer les commandes metapost dans un fichier .mp. La commande "Mpost" peut-être lancée à partir du menu "Outils".

## 4.6 Convertir son document en Html

L'option "Exporter vers Html" du menu "Outils" permet de transformer son document LaTeX en un site web où chaque page html est composée d'une seule image reproduisant exactement une des pages postscript du document. On évite ainsi les problèmes de mise en page entre le texte et les formules mathématiques des autres outils traditionnels de conversion LaTeX vers html.
TexMakerX peut aussi créer automatiquement une page index dans le site web correspondant à la traditionnelle tables des matières du document LaTeX. Un clic sur un item de cette page index permet d'atteindre la page web correspondante. Il est aussi possible d'insérer des liens externes et internes à l'intérieur des pages web en utilisant la commande \ttwplink{}{} dans le document .tex.
Synopsis de cette commande :
\ttwplink{http://www.monsite.com}{texte_lien} (lien externe)
\ttwplink{page3.html}{texte_lien} (lien interne)
\ttwplink{name_of_a_label}{texte_lien} (lien interne vers un label)
Attention : \ttwplink{}{} ne peut-être utilisé que pour exporter son document en html. Une compilation normale d'un document comportant cette commande par LaTeX déclenchera une erreur. Par ailleurs, cette commande est incompatible avec plusieurs "packages" LaTeX dont notamment \hyperref.

## 4.7 "Forward/inverse search" avec TexMakerX

Certains afficheurs dvi permettent d'afficher directement la page et la zone correspondante à une certaine ligne dans le fichier source LaTeX.
Pour utiliser cette caractéristique, il faut utiliser le caractère @ dans la ligne de commande correspondant à l'afficheur dvi ("Configurer TexMakerX" -> "Commandes").
Exemples "Forward search" :

- Pour lancer yap : "C:/Program Files/MiKTeX 2.7/miktex/bin/yap.exe" -1 -s @%.tex %.dvi
- Pour lancer xdvi : xdvi %.dvi -sourceposition @:%.tex
- Pour lancer kdvi : kdvi "file:%.dvi#src:@ %.tex"

Pour l'opération inverse ("Inverse search") :

- Lancer TexMakerX à partir de yap : "C:\Program Files\TexMakerX\TexMakerX.exe" "%f" -line %l (the program arguments : "%f" -line %l )
- Lancer TexMakerX à partir de xdvi : xdvi -editor "TexMakerX %f -line" %.dvi -sourceposition @:%.tex

## 4.8 Synopsis de la commande TexMakerX

TexMakerX fichier [-master] [-line xx]
Avec l'option "-master" , le document chargé sera automatiquement défini comme document "maître".
Avec l'option "-line xx" , TexMakerX demandera s'il doit aller à la ligne xx après avoir chargé le document.

## 4.9 Raccourcis clavier

Raccourcis par défaut (*:modifiable - "Configurer TexMakerX" -> "Editeur") :

- Menu "Fichier" :
  - Nouveau : Ctrl+N
  - Ouvrir : Ctrl+O
  - Enregistrer : Ctrl+S
  - Fermer : Ctrl+W
  - Quitter : Ctrl+Q
- Menu "Editer" :
  - Défaire : Ctrl+Z
  - Refaire : Ctrl+Y
  - Copier : Ctrl+C
  - Couper : Ctrl+X
  - Coller : Ctrl+V
  - Sélectionner tout : Ctrl+A
  - Commenter : Ctrl+T
  - Décommenter : Ctrl+U
  - Chercher à nouveau : Ctrl+M
  - Remplacer : CTrl+R
  - Aller à la ligne : Ctrl+G
  - Vérifier orthographe (depuis le curseur) : Ctrl+Shift+F7
- Menu "Outils" :
  - Quick build : F1
  - Latex : F2
  - View dvi : F3
  - Dvi->PS : F4
  - View PS : F5
  - Pdflatex : F6
  - View Pdf : F7
  - PS->Pdf : F8
  - Dvi->Pdf : F9
  - View log : F10
  - Bibtex : F11
  - Make index : F12
- * Menu "LaTeX" :
  - * item : Ctrl+Shift+I
  - * Italic : Ctrl+I
  - * Slanted : Ctrl+Shift+S
  - * Bold : Ctrl+O
  - * Typewriter : Ctrl+Shift+T
  - * Small caps : Ctrl+Shift+C
  - * Emphasis : Ctrl+Shift+E
  - * New line : Ctrl+Return
- * Menu "Math" :
  - * Inline math mode : Ctrl+Shift+M
  - * Display math mode : Alt+Shift+M
  - * Numbered equations : Ctrl+Shift+N
  - * Subscript : Ctrl+Shift+D
  - * Superscript : CTrl+Shift+U
  - * Frac : Alt+Shift+F
  - * Dfrac : Ctrl+Shift+F
  - * Sqrt : Ctrl+Shift+Q
  - * Left : Ctrl+Shift+L
  - * Right : Ctrl+Shift+R
- Menu "Utilisateurs" :
  - Balises utilisateurs : Shift+F1...Shift+F10
  - Commandes utilisateurs : Shift+Alt+F1...Shift+Alt+F10