技术人员如何写一本书

配图制作

一般而言，我在书中会使用两种图：流程图和一些截屏。截屏通常使用Mac OSX自身的功能就已经足够，而流程图我会采用一些额外的工具如：

• graphviz

• keynote/sketch

用Graphviz画图的好处就是可以将图像代码一样放入版本库来管理。

除此之外，我还学习了一些设计软件的基本用法，事实上只需要用一些简单的元素就可以做出非常专业的配图：

• 字形/字体（大小，粗细的变化）

• 颜色（基本的配色理论就可以做出很舒服的配色）

• 层次（尺寸，位置，颜色的深浅）

• 阴影

代码格式

书中实例需要很多代码来说明，如果是制作电子书的话，可以使用Markdown预处理器自带的功能来高亮。另外如果需要RTF格式，可以使用这些工具：

• highlight工具

• intelij中的插件copy on steriod

这里有一篇博客来说明如何将你的代码带着格式拷贝到剪贴板中，拷贝之后，就可以将这些内容粘贴到Word或者Keynote中了。

一些潜在的坑

在写作的过程中，会有一些潜在的坑。这些所谓的坑是新人可能无法想到的。相对于言之无物，不知如何下笔，最痛苦的其实在于平淡。大部分时候，你可能很容易就能写出开头，但是很难坚持到最后。即使好不容易写完了第一版，后续的重读和修改，会让你苦不堪言。

内容写好之后，样式是下一个重要的问题，好的内容需要有与之匹配的排版。在中国，作者不但要负责内容，还要负责一些排版的事情。这一点非常奇葩，但是又是实情。这也是我更推荐电子版的原因（排版更加美观，选择更加多样，而且一旦有问题可以更容易的修改）。

另外一个问题是错别字检查！检查错别字对于作者来说，是一件非常困难的实情。而对于读者来说，则是一件很容易的事情。这跟知识的诅咒的道理一样。