Texmaker : Mode d'emploi

Contenu
• 1. Configuration de Texmaker
o 1.1 Configuration de l'éditeur
o 1.2 Configuration des commandes liées au latex
o 1.3 Configurer le correcteur orthographique
• 2. Éditer un document TeX
o 2.1 Commandes usuelles
o 2.2 Définir le préambule d'un document TeX
o 2.3 Structure d'un document
o 2.4 Parcourir votre document
o 2.5 Mise en forme de votre texte
o 2.6 Espacements
o 2.7 Insérer une liste
o 2.8 Insertion d'un tableau
o 2.9 Insertion d'un environnement "tabulation"
o 2.10 Insertion d'une image
o 2.11 Renvois et notes
o 2.12 Insertion de formules mathématiques
o 2.13 Utilisation des espaces réservés "•"
• 3. Compilation d'un document
o 3.1 Compilation
o 3.2 Les fichiers journaux
o 3.3 Synchronisation source-pdf avec Synctex
• 4. Autres fonctionnalités
o 4.1 Plier/déplier des parties du document
o 4.2 À propos des documents séparés dans plusieurs fichiers
o 4.3 Bibliographie
o 4.4 Balises et outils personnels
o 4.5 Prise en charge de Pstricks/Metapost/Tikz/Asymptote
o 4.6 Changer la langue de l'interface
 o 4.7 La commande "Restaurer la session précédente"
o 4.8 "Recherche avant/arrière" avec Texmaker
o 4.9 Synopsis de la commande Texmaker
o 4.10 Raccourcis clavier
o 4.11 Le panneau "Visionneuse source"
o 4.12 Option "Utiliser un sous-répertoire 'build'..." pour la
commande (pdf)latex
o 4.13 Remplacer du texte par une expression régulière
o 4.14 Utiliser Texmaker comme éditeur Asymptote
o 4.15 Extension des fonctionnalités de l'éditeur avec des scripts

1. Configuration de Texmaker
Avant d'utiliser Texmaker, vous devez configurer l'éditeur et les commandes
liées au latex via la commande "Configurer Texmaker" du menu "Options"
("Préférences" sous macosx).

1.1 Configuration de l'éditeur

Avant de compiler votre premier document, vous devez paramétrer
l'encodage utilisé par l'éditeur ("Configure Texmaker" -> "Editor" -> "Editor
Font Encoding"). Ensuite, vous devez utiliser le même encodage dans le
préambule de vos documents TeX (exemple : \usepackage[latin]{inputenc},
si vous utilisez l'encodage "ISO-8859-1" pour l'éditeur)
Note : lors de l'ouverture d'un fichier, vous êtes averti si le document ne
peut pas être décodé correctement avec l'encodage par défaut et le
programme vous permet de choisir un autre encodage (sans modifier
l'encodage par défaut) .

1.2 Configuration des commandes liées au

latex
Texmaker ne peut pas compiler vos documents si les chemins vers les
commandes liées à LaTeX sont erronés.
Les paramètres par défaut devraient fonctionner avec les distributions
LaTeX récentes et standard, mais vous devrez les modifier ("Configurer
Texmaker" -> "Commandes"). Pour modifier une commande, il suffit de
cliquer sur le bouton à la fin de la ligne correspondante et de
sélectionner la commande dans le navigateur de fichiers : texmaker
adaptera automatiquement la syntaxe de la commande.
Le caractère % représente le nom du fichier sans l'extension (le document
maître en mode "maître") et le caractère @ sera remplacé par le numéro de
la ligne courante.
Paramètre supplémentaire : #sera remplacé par le nom du fichier courant
sans extension (même en mode "maître") et ! sera remplacé par le
répertoire courant.

Remarque : si les caractères %, !, # et @ sont nécessaires pour une

commande, utilisez simplement %%, !!, ## et @@. Ces expressions seront
respectivement remplacées par %, !, # et @ avant de lancer la commande.
1.3 Configurer le correcteur orthographique
Le correcteur orthographique utilise les dictionnaires
Hunspell/OpenOffice.org (version 2.x).
Pour configurer le correcteur orthographique : "Configurer Texmaker" ->
"Editeur" -> "Dictionnaire orthographique" -> cliquer sur le bouton en fin
de ligne pour sélectionner le dictionnaire avec le navigateur de fichiers.
Attention : la vérification orthographique commence à la position du
curseur et non au début du document.
Lors de la saisie, s'il y a une erreur, le mot est souligné d'un soulignement
rouge. Un clic droit sur le mot ouvre un menu contextuel dans lequel il y a
des suggestions de remplacement. Cliquez sur le mot souhaité pour
effectuer le remplacement.

2. Éditer un document TeX

2.1 Commandes usuelles

Les commandes standard (couper, copier, rechercher...) peuvent être
lancées via le menu "Edition" et la barre d'outils "Edition".
La sélection de bloc est disponible en utilisant la touche Alt tout en
déplaçant le curseur de la souris.

2.2 Définir le préambule d'un document TeX

Pour définir le préambule de votre document, vous pouvez utiliser
l'assistant "Démarrage rapide" (menu "Assistant").
Cette boîte de dialogue vous permet de définir les principales
caractéristiques de votre document (classe, format de papier, encodage...).
Note : Vous pouvez ajouter d'autres options en cliquant sur les boutons
"+". Tous vos paramètres sont enregistrés.

Vous pouvez également saisir votre propre modèle de préambule dans

l'éditeur : avec les commandes "Copier/Coller" ou "Enregistrer sous", vous
pouvez l'utiliser pour un nouveau document.

2.3 Structure d'un document

Pour définir une nouvelle partie (section, sous-section...) dans votre
document avec Texmaker, utilisez simplement cette combobox dans la
barre d'outils :

Cela fera apparaître une boîte de dialogue qui vous permet de définir le
style de la pièce (section, sous-section...).
Remarque : la "Structure View" est automatiquement mise à jour.

2.4 Parcourir votre document

La "Vue Structure" (panneau de gauche) vous permet d'accéder rapidement
à n'importe quelle partie de votre document. Il vous suffit de cliquer sur
n'importe quel élément (libellé, section...) et vous serez redirigé vers le
début de la zone correspondante dans l'éditeur.

La "Structure View" est automatiquement mise à jour lors de la saisie. Vous

pouvez également utiliser à tout moment la commande "Actualiser la
structure" (menu "Edition").
Pour chaque fichier, trois signets permettent d'accélérer la navigation : il
suffit de cliquer sur un numéro de ligne pour ajouter ou supprimer un
signet. Lorsque vous avez déjà défini trois signets, vous devez en supprimer
un pour ajouter un nouveau signet. Pour sauter à la ligne correspondant à
un signet dans l'éditeur, il suffit de cliquer sur les boutons de la barre d'état.

2.5 Mise en forme de votre texte

Vous pouvez définir rapidement le format d'une partie de votre texte avec
ceci :

Option supplémentaire : un texte sélectionné peut être directement

encadré par certains environnements. Exemple : en cliquant sur le bouton
"Gras" après avoir sélectionné le mot "Bonjour", vous obtiendrez le code :
\textbf{Bonjour}.
Cette option est disponible pour tous les environnements indiqués par
"[sélection]" dans le menu "LaTeX".

2.6 Espacements
Les commandes habituelles "d'espacement" sont disponibles dans les
menus "LaTeX" et "Math". Pour insérer rapidement la commande LaTeX
"nouvelle ligne", vous pouvez utiliser la commande correspondante dans la
barre d'outils (raccourci : Ctrl+Alt+retour)

2.7 Insérer une liste

Le code habituel des environnements de liste peut être inséré rapidement
via le menu "LaTeX-List".
Note : le raccourci pour la commande \item est Ctrl+Maj+I.

2.8 Insertion d'un tableau

Avec l'assistant "Tabulaire" (menu "Wizard"), le code LaTeX d'un
environnement tabulaire peut être inséré rapidement :
Vous pouvez paramétrer les principales caractéristiques de votre tableau.
Remarque : cette boîte de dialogue vous permet de saisir directement le
code dans les cellules.
Le code LaTeX correspondant est automatiquement inséré dans l'éditeur.

2.9 Insertion d'un environnement

"tabulation"
Pour vous aider à insérer un code "tabbing", vous pouvez utiliser l'assistant
"Tabbing" (menu "Wizard") :
2.10 Insertion d'une image
Pour insérer une image dans votre document, utilisez simplement la
commande "\includegraphics" du menu "LaTeX". Ensuite, cliquez sur le
bouton "navigateur" dans la boîte de dialogue pour sélectionner le fichier
graphique.
Note : si vous cliquez sur le bouton "+", un environnement LaTeX "figure"
sera ajouté automatiquement.

2.11 Renvois et notes

Cette boîte à outils dans la barre d'outils vous permet d'insérer rapidement
le code de l'étiquette, de la citation, de la référence, de la note de bas de
page...
Remarque : les libellés utilisés dans vos documents sont affichés dans la
"Vue Structure".

Option supplémentaire : pour la commande \ref, une boîte de dialogue

permet de sélectionner directement le libellé.

2.12 Insertion de formules mathématiques

Vous pouvez basculer dans l'environnement "maths en ligne" avec le
bouton "$$" dans la barre d'outils (raccourci : Ctrl+Alt+M) ou avec le menu
"Math". Le raccourci pour l'environnement "affichage mathématique" est :
Alt+Maj+M.
La barre d'outils "Math" permet d'insérer les formes mathématiques les plus
courantes (frac, sqrt...)

Avec les "panneaux de symboles" dans la vue structure, vous pouvez insérer
le code de 400 symboles mathématiques et les balises \left et \right..(cliquez
simplement sur les boutons "symboles" dans la vue structure)
Option supplémentaire : Un panneau "symboles favoris" (*) vous permet
de définir votre propre "panneau de symboles".

• Pour ajouter un symbole au "panneau des symboles favoris", il suffit de

faire un clic droit sur un symbole dans les autres "panneaux des
symboles" et de sélectionner "Ajouter aux favoris" dans le menu
contextuel.
• Pour supprimer un symbole dans le "panneau des symboles favoris", il
suffit de cliquer dessus avec le bouton droit de la souris et de
sélectionner "Supprimer des favoris" dans le menu contextuel.
Vous pouvez également définir le format de votre texte mathématique via
le menu "Math".
Pour les environnements "tableau", un assistant (comme l'assistant
"Tableau") est disponible dans le menu "Assistant". Avec cet assistant, vous
pouvez sélectionner l'environnement : tableau, matrice, pmatrix.... Les
cellules peuvent être directement complétées.
2.13 Utilisation des espaces réservés "•"
Les espaces réservés "•", insérés automatiquement par certaines
commandes Texmaker, permettent d'accéder directement au champ suivant
dans la structure créée en utilisant la touche "Tab" ("Maj+Tab" pour revenir
en arrière).
Remarque : l'insertion d'une tabulation avec la touche "Tab" est désactivée
si la ligne contient un espace réservé "•".

3. Compilation d'un document

3.1 Compilation
La manière la plus simple de compiler un document est d'utiliser la
commande "Quick Build" . Vous pouvez définir la séquence de commandes
utilisées par la commande "Quick Build" via la boîte de dialogue "Configure
Texmaker".

Pour lancer une commande depuis la barre d'outils : sélectionnez d'abord la

commande, puis cliquez sur le bouton "Exécuter".

Vous pouvez également lancer chaque commande une par une (raccourcis :
F2...F12 - voir le menu "Outils").
Note : la commande "Nettoyer" du "menu Outils" permet d'effacer les
fichiers (dvi, toc, aux...) générés par une compilation LaTeX (sauf les fichiers
ps et pdf).
Attention : tous vos fichiers doivent avoir une extension et vous ne
pouvez pas compiler un fichier "sans titre" ou un fichier avec un espace
dans son nom .

3.2 Les fichiers journaux

Avec la commande "Quick Build", le fichier journal s'affiche
automatiquement dans le panneau "Messages / Fichier journal". En cliquant
sur un numéro de la colonne "Ligne", le curseur se place sur la ligne
correspondante sous l'éditeur et l'erreur s'affiche.
Remarque : un récapitulatif des erreurs et des avertissements latex est
affiché avant le fichier journal complet.
Les commandes "Next Latex Error" et "Previous LaTeX Error" permettent
d'accéder aux erreurs détectées lors de la compilation :

3.3 Synchronisation source-pdf avec Synctex

Si vous ajoutez l'option "-synctex=1" à la commande pdflatex, le visualiseur
pdf intégré sautera directement à la position dans le fichier PDF qui
correspond à la ligne actuelle dans le fichier source (La)TeX.
Réciproquement, avec un clic droit sur un mot dans la visionneuse pdf
intégrée (menu contextuel), l'éditeur sautera à la ligne correspondante dans
le fichier source.
Remarque : si vous appuyez sur la touche ctrl+espace (ctrl+$ sur MacOsX)
dans le visualiseur de pdf intégré, le focus passe à l'éditeur.

4. Autres fonctionnalités

4.1 Plier/déplier des parties du document

Texmaker vous permet de plier/déplier tous les blocs \part, \chapter,
\section,.., \begin{foo} \end{foo} de votre document. Pour cela, le curseur
doit être localisé dans la première ligne d'un bloc ("pliage de code
contextuel"). Ensuite, il vous suffit de cliquer sur l'icône "-" pour plier le bloc
correspondant.
Remarque : vous pouvez également utiliser le menu contextuel pour sauter
directement à la fin du bloc.

4.2 À propos des documents séparés dans

plusieurs fichiers
Texmaker permet de travailler sur des documents séparés en plusieurs
fichiers.
Pour inclure un fichier TeX dans votre document, utilisez simplement la
commande "\include{fichier}" du menu "LaTeX". Le fichier apparaîtra dans la
"Vue de la structure". D'un clic sur son nom, Texmaker l'ouvrira.

Ensuite, vous pouvez définir votre "document maître" avec le menu

"Options". Toutes les commandes du menu "Outils" s'appliqueront
uniquement à ce document même en travaillant sur les documents
"enfants" (vous pouvez même fermer le document "maître").
Vous pouvez facilement basculer entre le document maître et le document
actuel via le bouton correspondant (juste au-dessus du bouton "Gras").
Remarque : vous pouvez quitter le mode "maître" avec le menu "Options".

4.3 Bibliographie
Lors de l'ouverture d'un document .tex, les fichiers .bib détectés sont
analysés automatiquement et les références bibliographiques sont ajoutées
à l'auto-complétion. La liste des références bibliographiques peut être
rafraîchie via l'option "Mettre à jour la bibliographie" du menu "Edition".

Pour les fichiers "bib", le menu "Bibliographie" permet d'insérer directement

les notices correspondant aux types de documents standards.
Remarque : les champs optionnels peuvent être supprimés
automatiquement avec la commande "Nettoyer" du menu "Bibliographie".
4.4 Balises et outils personnels
Texmaker vous permet d'insérer vos propres tags (raccourcis :
Shift+F1...Shift+F10). Ces balises sont définies avec le menu "Utilisateur -
Balises utilisateur".
Remarques :

• Si le code du menu est "%environment", Texmaker insèrera directement

:
\begin{environment }
•
\end{environment }
et le curseur sautera directement sur le champ "•".

• Vous pouvez également définir un nombre illimité de tags via le

panneau "Utilisateur" dans la "vue de la structure" : il suffit de faire un
clic droit sur ce panneau pour ajouter ou supprimer un élément.
Toutes ces balises peuvent être incluses dans le document en cliquant
sur un élément du panneau ou directement avec la gâchette clavier
":foo" + touche droite.
• Tous les caractères "@" du code sont automatiquement remplacés par
des espaces réservés "•" dans l'éditeur et le curseur saute directement
au premier champ "•" (si du texte a déjà été sélectionné dans l'éditeur,
le premier "• " sera remplacé automatiquement par le texte
sélectionné).
Note : @@ sera remplacé par le caractère @ dans l'éditeur (et non par
un double espace réservé)
Vous pouvez également lancer vos propres commandes (raccourcis :
Alt+Maj+F1...Alt+Maj+F5). Ces commandes sont définies avec le menu
"Utilisateur - Commandes Utilisateur" et peuvent être lancées via la barre
d'outils (bouton "Exécuter") .

4.5 Prise en charge de

Pstricks/Metapost/Tikz/Asymptote
Certaines des principales commandes Pstricks/Metapost/Tikz/Asymptote
peuvent être insérées via les boutons "PS", "MP", "TI" et "AS" dans la
"Structure View".
Les commandes "mpost" et "asy" peuvent être lancées via le menu "Outils"
ou via le bouton "Exécuter".

4.6 Changer la langue de l'interface

La langue de l'interface peut être modifiée via le menu "Options" (un
redémarrage de l'application est nécessaire).

4.7 La commande "Restaurer la session

précédente"
Si vous quittez le programme sans fermer les documents ouverts, texmaker
enregistre automatiquement les noms de ces documents. Avec la
commande "Restaurer la session" du menu "Fichier", tous ces fichiers
peuvent être rouverts en un clic.

4.8 "Recherche avant/arrière" avec

Texmaker
Certains visualiseurs dvi peuvent sauter (et surligner visuellement) une
position dans le fichier DVI qui correspond à un certain numéro de ligne
dans le fichier source (La)TeX.
Pour utiliser cette fonctionnalité, vous pouvez utiliser le caractère @ dans la
syntaxe de la commande dvi viewer ("Configurer Texmaker" ->
"Commandes").
Exemple ("Recherche vers l'avant") :

• Pour lancer yap depuis texmaker : "C:/Program Files/MiKTeX

2.9/miktex/bin/yap.exe" -1 -s @%.tex %.dvi
Pour l'opération inverse ("Recherche inverse") :
• Pour lancer texmaker depuis yap : "C:\Program
Files\Texmaker\texmaker.exe" "%f" -line %l (les arguments du
programme : "%f" -line %l )
• Pour lancer texmaker depuis xdvi : xdvi -editor "texmaker %f -line"
%.dvi -sourceposition @:%.tex

4.9 Synopsis de la commande texmaker

fichier texmaker [-master] [-line xx] [-insert foo] [-n] [-dpiscale x]
Avec l'option "-master", le document sera automatiquement défini comme
document "maître".
Avec l'option "-line xx", Texmaker vous demandera si vous souhaitez sauter
à la ligne xx après avoir chargé le document.
Avec l'option "-insert foo", une commande latex (foo) peut être insérée par
un programme externe dans le document courant pendant que texmaker
est en cours d'exécution.
Avec l'option "-n", une nouvelle instance de Texmaker est lancée (cassera la
synchronisation avec les visualiseurs pdf).
Avec l'option "-dpiscale x", la variable d'environnement QT_SCALE_FACTOR
sera définie sur x avant de construire l'interface graphique (même
comportement que l'ajout de "export QT_SCALE_FACTOR=x"

4.10 Raccourcis clavier

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

• "Menu Fichier :
o Nouveau : Ctrl+N
 o Ouvrir : Ctrl+O
o Enregistrer : Ctrl+S
o Fermer : Ctrl+W
o Quitter : Ctrl+Q
o Restaurer la session précédente : Ctrl+Maj+F8
• Menu "Edition" :
o Annuler : Ctrl+Z
o Refaire : Ctrl+Y
o Copier : Ctrl+C
o Couper : Ctrl+X
o Coller : Ctrl+V
o Tout sélectionner : Ctrl+A
o Commentaire : Ctrl+T
o Décommenter : Ctrl+U
o Rechercher : Ctrl+F
o Rechercher suivant : Ctrl+M
o Remplace : CTrl+R
o Aller à la ligne : Ctrl+G
o Vérifier l'orthographe (à partir du curseur) : Ctrl+Maj+F7
• Menu "Outils" :
o Construction rapide : F1
o Latex : F2
o Vue dvi : F3
o Dvi->PS : F4
o Vue PS : F5
o Pdflatex : F6
o Voir le PDF : F7
o PS->Pdf : F8
o Dvi->Pdf : F9
o Afficher le journal : F10
o Bibtex : F11
o Marque index : F12
• * Menu "LaTeX" :
 o * élément : Ctrl+Maj+I
o * Italique : Ctrl+I
o * Incliné : Ctrl+Maj+S
o * Gras : Ctrl+O
o * Machine à écrire : Ctrl+Maj+T
o * Petites majuscules : Ctrl+Maj+C
o * Emphase : Ctrl+Maj+E
o * Nouvelle ligne : Ctrl+Retour
• * Menu "Maths" :
o * Mode mathématique en ligne : Ctrl+Maj+M
o * Afficher le mode mathématique : Alt+Maj+M
o * Équations numérotées : Ctrl+Maj+N
o * Indice : Ctrl+Maj+D
o * Exposant : CTrl+Maj+U
o * Frac : Alt+Maj+F
o * Dfrac : Ctrl+Maj+F
o * Carré : Ctrl+Maj+Q
o * Gauche : Ctrl+Maj+L
o * Droite : Ctrl+Maj+R
• Menu "Utilisateur" :
o Balises utilisateur : Maj+F1...Maj+F10
o Commandes utilisateur : Maj+Alt+F1...Maj+Alt+F10

4.11 Le panneau "Visionneuse source"

Pour faciliter les opérations de copier/coller entre deux documents, les
utilisateurs peuvent ouvrir un document (en mode lecture seule) à côté de
l'éditeur avec le panneau "Source Viewer".
Un outil visuel diff permet de voir les différences entre les fichiers en cours
chargés dans l'éditeur et dans le "source viewer".

4.12 Option "Utiliser un sous-répertoire

'build'..." pour la commande (pdf)latex
En utilisant cette option (configurer Texmaker -> Commandes), le
paramètre "--output-directory=build" sera automatiquement ajouté à la
commande (pdf)latex et texmaker recherchera les fichiers log et pdf dans ce
sous-répertoire (le "build " le sous-répertoire est automatiquement créé par
Texmaker).
Remarques :
• Pour les autres commandes, l'utilisateur devra probablement remplacer
"%" par "build/%". Sinon, ces commandes échoueront
probablement. Exemples (sur système linux) :
o dvips -o build/%.ps build/%.dvi
o construction ps2pdf/%.ps construction/%.pdf
o construction bibtex/%.aux
• Si cette option est cochée, la commande "clean" fera une copie des
fichiers ps/pdf du sous-répertoire "build" vers le répertoire courant et
supprimera tous les autres fichiers du sous-répertoire "build" (le fichier
pdf n'est pas supprimé car Texmaker l'utilise pour la visionneuse pdf).

4.13 Remplacer du texte par une expression

régulière
Le paramètre $1 doit être utilisé pour le texte capturé et l'option "Regular
Expression" doit être cochée (cliquez sur le bouton "+")
Par exemple (pour remplacer tous les \textit{foo} par \textbf{foo}) :
• Champ "Rechercher" : \\textit\{([^}]*)\}
• Champ "Remplacer" : \textbf{$1}

4.14 Utiliser Texmaker comme éditeur

Asymptote
• Pour le code asymptote intégré dans un document latex, utilisez
simplement le mode "PdfLaTex+Asymptote+PdfLaTeX+View Pdf" pour
la commande de construction rapide.
• Texmaker peut également être utilisé pour éditer et compiler
directement une figure asymptote non intégrée dans un document
latex. Si le document en cours est un fichier .asy, la commande "Quick
build" (F1) lancera automatiquement la commande spéciale "quick
 build" pour les fichiers .asy définie dans la boîte de dialogue de
configuration.

4.15 Extension des fonctionnalités de

l'éditeur avec des scripts
Les utilisateurs avancés peuvent étendre les fonctionnalités de l'éditeur en
exécutant des scripts via le menu "Utilisateur".
• Les scripts doivent être écrits en javascript (qtscript).
• Les fichiers de script doivent avoir l' extension .tms .
• Fonctions disponibles :
o TM.text : retourne tout le texte
o TM.cursorPosition : renvoie la position actuelle du curseur
o TM.selection : renvoie le texte sélectionné
o TM.selectionStart : renvoie la position du début de la sélection
o TM.selectionLength : renvoie la longueur du texte sélectionné
o TM.selectRange(start,length) : place le curseur à la position de
départ depuis le début du document, puis sélectionne autant de
texte qu'indiqué par le paramètre de longueur.
o TM.insertText(string) : insère une chaîne à la position actuelle (et
remplace le texte sélectionné par la chaîne si du texte est
sélectionné)
o Les méthodes publiques de l'objet QPlainTextEdit sont également
disponibles.
Remarques :
• pour utiliser les scripts TexWorks, le préfixe TW.target doit être remplacé
par TM. .
• les fichiers de script peuvent être situés n'importe où (le dernier
répertoire utilisé sera stocké dans le fichier de configuration de
texmaker).