Utiliser SyncTeX avec LaTeX

Travailler sous X_ƎT_eX implique que l’on écrive dans une application (TeXShop, TextMate, etc.) et que l’on visionne le résultat sous un lecteur de fichier de type pdf (Acrobat Reader, Skim, etc.). Il est souvent pratique pour visionner le résultat ou corriger certaines choses de pouvoir passer d’un document à l’autre, d’un endroit du fichier texte immédiatement à l’endroit correspondant du fichier pdf et vice-versa.

Dans un passé récent, pour ce faire, soit on appelait le paquet pdfsync avec la commande \usepackage{pdfsync} insérée dans le préambule, soit on configurait son éditeur de texte pour utiliser pdfsync par défaut. Depuis la distribution T_eX de 2008 on peut utiliser SyncTeX, écrit par Jerôme Laurens, auteur de psfsync. SyncTeX remplace donc pdfsync.

SyncTeX évite de charger un paquet, permet une synchronisation plus précise entre les deux fichiers, évite tout problème de compatibilité, etc.

Pour assurer la synchronisation SyncTeX crée un fichier auxiliaire de la forme nomdufichier.synctex.gz.

Plusieurs éditeurs utilisent SyncTeX par défaut maintenant. Il faut bien sûr s’assurer d’utiliser la dernière mouture de votre éditeur de texte. Ainsi en TeXShop Synctex est dès à présent utilisé par défaut (Préférences>Composition>Méthode de synchronisation). Synctex est également appelé sous Préférences>Moteurs>pdfTex. SyncTeX est également utilisé par défaut avec TextMate. Si SyncTex n’est pas utilisé par défaut, on peut utiliser la commande -synctex=1 si on compile par le terminal ou ajouter la ligne suivante dans le préambule du fichier tex.

Pour désactiver SyncTeX, il suffit de mettre la commande en commentaire dans le fichier tex ou de mettre synctex=0 là où se trouve synctex=1. Dans TextMate il suffit de mettre -synctex=0 dans les options des Préférences du bundle de L^aT_eX.

Pour passer du fichier tex au fichier pdf en TextMate faites ⌃⌥⌘-o (la lettre o, pas le chiffre zéro), en TeXShop ⌘-click.

À l’inverse, pour passer du fichier pdf au fichier tex, dans le fichier pdf en TextMate faites ⇧ ⌘-click, en TeXShop ⌘-click à l’endroit où vous voulez vous retrouver dans le fichier source.

En Skim un petit point rouge apparaît par défaut dans le fichier pdf à l’endroit recherché. La couleur peut être modifiée dans les préférences. Les marques de repères ne seront pas imprimées.

Si votre écran est assez grand ou que vous travaillez sur deux écrans, vous pouvez laisser les deux fichiers ouverts, ce qui facile les choses. N’oubliez pas que le fichier pdf que vous visualisez est celui de la dernière compilation, sauf si votre lecteur pdf rafraîchit automatiquement le fichier.

Chez moi cela fonctionne sans problèmes avec X_ƎT_eX et TextMate sur Léopard.

Quelques liens

• Présentation en anglais de SyncTeX par Jérôme Laurens, son développeur.
• Page officielle de SyncTeX
• Voir aussi SyncTeX sur Cuk.ch qui explique quelques détails supplémentaires pour TeXShop.
• Wiki en anglais avec explications pour différents éditeurs de texte.