TeXShop (Mac)

TeXShop est un environnement TeX gratuit et open source, macOS uniquement, écrit par Richard Koch. L'aperçu de Editor et de PDF se trouve côte à côte dans une seule fenêtre, et il est fourni avec MacTeX, installé dans /Applications/TeX/. C'est également l'original sur lequel le dernier TeXworks a été modelé. Cette page se concentre sur les deux choses qui comptent le plus au début : la configuration de la composition (quel moteur compile votre document) et SyncTeX, pour passer de la source à PDF.

Qu'est-ce que TeXShop

TeXShop est une application uniquement macOS que Richard Koch, mathématicien à l'Université de l'Oregon, a développée depuis environ l'an 2000 ; sa licence est GPLv2 (logiciel libre). Il ne regroupe pas LaTeX lui-même : il fonctionne en lançant les commandes d'une distribution TeX installée séparément (pdflatex, lualatex, latexmk, etc.) en arrière-plan. Sur un Mac, MacTeX installe ce moteur TeX (TeX Live) et TeXShop ensemble, donc sa grande commodité est que vous pouvez commencer à l'utiliser sans configuration supplémentaire.

MacTeX-2026 contient TeX Live 2026 et place ses applications GUI — TeXShop avec TeX Live Utility, LaTeXiT, BibDesk et hintView — dans le dossier /Applications/TeX/ (le moteur TeX lui-même réside sous /usr/local/texlive/2026/). MacTeX-2026 prend en charge macOS 11 Big Sur et versions ultérieures, à la fois sur Intel et Apple Silicon, et le TeXShop actuel (v5.57, octobre 2025) fonctionne de High Sierra à Tahoe – un choix fiable et établi depuis longtemps. Pour macOS 26 Tahoe en particulier, TUG est également livré avec une version spéciale TeXShop 5.58 avec prise en charge de Liquid Glass, publiée aux côtés de MacTeX-2026 le 2 mars 2026.

TeXShop est également connu comme l'éditeur sur lequel le dernier TeXworks multiplateforme a été directement modélisé. Les deux partagent la même sensation simple : la source à gauche, PDF à droite, un bouton Typeset en haut pour compiler - donc l'apprentissage de TeXShop se poursuit presque inchangé dans TeXworks.

Configuration de la composition

Le cœur de TeXShop est le bouton Typeset en haut de la fenêtre. Appuyez dessus (ou ⌘T) et le document est compilé avec le moteur actuel, avec le PDF apparaissant à droite. Pour effacer les fichiers intermédiaires avant la recompilation, utilisez ⌥⌘T (Trash AUX et Typeset). Le moteur qui compile votre document est choisi dans le menu contextuel immédiatement à droite du bouton Typeset.

Ce que cette liste contextuelle contient sont des moteurs. Par défaut, vous pouvez choisir LaTeX (qui crée un PDF par la route latex → dvips → ps2pdf), pdfLaTeX, LuaLaTeX, XeLaTeX, et plus encore. Ceux-ci sont sauvegardés par de vrais fichiers : TeXShop lit les fichiers .engine dans le dossier ~/Library/TeXShop/Engines/ et affiche chacun d'eux sous forme d'entrée de menu. En d’autres termes, chaque moteur est un court script shell que vous pouvez librement ajouter ou modifier.

La famille de moteurs qui appelle l'outil de construction latexmk est particulièrement pratique. Avec pdflatexmk, lualatexmk et xelatexmk, latexmk gère automatiquement les réexécutions nécessaires à la bibliographie, à l'index et aux références croisées, donc une seule composition termine le PDF. En revanche, un moteur qui n'utilise pas latexmk (comme le simple LuaLaTeX) peut nécessiter que vous appuyiez sur Typeset deux ou trois fois avant que les références croisées et la table des matières ne soient réglées. À l'intérieur du TeXShop, ces moteurs *latexmk se trouvent initialement dans Engines/Inactive/Latexmk/ ; pour en utiliser un, déplacez-le vers Engines/ et redémarrez TeXShop.

Le moteur que vous sélectionnez dans la fenêtre contextuelle est un choix temporaire pour ce document. Pour faire d'un moteur le moteur par défaut, ouvrez TeXShop → Préférences → Typeset et définissez le moteur souhaité (pdfLaTeX ou LuaLaTeX, par exemple) sous « Commande par défaut ». À partir de là, les nouveaux documents se compilent avec ce moteur.

Trois réglages à régler sur un Mac

Après avoir installé MacTeX et TeXShop, vous pouvez commencer à écrire immédiatement. Pour les rapports et thèses japonais, cependant, il est utile de régler l'encodage, le moteur par défaut et la gestion des réexécutions avant que le manuscrit ne s'agrandisse.

• Dans l'onglet Source, définissez le codage par défaut sur Unicode (UTF-8).
• Dans l'onglet Typeset, choisissez le moteur quotidien : LuaLaTeX pour un nouveau projet japonais, ou la famille upLaTeX pour les modèles hérités.
• Pour les documents comportant une table des matières, des références croisées ou une bibliographie, utilisez un moteur latexmk pour automatiser les réexécutions.
• Lorsqu'un manuscrit nécessite des paramètres différents, épinglez-les avec % !TEX TS-program et % !TEX encoding en haut du fichier.

Une base de référence de manuscrit Mac stable

Étant donné que TeXShop fonctionne immédiatement avec MacTeX, il est facile de commencer à écrire sans penser à la configuration. Pour un long manuscrit japonais, passer les premières minutes sur une base de référence est rentable plus tard : rendez le fichier d'entrée, le moteur et l'encodage explicites, et utilisez un moteur latexmk pour automatiser les réexécutions.

% !TEX TS-program = lualatexmk
% !TEX encoding = UTF-8 Unicode
\documentclass{ltjsarticle}
\begin{document}
\section{はじめに}
本文を書き始めます。
\end{document}

• Pour un nouveau manuscrit japonais, choisissez tôt entre une route LuaLaTeX et une route upLaTeX.
• Si le document comporte une table des matières, des références croisées ou une bibliographie, utilisez lualatexmk, pdflatexmk ou un moteur similaire plutôt qu'un moteur unique.
• Si un modèle hérité suppose upLaTeX, suivez ce modèle au lieu de forcer une migration LuaLaTeX.
• Avant de diviser les fichiers enfants, confirmez que main.tex produit à lui seul un PDF une fois.

Directives par fichier (les lignes % !TEX)

Pour cerner le moteur ou l'encodage des caractères par document, les lignes % !TEX (commentaires magiques) placées en haut d'un fichier sont pratiques. Pour LaTeX, ce ne sont que de simples commentaires (tout ce qui suit % est ignoré), mais TeXShop les lit et ajuste son comportement. Trois sont d'usage courant :

Par exemple, placer cette seule ligne en haut d'un document permet à ce document d'être compilé avec LuaLaTeX, quelle que soit la sélection contextuelle. La valeur est simplement un nom de moteur (le nom d'un .engine dans Engines/) :

% !TEX TS-program = lualatex
% !TEX encoding = UTF-8 Unicode
\documentclass{article}
\begin{document}
Hello, \LaTeX!
\end{document}

L'encodage mérite du soin. Le TeXShop actuel est livré avec un codage par défaut de IsoLatin9, donc enregistrer le japonais tel quel le tronque. Il est plus sûr soit de changer la valeur par défaut en « Unicode (UTF-8) » dans la section d'encodage de l'onglet Préférences → Source, soit d'écrire % !TEX encoding = UTF-8 Unicode dans chaque fichier comme ci-dessus.

Configuration du moteur pour le japonais

Pour les Japonais, il existe deux routes principales. L'un d'entre eux est LuaLaTeX : il gère directement Unicode et peut utiliser les polices du système, ce qui en fait le choix simple pour un nouveau départ. Choisissez simplement LuaLaTeX dans la fenêtre contextuelle (ou lualatexmk, qui s'exécute automatiquement). Pour que les nouveaux documents utilisent toujours le japonais LuaLaTeX, définissez la « Commande par défaut » décrite ci-dessus sur LuaLaTeX.

L'autre est upLaTeX + dvipdfmx, qui est depuis longtemps la norme pour le japonais. TeXShop fournit des moteurs qui appellent ptex2pdf (le script Lua fourni avec TeX Live) pour les familles pTeX et upTeX, ainsi que des moteurs qui pilotent upLaTeX → dvipdfmx via latexmk. Le corps d'un tel .engine correspond à peu près à la seule ligne ci-dessous ; l'inclusion de -synctex=1 fait également fonctionner le prochain SyncTeX décrit :

#!/bin/sh
ptex2pdf -l -u -ot "-synctex=1 -file-line-error" "$1"

Ici, ptex2pdf -l -u signifie « compiler avec upLaTeX, puis créer un PDF avec dvipdfmx », et -ot transmet des options supplémentaires au moteur. L'ajout de -file-line-error fait apparaître les erreurs sous la forme « file:line », ce qui facilite le passage à la cause. Conservez également les documents japonais dans UTF-8 et, comme dans la section précédente, définir le codage par défaut sur UTF-8 évite tout problème.

SyncTeX (recherche avant et arrière)

SyncTeX mappe les lignes source aux positions dans PDF et inversement. Lorsque cela fonctionne, vous obtenez une recherche avant — sautant de la ligne sur laquelle vous vous trouvez dans la source à l'endroit correspondant dans le PDF — et une recherche inverse, sautant d'un endroit du PDF à la ligne source correspondante. Cela s’avère payant lors de la relecture : la recherche de « quelle ligne a produit ce paragraphe » disparaît tout simplement.

Dans TeXShop moderne, les moteurs standard incluent déjà -synctex=1, donc SyncTeX est activé par défaut (uniquement lorsque vous utilisez un moteur fait maison, vous devez vous rappeler d'inclure -synctex=1, comme dans l'exemple ci-dessus). Le fichier de synchronisation (.synctex.gz) est produit automatiquement lors de la composition.

Le geste est merveilleusement simple : ⌘-cliquez, dans les deux sens. ⌘-cliquez sur le texte dans l'aperçu pour revenir à la ligne source qui l'a produit (recherche inverse). À l'inverse, ⌘-cliquez dans la source pour accéder à la position correspondante dans le PDF (recherche avant). Même dans les longs manuscrits ou les projets multi-fichiers, vous pouvez aligner ce que vous consultez avec sa source en un instant.