谈开源书籍的写作
最近正在准备在 Gitbook 上编写自己的第二本开源书籍,主要是关于 React 的,于是突然想到去 GitBook 上看看之前写的《Node.js 实战》的阅读数据,以下是近一年的访问数据:
这个数据在我自己看来是十分满意的,在没有任何宣传的前提下,一年时间内UV 达到了4251,而一个月之内的 PV 也在2000左右。之后也会逐渐更新这本书中的内容,并适量添加一些新的内容、章节,跟上技术进步的节奏。
GitBook
GitBook 这个平台是十分值得推荐的,简单列举一些我感受到的优点:
- 使用 Markdown 编辑,根据一定的规则可以生成书籍目录以及多语言版本
- 可以关联任何 Git 仓库,通过 webhook 在 Push 的时候自动生成新一版本的书籍
- 提供了体验比较不错的在线和桌面版本的编辑器
- 不需要额外诸如 GA 的统计工具
免费版本的计划可以供作者编写一本私有书籍,这对大部分作者而言都已经完全足够,毕竟选择这个平台更多的是选择编辑开源的书籍。
关于写作
编写一本书籍的工作还是比较繁重的:
- 不仅要考虑到如何深入浅出的介绍自己想要介绍的知识点,同时也要注意措辞是否能够被各种读者所接受。
- 涉及技术主题的书籍,很多时候很考验作者自己对这个技术的理解,以至于在编写的过程中会获得很多自己本身也不了解的知识 – 这对于很多人而言又是一个增长知识的契机。
- 对于编程的书籍来讲,我觉得更为重要的可能还是易于理解的例子。毕竟,让读者亲手敲出例子的代码,并配以简单的讲解是非常有效的学习手段。这也是很多优秀的教程所倾向于做的事情。
- 当然,如果要做到「国际化」,则需要将自己的书籍写成多种语言的版本,这又要涉及到作者的多语言能力了。
Happy Writing!
支持作者 | 文章采用 CC BY-NC-SA 4.0,转载请注明出处