Chaque thème est le goût de quelqu'un d'autre. Trente sont livrés avec Codeshot, chacun en variante claire et sombre, et il y en a presque toujours un qui convient à peu près — mais à peu près est une drôle de limite pour une image qui porte votre nom.

Sur le Mac, vous n'avez plus à vous en contenter. Réglages → Thèmes vous donne un thème à vous : treize couleurs, un aperçu qui se redessine au fil de vos choix, et un fichier que vous pouvez remettre à quelqu'un.

Où ça se trouve

Ouvrez les réglages de Codeshot et allez dans l'onglet Thèmes. À gauche, la liste de vos thèmes. + en ajoute un, − supprime celui qui est sélectionné.

À droite, un extrait d'exemple dans le thème sélectionné, un champ de nom en dessous, puis la liste des couleurs. Tout ce panneau est vivant : changez une couleur et l'exemple au-dessus se redessine aussitôt.

Deux commandes comptent. Le champ de nom renomme le thème. Use This Theme en fait le thème avec lequel l'app dessine réellement — modifier un thème ne bascule pas dessus, et c'est l'étape qu'on oublie.

Les treize couleurs

Un thème de syntaxe, ce n'est pas treize décisions de poids égal. Deux posent l'ambiance, onze font le travail.

Couleur Ce qu'elle couvre
Background Le papier derrière le code
Plain Text Tout ce que la coloration ne revendique pas : ponctuation, parenthèses, opérateurs
Keywords let, var, struct, func, return
Strings Le texte entre guillemets
Numbers Les littéraux numériques
Comments Commentaires et documentation
Declared Types Les types définis dans l'extrait lui-même
Library Types Les types venus du framework : String, View, CGFloat
Functions Noms de fonctions et de méthodes
Members Propriétés et membres auxquels on accède sur autre chose
Variables Noms de variables
Annotations Property wrappers et annotations, @State et consorts
Attributes Noms d'attributs, surtout dans les langages de balisage

Vous n'avez pas à remplir les treize avec des couleurs différentes. Les thèmes qui se lisent bien tiennent en général sur quatre ou cinq teintes qu'ils réutilisent : types et fonctions en partagent une, mots-clés et annotations une autre. Treize couleurs distinctes, ce n'est pas un thème, c'est une corbeille de fruits.

Une méthode qui marche

Commencez par Background et Plain Text, et réglez cette paire avant de toucher au reste. Toutes les autres décisions se jugent par rapport à elles : les choisir en dernier revient à tout rechoisir.

Ensuite Comments, et en sourdine. Les commentaires sont le seul token qui doit s'effacer — ils sont du contexte, pas du code. Un thème où les commentaires crient aussi fort que les mots-clés se lit comme du bruit, quelle que soit la qualité du reste de la palette.

Puis les mots-clés, les chaînes et les nombres, là où atterrit l'essentiel de la couleur dans un vrai extrait. Types, fonctions et membres après, et les derniers peuvent très bien réutiliser des couleurs déjà choisies.

Regardez l'aperçu à chaque étape, pas seulement à la fin. Le panneau est là pour juger la palette sur du vrai code — les sélecteurs de couleur mentent, le code non.

À savoir avant de choisir

Le contraste n'est pas facultatif. Les images de code sont réduites dans un fil, regardées sur un téléphone en plein jour et recompressées par la plateforme où vous les publiez. Une palette discrète et peu contrastée, élégante en taille réelle, est illisible une fois arrivée chez les gens. Si une couleur est difficile à lire dans l'aperçu, elle a disparu dans le fil.

Évitez le noir pur en fond, sauf export en transparence ou sur un arrière-plan sombre. Devant un fond d'écran lumineux, #000000 se lit comme un trou. Les bons thèmes sombres tournent autour de #1F1F24 à #282C34 précisément pour cette raison.

Commentaires et texte brut doivent différer. S'ils tombent à une luminosité voisine, prose et code se fondent en un bloc gris et la forme de l'extrait disparaît.

Reprenez votre éditeur si vous voulez, mais vérifiez hors contexte. Un thème Xcode est réglé pour une grande fenêtre sur un bureau. Les mêmes couleurs dans une image de 1000 pixels de large sur le téléphone de quelqu'un, c'est autre chose, et cela demande en général un peu plus de contraste que l'original.

Partager un thème

Le menu ⋯ en bas de la liste des thèmes importe et exporte des fichiers de thème.

L'export écrit le thème dans un fichier, l'import le relit. C'est ainsi qu'un thème passe de votre Mac à votre autre Mac, à une sauvegarde ou à quelqu'un de votre équipe — et c'est ce qui rend une palette maison praticable à plusieurs.

Quand les trente fournis sont la meilleure réponse

Construire un thème vaut le coup quand vous produisez des images régulièrement et voulez qu'elles forment un ensemble : une série de publications, la documentation d'un produit, les diapositives d'une conférence.

Pour un extrait isolé, non. Les trente livrés avec l'app sont tous conçus proprement, tous en clair et sombre, et à deux clics. Comparez-les côte à côte et prenez celui qui convient à l'extrait.

L'éditeur existe pour le cas où vous avez déjà fait cela et où la réponse était encore presque.