Fare uno screenshot della finestra di Xcode è la mossa ovvia, ed è quella che dà il risultato peggiore. La cattura si porta dietro tutto il resto che c'era a schermo: il cursore, l'evidenziazione della selezione, la barra laterale e la larghezza dell'editor invece di quella che serve al tuo codice.
Copia il testo, piuttosto. Ecco tutto il procedimento.
1. Copia il codice, non lo schermo
Seleziona il codice in Xcode e premi ⌘C. Poi incollalo in Codeshot con ⌘⇧V.
Lo snippet viene ricolorato da zero, quindi non si porta dietro nulla dello stato dell'editor di Xcode. Niente cursore, niente selezione, niente icone laterali. Solo il codice.
Sistema anche l'indentazione. Xcode usa le tabulazioni per impostazione predefinita, e in molti posti in cui incollerai una tabulazione risulterà molto più larga del previsto. Partire dal testo significa decidere tu come appare.
2. Scegli un tema
Codeshot include un tema Xcode in chiaro e scuro. Coincide con ciò che il tuo pubblico guarda già ogni giorno, quindi è un default sicuro.
Il motivo per sceglierne un altro è il contrasto. Il tema chiaro di Xcode è piuttosto morbido: va benissimo a dimensione piena nell'editor, meno bene quando l'immagine si rimpicciolisce in un feed. Se verrà guardata in piccolo, prendi un tema più contrastato. Puoi confrontarli tutti e 30 qui.
3. Taglia
Dieci-quindici righe sono più o meno il limite di ciò che resta leggibile su un telefono. Un file intero non lo è.
Prima di copiare, richiudi le parti che non sono il punto e tieni solo ciò che regge il tuo discorso. Se serve davvero del contesto, una riga di commento in cima lavora più di venti righe di codice attorno.
4. Dimensiona ed esporta
Lascia che la dimensione segua il contenuto, oppure bloccala su un rapporto. I formati larghi come il 16:9 evitano che le righe lunghe vadano a capo. Quelli alti come il 3:4 sprecano meno spazio quando lo snippet è stretto.
Esporta a 2× o 3×, mai a 1×, altrimenti su uno schermo retina sembrerà sfocato. Poi salva con ⌘S, o copia direttamente negli appunti con ⌘⇧C.
Ecco fatto
Copia, tema, taglia, esporta. Una volta impostati tema e dimensione restano, quindi ogni snippet dopo il primo richiede pochi secondi.
Codeshot gira interamente sul tuo Mac e non carica mai il tuo codice: cosa che conta se quello che pubblichi appartiene a un cliente o a una build non ancora uscita.
C'è una pagina dedicata a Swift con consigli sui temi, e il flusso generale se non arrivi da Xcode.