所有操作都在一个窗口里完成,导出的图片和你看到的一模一样。主题和尺寸设好之后会跨启动保留,所以只有第一段代码需要动脑筋,之后每一段都是粘贴、导出。
1. 粘贴代码
复制一段代码,用 ⌘⇧V 直接粘贴进 Codeshot。这个快捷键会从窗口任意位置替换整段源码,不必先点进编辑区。
粘贴的同时就会应用高亮。语言由代码本身判断,覆盖 60 种;遇到短片段有歧义时,可以在「语言」菜单里手动指定——三行 C 和三行 C++ 在任何检测器眼里都长得一样。
粘贴文本而不是给编辑器截图,才是关键所在。这样光标、选中高亮、行号槽的图标、编辑器的行宽都留在原地,它们本来就不该出现在图片里。
2. 选主题
有 30 款语法主题,每款都有浅色和深色两个变体。你可以并排看完全部,它们用的就是应用自己的样式表来渲染。
选的时候有两点值得知道。如果想让图片对你的读者显得亲切,就跟自己的编辑器保持一致——Swift 用 Xcode,其他大多数用 GitHub。但如果图片会被小尺寸浏览,对比度比亲切感更要紧:偏柔和的浅色主题一旦被缩到信息流的尺寸,结构就散了。
3. 选背景
代码放在一块画布上,这块画布可以是 19 张 macOS 壁纸之一、92 种渐变之一、你自己定的纯色,或者你提供的一张图片。
你也可以把背景整个关掉,导出成透明的。当图片要放进幻灯片或者已经有自己背景的页面时,这正是你需要的。
4. 微调边框
设置窗口的圆角半径、窗口内的内边距、窗口外的外边距,以及投影。红黄绿按钮和窗口标题可以开关,字体可以用你 Mac 上装的任意等宽字体。
这些是只需调一次的设置。调成你喜欢的样子,之后每一段代码都会沿用——第十张图只要几秒而不是几分钟,多半就是因为这个。
5. 用合适的尺寸导出
让尺寸跟着内容走,或者锁定一个比例:1:1、4:3、3:2、16:9、9:16、2:3 或 3:4。这些预设只是宽高输入框的快捷方式,其他任何比例直接输入就行。
导出可以选 1×、2× 或 3×。默认用 2×——小字用 1× 导出,在 Retina 屏上会发虚,而这正是让一张代码图片显得业余的头号原因。
然后按你顺手的方式把它带出应用:用 ⌘⇧C 直接复制到剪贴板、把预览拖进另一个应用,或者用 ⌘S 保存。
它要发到哪里
合适的比例完全取决于目的地,而且值得花心思弄对,因为每个平台的裁切方式都不一样。我们有针对 X、LinkedIn 和 Facebook 的单独指南,以及其余平台的尺寸指南。
最后直说一点:图片没法复制、没法搜索,屏幕阅读器也读不了。如果这段代码是拿来用的而不只是拿来看的,请在图片旁边附上源码链接。