Adaptation de T_EXworks

A.1 Mise en évidence de la Syntaxe

Parmi beaucoup d’autres caractéristiques, T_EXworks inclut aussi la mise évidence de la syntaxe. Cela signifie que certaines choses comme les commandes LaTeX, les environnements ou les commentaires sont colorés, soulignés ou mis en évidence d’une façon ou d’une autre. T_EXworks fournit aussi la possibilité de basculer entre différentes combinaisons de mise en évidence¹ et pour vos propres combinaisons. Ceci est utile si vous travaillez souvent avec des types de fichiers pour lesquels aucun système de mise en évidence n’est fourni par défaut, ou si vous voulez ajuster les combinaisons our mieux correspondre aux vôtres.

Pour modifier les combinaisons de mise en évidence, vous devez éditer le fichier texte <resources>/configuration/syntax-patterns.txt. Ce fichier contient un nombre de sections individuelles, chacune définissant une combinaison unique de mise en valeur à afficher dans la structure des menus de T_EXworks. Pour définir une section, écrivez uniquement le nom entouré de crochets sur une ligne. À l’évidence ces noms de doivent pas comprendre le caractère ]. Par défaut, les deux sections suivantes sont définies :

[LaTeX] 
[ConTeXt]

De plus, vous pouvez ajouter des commentaires dans le fichier en commençant une ligne par #. Les lignes vides sont ignorées.

Chaque section comprend un nombre arbitraire de règles. Chacune de ces instructions consiste en trois partie : une instruction de mise en forme, un signe de correction orthographique et une expression régulière² définissant quelle partie du texte correspond. Ces parties doivent toutes être sur la même ligne et séparées par des espaces (espaces ou caractères de tabulation). Prenez par exemple la ligne qui suit à partir de la section LaTeX par défaut :

red    Y    %.*

La première partie, red, définit le format (dans ce cas, une couleur rouge d’avant plan est spécifiée). La seconde partie, Y, précise que la correction orthographique doit être activée pour du texte qui correspond cette règle en particulier. Parfois, il est utile de mettre N à cet endroit pour désactiver la correction orthographique. Par exemple, si la correction était active pour les commandes de LaTeX, la plupart des documents seraient envahis de texte souligné en rouge indiquant des mots mal orthographiés alors qu’en fait ils ne sont que des commandes spéciales. Enfin, la troisième partie spécifie que cette règle doit être appliquée à tout texte précédé de %.

Regardons plus attentivement aux trois parties de chaque règle. Dans sa forme la plus générale, la première partie – l’instruction de formatage – ressemble à

<foreground_colour>/<background_colour>;<fontflags>

<fontflags> peut spécifier indépendamment des couleurs (notez cependant qu’il doit toujours être précédé d’un ;). La couleur d’arrière plan (ainsi que le /) peut être omise, mais si vous la spécifiez, vous devez aussi spécifier la couleur d’avant plan.

Chaque couleur peut être spécifiée soit par un nom SVG³, soit par une valeur hexadécimale (#rrggbb⁴) similaire aux documents web. Le <fontflahs> peut être toute combinaison des lettres B (gras), I (italique) et U (souligné).

Exemples d’instructions de mise en forme valides :

red 
white/#000000 
;B 
blue;I 
 #000000/#ffff00;U

A.2 Raccourcis clavier

L’utilisation des raccourcis clavier facilite grandement la saisie de la source et la gestion de celle-ci et de la vue. pour des actions fréquemment répétées, leur utilisation est beaucoup plus efficace que l’utilisation de la souris sur des boutons de barres d’outils.

Nous donnons ci-après les raccourcis clavier pour le travail dans la source et pour celui dans la vue. Notez que sous macOS, Ctrl fait en réalité référence à la touche Commande, qui est le modificateur habituel des raccourcis clavier. Bien que les raccourcis clavier soient spécifiés avec Ctrl, celui-ci apparaîtra comme la touche Commande dans les menus. (Pour faire vraiment référence à la touche Contrôle sur la Mac, le fichier de définitions doit utiliser le nom Meta.)

Notez que les définitions ci-dessous sont celles par défaut de la version originelle en anglais. Des langues différentes peuvent utiliser des raccourcis différents.

Tous les raccourcis peuvent être redéfinis soit pour créer de nouveaux raccourcis ou pour modifier le raccourci existant pour se conformer aux habitudes personnelles ou changer des raccourcis non adaptés à un clavier particulier. La liste des actions possibles qui peuvent être associées à un raccourci est données après la liste des raccourcis prédéfinis.

Pour définir son propre raccourci, créer un fichier shortcuts.ini dans le sous-dossier <ressources>/configuration; s’y trouvent déjà les fichiers auto-indent-patterns.txt, delimiter-pairs.txt,..., texworks-config.txt.

Par exemple, ce fichier pourrait contenir :

actionHard_Wrap = Shift+F3 
actionLast_Page = Ctrl+End 
actionFirst_Page = Ctrl+Home 
actionWrap_Lines = F3 
actionLine_Numbers = F4 
actionBalance_Delimiters = F9

La première ligne dit que la frappe de MajF3 ouvre la boîte de dialogue du retour à la ligne physique; la deuxième CtrlEnd vous amène à la dernière page et CtrlHome (troisième ligne) à la première page; avec F3 vous obtenez le passage à la ligne automatique ou non dans la source, avec F4 vous montrez/cachez les numéros de ligne et avec F9 vous sélectionnez le texte entre délimiteurs correspondants de la source.

A.2.1 Raccourcis prédéfinis

Pour travailler dans la fenêtre source⁵

Déplacements du curseur (maintenir Shift ⇑ pour sélectionner) :

Pour travailler dans la vue .pdf :

A.2.2 Actions par ordre alphabétique

A.2.3 Actions listées par menu

Pour la fenêtre source :

Pour la fenêtre de vue :

A.2.4 Actions pour les outils de composition

En plus des actions statiques listées ci-dessus, il y a aussi des actions pour activer un outil de composition. Toutes ces actions sont de la forme générale actionTypesetTool<nom_outil où <nom_outil> doit être remplacé de façon appropriée. Par exemple, le nom correspondant à l’outil de composition pdfLaTeX est actionTypesetToolpdfLaTeX, celui correspondant à Mon␣outil est actionTypesetToolMon␣outil.⁶

A.2.5 Actions pour les scripts

Il y a aussi des actions pour les scripts. Elles sont dynamiques par nature, comme elles sont créées à la volée pour les scripts disponibles (qui peuvent changer quand vous installez des scripts, les retirez ou changez les paramètres.) Toutes ces actions sont de la forme Script:␣<titre_script>, où <titre_script> doit être remplacé de façon appropriée. Si vous avez un script qui se nomme Mon Script, par exemple, l’action correspondante sera appelée Script:␣Mon␣Script.

A.3 Les mots clé de complétion

Nous donnons ici les mots clé de complétion tels qu’ils sont fournis avec T_EXworks. Ils se trouvent dans les fichiers tw-basic.txt, tw-context.txt (initialement vide) et tw-latex.txt dans le répertoire <ressources>\completion.

Nous donnons les indications en trois colonnes : les deux premières montrent les mots clé, la troisième le code (L^A)T_EX résultat. Dans certains cas il n’y a que le résultat, cela signifie que l’on peut commencer à entrer le code (L^A)T_EX et essayer de le compléter par ⇆.

Lors de la complétion, le système insère des retours à la ligne et positionne le curseur de saisie au premier endroit où on doit entrer des informations pour compléter la saisie. Pour représenter les retours à la ligne nous avons utiliser R et pour marquer le point de saisie I.

Dès lors, une ligne telle que “\begin{abstract}RIR\end{abstract}∙” devrait être interprétée comme

\begin{abstract} 
 
\end{abstract}∙

avec le curseur positionné dans la ligne centrale, vide.

On remarquera que les mots clé présentent une certaine cohérence, les variables mathématiques ont un mot clé commençant par x, lorsqu’elles sont dans un environnement mathématique, quand elles sont utilisées seules dans le texte on ajoute d devant; par exemple xa et dxa pour \alpha, s’il y a une majuscule il y aura un c, comme xo pour \omega et xco pour \Omega. Les mots clé d’environnements commencent par b : bali pour \begin{align} (b mnémonique pour \begin). Lorsque l’environnement a des options possibles, on accole un ou plusieurs o au nom de base : bminp pour \begin{minipage}{}.. et bminpo pour \begin{minipage}[]{}...

Mots clé définis dans tw-basic.txt (définis dans T_EX) :

Mots clé définis dans tw-latex.txt (définis dans LaTeX) :

Mots clé définis dans tw-latex-pkg.txt (défini dans divers paquets) :

Mots clé définis dans tw-beamer.txt (défini by dans le paquet beamer) :

Mots clé définis dans tw-context.txt (définis dans ConT_EXt) :

On y trouve aussi des codes d’environnements (ci-dessus) sans le \begin{ (qui est aussi un mot clé); cela permet si on a commencé d’entrer le code d’un environnement, de le compléter par ⇆.