@ -102,10 +92,10 @@ You know [all](https://twitter.com/dan_abramov/status/890191815567175680) [of](h
## Features
## Features
- **Customization**. Customize things like your image's syntax theme, window style, and more
- **Customization**. Customize things like your image's syntax theme, font style, and more
- **Share quickly**. Save your image or
- **Share quickly**. Save your image or
a link with one click
a link with one click
- **Import from GitHub gist**. Simply append a GitHub gist id to the url
- **Save snippets**. Create an account to save snippets for later. Shared snippets are automatically unfurled on Twitter and Slack.
## Usage
## Usage
@ -114,28 +104,50 @@ You know [all](https://twitter.com/dan_abramov/status/890191815567175680) [of](h
There are a few different ways to import code into Carbon:
There are a few different ways to import code into Carbon:
- Drop a file onto the editor
- Drop a file onto the editor
- Append a GitHub gist id to the url (e.g. `carbon.now.sh/GIST_ID_HERE`)
- Append a GitHub gist ID to the URL (e.g. [`carbon.now.sh/<gist_id_goes_here>`](https://carbon.now.sh/3208813b324d82a9ebd197e4b1c3bae8))
- Paste your code directly
- Or just start typing!
#### Customization
#### Customization
Once you've got all of your code into Carbon, you can customize your image by changing the syntax theme, background color, window theme, or padding.
Once you've got all of your code into Carbon, you can customize your image by changing the syntax theme, background color, window theme, padding, shadows, fonts, and more.
#### Exporting & Sharing
After you've customized your image you can share your snippet in a number of ways
##### Create a saved snippet
Sharing a saved snippet will automatically unfurl the image on platforms like Twitter and Slack. This lets users see your creation, while also giving them access to the source code via the link. Better yet, if you need to make an update, simply follow the link yourself to edit the snippet directly.
#### Export/Sharing
To create a saved snippet:
After you've customized your image you can either Tweet a link to the image, or save it directly.
1. Login using the "Sign in/Sign up" button
2. Edit as you normally woud — your snippet will get saved automatically
3. Copy the URL from your browser window and share away!
If you use the 'Tweet' button, Carbon will automatically make your image accessible. However, if you want to manually tweet your image, please check out [how to make your Twitter images accessible](https://help.twitter.com/en/using-twitter/picture-descriptions).
##### Embed a snippet
If you include a Carbon image in a post, the source code will be invisible for assistive technology, it will not be possible to enlarge it or copy it, etc. Please, think about adding another element with the source code as text, like an [HTML Details Element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details) below the image.
This is the recommended method sharing Carbon on your own website or blog. Readers can even copy the code with the click of a button.
You can embed any Carbon snippet in your website directly using the `carbon.now.sh/embed` URL. The "Copy Menu" lets you quickly copy the correct iFrame snippet, or the encoded URL for embedding on platforms like Medium.
Finally, you can also embed saved snippets or GitHub gists using `carbon.now.sh/embed/:id`.
##### Use the Tweet button
The Tweet button will not only share the image on Twitter, but it will also correctly encode the `alt` text to ensure your images are accessible. However, if you want to tweet image yourself, please check out [how to make your Twitter images accessible](https://help.twitter.com/en/using-twitter/picture-descriptions).
##### Download the image directly
Carbon supports downloading your image as a PNG and SVG. You can also click `Export → Open` to open your image directly in the browser. Finally, you can copy the Carbon image directly to your clipboard by going to `Copy → Image`.
#### Installing Carbon for Desktop (Offline)
#### Installing Carbon for Desktop (Offline)
If you are using Google Chrome, or another browser that supports Progressive Web Apps, you can install Carbon for use offline by:
If you are using Google Chrome, or another browser that supports Progressive Web Apps, you can install Carbon for use offline by:
Michael Fix
5 years ago
committed by
GitHub