Ogni tema è il gusto di qualcun altro. Trenta arrivano con Codeshot, ognuno in variante chiara e scura, e di solito uno ci va abbastanza vicino — ma abbastanza vicino è un traguardo strano per un'immagine che porta il tuo nome.

Sul Mac non devi più accontentarti. Impostazioni → Temi ti dà un tema tuo: tredici colori, un'anteprima che si ridisegna mentre scegli e un file che puoi consegnare a qualcuno.

Dove si trova

Apri le impostazioni di Codeshot e vai alla scheda Temi. A sinistra c'è l'elenco dei tuoi temi. + ne aggiunge uno, rimuove quello selezionato.

A destra c'è uno snippet di esempio nel tema selezionato, sotto un campo per il nome e più in basso l'elenco dei colori. Tutto quel pannello è vivo: cambia un colore e l'esempio sopra si ridisegna subito.

Due comandi contano. Il campo del nome rinomina il tema. Use This Theme lo rende il tema con cui l'app disegna davvero — modificare un tema non ci passa sopra, ed è il passaggio che si dimentica.

I tredici colori

Un tema di sintassi non è fatto di tredici decisioni di pari peso. Due danno il tono, undici fanno il lavoro.

Colore Che cosa copre
Background La carta dietro il codice
Plain Text Tutto ciò che l'evidenziatore non rivendica: punteggiatura, parentesi, operatori
Keywords let, var, struct, func, return
Strings Testo tra virgolette
Numbers Letterali numerici
Comments Commenti e documentazione
Declared Types Tipi definiti nello snippet stesso
Library Types Tipi che arrivano dal framework: String, View, CGFloat
Functions Nomi di funzioni e metodi
Members Proprietà e membri a cui si accede su qualcos'altro
Variables Nomi di variabili
Annotations Property wrapper e annotazioni, @State e simili
Attributes Nomi di attributi, soprattutto nei linguaggi di markup

Non devi riempire tutti e tredici con colori diversi. I temi che si leggono bene usano quattro o cinque tinte e le ripetono: tipi e funzioni ne condividono una, parole chiave e annotazioni un'altra. Tredici colori distinti non sono un tema, sono un cesto di frutta.

Un metodo che funziona

Parti da Background e Plain Text, e sistema quella coppia prima di toccare altro. Ogni altra decisione si giudica rispetto a loro, quindi sceglierli per ultimi significa riscegliere tutto.

Poi imposta Comments, e impostali spenti. I commenti sono l'unico token che deve arretrare: sono contesto, non codice. Un tema in cui i commenti gridano quanto le parole chiave si legge come rumore, per quanto sia buona la palette restante.

Poi parole chiave, stringhe e numeri, dove finisce gran parte del colore in uno snippet reale. Tipi, funzioni e membri dopo, e gli ultimi possono benissimo ripetere colori già scelti.

Guarda l'anteprima a ogni passo, non alla fine. Il pannello serve proprio a giudicare la palette su codice vero — i selettori di colore mentono, il codice no.

Cose da sapere prima di scegliere

Il contrasto non è opzionale. Le immagini di codice vengono rimpicciolite in un feed, guardate su un telefono alla luce del giorno e ricompresse dalla piattaforma su cui pubblichi. Una palette sobria e a basso contrasto, raffinata a dimensione piena, è illeggibile quando arriva a destinazione. Se un colore è difficile da leggere nell'anteprima, nel feed non c'è più.

Evita i fondi neri puri, a meno che tu non esporti con trasparenza o su uno sfondo scuro. Su uno sfondo luminoso #000000 si legge come un buco. I temi scuri riusciti stanno tra #1F1F24 e #282C34 proprio per questo.

Commenti e testo normale devono differire. Se cadono su una luminosità simile, prosa e codice si fondono in un blocco grigio e la forma dello snippet sparisce.

Copia pure il tuo editor, ma verificalo fuori contesto. Un tema di Xcode è pensato per una finestra grande su una scrivania. Gli stessi colori in un'immagine larga 1000 pixel sul telefono di qualcuno sono un'altra faccenda, e di solito chiedono un po' più di contrasto dell'originale.

Condividere un tema

Il menu in fondo all'elenco dei temi importa ed esporta file di tema.

L'esportazione scrive il tema come file, l'importazione lo rilegge. È così che un tema passa dal tuo Mac all'altro tuo Mac, a un backup o a qualcuno del team — ed è ciò che rende praticabile una palette condivisa per più di una persona.

Quando i trenta inclusi sono la risposta migliore

Costruire un tema conviene se produci immagini con regolarità e vuoi che sembrino una serie: una sequenza di post, la documentazione di un prodotto, le slide di un intervento.

Per uno snippet isolato no. I trenta che arrivano con l'app sono tutti progettati per bene, tutti in chiaro e scuro, e sono a due clic. Confrontali affiancati e prendi quello che sta bene allo snippet.

L'editor c'è per il caso in cui l'hai già fatto e la risposta era ancora quasi.