# Tutoriel Texmaker

## Sommaire:

- 1. Configurer Texmaker

- 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 Texmaker
- 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 Texmaker

- 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 search" avec Texmaker
- 4.8 Synopsis de la commande texmaker
- 4.9 Raccourcis clavier

# 1. Configurer Texmaker

Avant d'utiliser Texmaker, il faut d'abord configurer l'éditeur et les commandes associées à LaTeX via l'option "Configurer Texmaker" 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 Texmaker" -> "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 Texmaker, 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 Texmaker" -> "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 : Texmaker 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

Pour pouvoir utiliser la vérification orthographique, le programme "aspell" doit-être installé sur votre système.

- Sur linux : il faut installer les paquets "aspell" et "aspell-fr".
- Pour windows, il faut d'abord se connecter à la page suivante : http://aspell.net/win32/
  Il faut ensuite installer le programme "Full installer", puis le dictionnaire français (aspell-fr-0.50-3-3.exe).
- Sur macosx : il faut installer les paquets "aspell" et "aspell-fr" en utilisant "fink" (CocoAspell ne fonctionne pas avec Texmaker)

Pour configurer le fonctionnement d'aspell dans Texmaker : "Configurer Texmaker" -> "Editeur" -> "Commande Aspell"...(si nécessaire, utilisez le bouton en fin de ligne pour sélectionner le programme aspell avec le sélecteur de fichiers)

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

## 2.1 Commandes usuelles

Texmaker 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 Texmaker, 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

Texmaker 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 Texmaker.

## 2.5 Mise en forme du texte avec Texmaker

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

Une des caractéristiques de Texmaker 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

Texmaker 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 , Texmaker 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 Texmaker 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 Texmaker : 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. La ligne décrivant l'erreur apparaît alors en rouge. Un clic sur le numéro de ligne permet alors d'atteindre directement cette ligne dans l'éditeur.
Remarque : un résumé des erreurs et des avertissements détectés sont affichés avant le fichier log complet.

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 Texmaker

## 4.1 Documents scindés en plusieurs fichiers

Texmaker 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

Texmaker 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

Texmaker 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.
Texmaker 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 search" avec Texmaker

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 Texmaker" -> "Commandes").
Exemples :

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

Remarque : l'opération inverse ("inverse search") n'est pas recommandée avec Texmaker. En effet, à chaque fois, une nouvelle instance de Texmaker sera lancée.

## 4.8 Synopsis de la commande texmaker

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

## 4.9 Raccourcis clavier

Raccourcis par défaut (*:modifiable - "Configurer Texmaker" -> "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
  - Chercher : Ctrl+F
  - Chercher à nouveau : Ctrl+M
  - Remplacer : CTrl+R
  - Aller à la ligne : Ctrl+G
- 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