39 KiB
Introductie
Ken je al die code screenshots die je ziet op Twitter? Hoewel de code meestal indrukwekkend is, zagen we ruimte voor verbetering op esthetisch gebied. Carbon maakt het makkelijk om mooie afbeeldingen van je broncode te maken en te delen. Dus, waar wacht je nog op? Maak indruk op al je volgers met je nieuwe ontwerpvaardigheden.
Kenmerken
- Personalisatie. Pas dingen voor je afbeelding aan, zoals syntax-thema, lettertype en meer
- Snel delen. Sla je afbeelding of een link op met één klik
- Bewaar snippets. Maak een account om fragmenten/snippets te bewaren voor later. Gedeelde snippets worden automatisch uitgevouwen op Twitter en Slack.
Gebruik
Importeren
Er zijn een aantal verschillende manieren om code te importeren in Carbon:
- Sleep een bestand naar de editor
- Voeg een GitHub-gist-ID toe aan het webadres (bijv.
carbon.now.sh/<gist_id_hier>
) - Of begin gewoon te typen!
Personalisatie
Wanneer je al je code in Carbon hebt staan, kun je de afbeelding aanpassen door het veranderen van het syntax-thema, de achtergrondkleur, het vensterthema, de padding, de schaduwen, het lettertype en meer.
Exporteren & delen
Nadat je de afbeelding hebt aangepast, kun je deze op een aantal verschillende manieren delen
Maak een bewaarde snippet
Bij het delen van een bewaarde snippet zal de afbeelding automatisch uitvouwen op platformen als Twitter en Slack. Op deze manier kunnen gebruikers je creatie zien, terwijl ze ook toegang hebben tot de broncode via de link. Beter nog, als je een aanpassing wil maken, kun je zelf de link volgen om je snippet meteen te bewerken.
Om een bewaarde snippet te maken:
- Log in met de "Sign in/Sign up"-knop
- Bewerk zoals je dat normaal doet — je snippet wordt automatisch opgeslagen
- Kopieer het adres van je browservenster en delen maar!
Een snippet invoegen
Dit is de aangeraden manier om Carbon te gebruiken op je eigen website of blog. Bezoekers kunnen zelfs de code kopiëren met de druk op een knop.
Je kunt elke Carbon-snippet rechtstreeks invoegen op je webiste met het carbon.now.sh/embed
-adres. Vanuit het kopieermenu kun je gemakkelijk de volledige iFrame-code kopiëren, of juist alleen het adres voor invoegen op platformen als Medium.
Ten slotte kun je ook bewaarde snippets of GitHub-gists invoegen met carbon.now/embed/:id
.
Gebruik de Tweet-knop
De Tweet-knop zorgt er niet alleen voor dat je afbeelding op Twitter wordt gedeeld, het voegt ook de juiste alt
-tekst toe om ervoor te zorgen dat je afbeeldingen toegankelijk zijn. Tweet je toch liever de afbeelding zelf, bekijk dan eerst hoe je afbeeldingen op Twitter beter toegankelijk maakt.
Rechtstreeks de afbeelding downloaden
Carbon ondersteunt het downloaden van je afbeelding als PNG en SVG. Je kunt ook ook op Export → Open
klikken om de afbeelding direct in je browser te openen. Daarnaast kun je een Carbon-afbeelding meteen naar je klembord kopiëren met de Image
-optie in het kopieermenu.
Carbon voor Desktop installeren (offline)
Als je Google Chrome gebruikt, of een andere browser met ondersteuning voor Progressive Web Apps, dan kun je Carbon installeren om offline te gebruiken door:
- Bezoek carbon.now.sh
- Open het instellingen-menu van je browser
- Klik op "Carbon installeren..."
Community
Bekijk eens deze projecten die door onze geweldige community zijn gemaakt:
Editor Plugins
- IntelliJ IDEA
carbon-now-sh
- Open de geselecteerde code in je huidige IntelliJ IDEA-bestand in Carbon vanuit het contextmenu - Atom
carbon-now-sh
- Open je huidige Atom-bestand in Carbon metshift-cmd-A
- VS Code
carbon-now-sh
- Open je huidige VS Code-bestand in Carbon met het commandocarbon
- Sublime Text 3
carbon-now-sh
- Open de geselecteerde code in je huidige Sublime Text 3-bestand met een zelf toegewezen toets - Vim
carbon-now-sh
- Open de geselecteerde code in je huidige Vim/Neovim met de functieCarbonNowSh()
- Emacs
carbon-now-sh
- Open de geselecteerde code in je huidige Emacs met de interactieve functiecarbon-now-sh
- Xcode
carbon-now-sh
- Open de geselecteerde code incarbon.now.sh
- Xcode
nef
- Met deze Xcode-extensie kun je de geselecteerde code exporteren als een Carbon-snippet met een enkele actie
Hulpmiddelen
- CLI
carbon-now-cli
- Open een bestand in Carbon of download het rechtstreeks metcarbon-now
, met ondersteuning voor een interactieve modus, selectieve highlighting en meer - CodeExpander - Een slimme GitHub-gist-client met de features van TextExpander
nef
- Exporteer meerdere Carbon-code-snippets vanXcode Playground
.@carbonshbot
- Een Telegram-chatbot die op basis van een code-snippet of gist-URL een Carbon-afbeelding maakt- R
carbonate
- Iteratief manipuleren van het uiterlijk van afbeeldingen inR
om vervolgens te openen in Carbon of om rechtstreekts te downloaden.
Boeken
- "CS 101 - An Introduction to Computational Thinking" - een informatica-boek door Sarbo Roy.
Auteurs
Carbon is een project van:
- Mike Fix (@mfix22)
- Brian Dennis (@briandennis)
- Jake Dexheimer (@jakedex)
Licentie
Meewerken & ondersteuning
Pull requests zijn welkom! Bekijk onze richtlijnen voor bijdrages voor meer details.
Sponsors
Gebruikt jouw bedrijf Carbon? Overweeg dan eens het project te sponsoren voor het financieren van nieuwe features, bugfixes en meer.
Donateurs
Gebruik je Carbon graag? Denk dan eens aan het ondersteunen van het project voor het financieren van nieuwe features en verbeteringen
Dank aan
▲ Vercel voor het sponsoren van Carbon's hosting.
Iedereen die heeft meegewerkt
Dank gaat naar al deze geweldige mensen (emoji key):