37 KiB
Introduzione
Avete presente tutti quegli screenshots di codice che vedete su Twitter? Anche se il codice è di solito impressionante, abbiamo visto un margine di miglioramento nel reparto estetico. Carbon rende facile creare e condividere belle immagini del vostro codice sorgente. Quindi cosa state aspettando? Andate a stupire tutti i vostri follower con la vostra ritrovata abilità nel design.
Caratteristiche
- Personalizzazione. Personalizza cose come il tema della sintassi della tua immagine, lo stile del carattere e altro ancora
- Condividi rapidamente. Salva la tua immagine o un link con un clic
- Salvare i frammenti. Crea un account per salvare i frammenti per dopo. Quelli condivisi vengono automaticamente dispiegati su Twitter e Slack.
Uso
Importazione
Ci sono alcuni differenti modi per importare codice in Carbon:
- Rilasciare un file nell'editor
- Aggiungere un ID GitHub gist all'URL (es.
carbon.now.sh/<gist_id_goes_here>) - O semplicemente iniziare a scrivere!
Personalizzazione
Una volta che avrete tutto il vostro codice in Carbon, potete personalizzare la vostra immagine cambiando il tema della sintassi, il colore dello sfondo, il tema della finestra, il padding, le ombre, i font e altro.
Esportazione e condivisione
Dopo aver personalizzato la tua immagine puoi condividere il tuo frammento in diversi modi
Creare un frammento salvato
Condividendo un frammento salvato, l'immagine si aprirà automaticamente su piattaforme come Twitter e Slack. Questo permette agli utenti di vedere la tua creazione, dando loro anche accesso al codice sorgente tramite il link. Meglio ancora, se hai bisogno di fare un aggiornamento, basta seguire il link per modificare direttamente lo snippet.
Per creare uno snippet salvato:
- Accedi usando il pulsante "Login/Sign up".
- Modifica come faresti normalmente - il tuo frammento verrà salvato automaticamente
- Copia l'URL dalla finestra del tuo browser e condividi!
Incorporare un frammento
Questo è il metodo raccomandato per condividere Carbon sul proprio sito web o blog. I lettori possono anche copiare il codice con il click di un pulsante.
Puoi incorporare qualsiasi frammento di Carbon nel tuo sito web direttamente usando carbon.now.sh/embed URL. Il "Menù copia" permette di copiare rapidamente il frammento iFrame corretto, o l'URL codificato per incorporarlo su piattaforme come Medium.
Infine, puoi anche incorporare frammenti salvati o gist di GitHub usando carbon.now.sh/embed/:id.
Usa il pulsante Tweet
Il pulsante Tweet non solo condividerà l'immagine su Twitter, ma codificherà anche correttamente l' alt per garantire che le tue immagini siano accessibili. Tuttavia, se vuoi twittare tu stesso le immagini, controlla come rendere accessibili le tue immagini su Twitter..
Scarica direttamente l'immagine
Carbon supporta il download della vostra immagine come PNG e SVG. Potete anche cliccare Export → Open per aprire la tua immagine direttamente nel browser. Infine, potete copiare l'immagine di Carbon direttamente negli appunti andando su Copy → Image.
Installazione di Carbon for Desktop (offline)
Se state usando Google Chrome, o un altro browser che supporta Progressive Web Apps, potete installare Carbon per l'uso offline:
- Visita carbon.now.sh
- Clicca sul menu delle impostazioni del tuo browser
- Clicca "Installa Carbon..."
Comunità
Guarda questi progetti che la nostra fantastica comunità ha creato:
Plugin per l'editor
- IntelliJ IDEA
carbon-now-sh- Aprire la selezione nel file IntelliJ IDEA corrente in Carbon attraverso un menù contestuale - Atom
carbon-now-sh- Aprite il vostro file Atom attuale in Carbon conshift-cmd-A - VS Code
carbon-now-sh- Aprite il vostro attuale file VS Code in Carbon con il comandocarbon - Sublime Text 3
carbon-now-sh- Aprire la selezione nel tuo file Sublime Text 3 corrente con una chiave vincolata personalizzata - Vim
carbon-now-sh- Aprite la selezione nel vostro Vim/Neovim corrente usando la funzioneCarbonNowSh() - Emacs
carbon-now-sh- Aprite la selezione nel vostro Emacs attuale usando la funzione interattivacarbon-now-sh - Xcode
carbon-now-sh- Aprire la selezione corrente incarbon.now.sh - Xcode
nef- Questa estensione Xcode permette di esportare una selezione di codice come frammento di Carbon in una sola azione
Strumenti
- CLI
carbon-now-cli- Aprire un file in Carbon o scaricarlo direttamente usandocarbon-now, con una modalità interattiva, evidenziazione selettiva e altro ancora - CodeExpander - Un client GitHub gist intelligente con le caratteristiche di TextExpander
nef- Esportare più frammenti di codice Carbon daXcode Playground@carbonshbot- Un bot Telegram che prende un frammento di codice o un URL gist e genera un'immagine Carbon- R
carbonate- Manipolare iterativamente l'estetica delle immagini inRe aprire in Carbon o scaricare direttamente.
Citazioni
- "CS 101 - An Introduction to Computational Thinking" - un libro di testo di informatica di Sarbo Roy.
Autori
Carbon è un progetto di:
- Mike Fix (@mfix22)
- Brian Dennis (@briandennis)
- Jake Dexheimer (@jakedex)
Licenza
Contribuire e Sostenere
Le richieste di pull sono benvenute! Vedi le nostre linee guida per i contributi per maggiori dettagli.
Sponsor e finanziatori
Grazie a
▲ Vercel per aver sponsorizzato l'hosting di Carbon.
Tutti i collaboratori
Grazie a tutte queste persone meravigliose (emoji key):
