使用 Carbon 共享代码示例

2025-06-08

使用 Carbon 共享代码示例

我经常会思考如何最好地分享一些代码示例之类的内容。Gists似乎很有效,尤其适用于比函数本身更复杂、包含几行代码的内容。但是,当你的代码只有几行时,这样做似乎有些过度。
的下一个想法是截取文本编辑器的屏幕截图。这种方法也有缺点,因为可能需要多次尝试才能找到合适的内容,并且无论我把示例放在哪里,都能很好地嵌入到代码中。

今天我偶然看到了@emmawedekind 的这条推文。

我想起以前在推特上见过类似的代码示例。我非常喜欢它的外观。代码清晰,有高亮显示,整体效果看起来非常精致专业。这种资源能够清晰地传达信息,并通过美观的外观提升内容的层次。
我问Emma他们是如何制作这张截图的,她告诉我Carbon网站。这是一个由Dawn Labs开发的非常简洁的网站,而且免费使用。你可以选择各种主题来调整颜色。网站还提供了语言设置,以便正确显示高亮显示。你可以将图片导出为PNG或SVG格式以供在线使用,或者直接在推特上发布图片。
效果看起来非常棒。 我非常喜欢它免除了创建代码示例图片时的猜测,让你能够专注于你想要分享的代码。我强烈建议你去看看Carbon网站,看看它是否对你有帮助。
示例 Javascript 代码

你以前用过 Carbon 吗?我很想看看大家在工作中是如何运用它的。请在评论区留言告诉我!

更新(2019 年 3 月 2 日)
评论中有很多朋友指出,仅使用图像共享代码存在可访问性问题,因为这会妨碍使用屏幕阅读器的用户完整地使用内容。屏幕阅读器不会读出图像的内容,而是使用为图像设置的 Alt Text。
还有人指出,当代码在图像中时,无法选择它进行复制和粘贴以便在文本编辑器中进行查看。
这两个观点都很有道理。我仍然认为 Carbon 是一款很棒的应用程序,非常有用,但这表明它不是一个完整的解决方案,应该与其他代码共享方法结合使用,以确保每个人都能得到他们需要的东西。
我仍然建议使用它在 Twitter 上分享代码片段,因为目前在推文中确实没有更好的方法来实现这一点。否则,您必须链接到要点或其他地方。
至于在文章等内容中使用代码图像,我会考虑将图像仅用作标题或演示片段,然后嵌入要点或其他允许屏幕阅读器运行的内容,并使代码更易于共享,正如一些人建议的那样。或者使用图像显示代码,并在解释代码的文本中链接到更易于使用的版本。
如果您打算使用图像作为传达代码的主要方式,请确保为其设置良好的 Alt Text,以帮助任何使用屏幕阅读器的人。
有时,很多事情都很难做到正确。我在 Twitter 上找到了一些来自Marcy Sutton的优秀资源,她回复了这条推文

鏂囩珷鏉ユ簮锛�https://dev.to/daveskull81/sharing-code-examples-with-carbon-4fp0
PREV
使用 Node 和 Dropbox 实现电子邮件自动化
NEXT
从中级到高级编码技能:改变我学习编码的方式