《Steem 指南》进展：协作平台 | Progress in Steem Handbook

This is a report of the progress in the book Steem Handbook (in Chinese). Now we have built a team. The github project is ready. The preliminary skeleton of the book is there.

昨天发起了《Steem 指南》团队写作构想。最近币价下跌，参与此书的写作有可能赚不到什么钱，我原本做好了冷场的心理准备。没想到的是，我收获了一大筐热情：前辈们的点赞，大家的留言和建议，二十多人入群，其中有好几位我的“意中人”——我心坎儿里某些章节的理想作者。

我松了口气：这比我的悲观预期已经好太多了。谢谢大家！太有面子啦！

凡是志愿参与的，都多多少少有些情怀和理想主义。然而，有情怀的人也是需要吃饭的，我会尽量想办法帮大家从这个活动里多赚点钱。这样才更有动力。大家不要笑我太庸俗。

有朋友为纸质书的出版表示担忧。事实上，纸质书能不能出版，是很多因素决定的。其中，出版社对能否盈利的估计是重要因素，而这一步是我们无能为力的。所以，现在不用想，想也没用。纸质书是我们的目标。有了这个目标，哪怕最后没能正式出版，大家在写书时会更严肃对待，写出的质量会比较高。

千里之行，始于足下，赶紧动手才是实实在在的事儿。

第一件事，是拉起一支队伍。

这个上面说过了，已经有二十多人入群。其实，微信群只是个交流方式，不入群也可以参与。正式的信息我都会发帖，大家在帖子后面留言就好。

第二件事，是确定协作方式。

团队协作写书，最容易出的问题就是版本混乱。这问题如果不先想好，将来统稿时就是一场灾难。每个人习惯的写作工具有不同，无论选哪种工具，都必然会有人不习惯，需要学习。那么，我们索性从一开始就选最好的工具。版本控制的最佳工具，是 GitHub。

很多人误以为 GitHub 只给程序员用，太高深，其实不然。志愿者 @rileyge 专门为本项目写了一篇教程，手把手教大家如何协作写咱们这本书。感兴趣的朋友可以关注他。此外，我再推荐个教程：文科妹子教你如何多人一起在 GitHub 上写小说。

本书的 GitHub 项目已经建好，挂在我名下，叫 pzhaonet/steem-guides（访问地址）。为了让大家练手，项目下专门有个 shared/test.md 文件，就假装是我们未来的书稿，大家可以跟着 @rileyge 的教程在这个文件上随便试验。

原则上来说，我们这个 steem-guides 就是个开源项目，那么通过 utopian.io 给 steem-guides 来写教程、找 bug、提建议等等都应该是可行的。大家可以拿这个项目去乌托邦试试，说不定能赚些钱。在 utopian.io 找 pzhaonet/steem-guides 这个项目就行。utopian 的使用方法见 steemr.org 的首页。

GitHub 虽然很好，但并不容易学。其实我本人也不熟。如果大家实在用不好，那么最坏的打算是，专门请一位懂 GitHub 的志愿者来收集各位作者的原始文稿，再 PR 到 GitHub 上。

有朋友留言提醒教程更新和升级的问题。GitHub 能很好地解决这个问题。比如说，书某个章节发在 steem 上的版本虽然发文 7 天后不能修改，但是作者本人仍然可以来 GitHub 上修改，读者来看这本书的新版就行了。

那么这本书的最新版去哪里看，做出来是什么样子呢？

第三件事，是把书稿做出个样子，给大家个盼头。

我已经把书的骨架做好了。

书稿以三种形式呈现。首先是网站(访问地址)，看上去是这样的：

点击图上红色圆圈所示的按钮，可以下载另外两种形式：pdf 和 epub。

pdf 格式的文件，用的是我即将出版的《学 R》一书的模板，页眉、页脚、边距、单双页等版式完全按出版社的要求设置好了，文件已做过转曲处理，可以直接送印刷厂印刷。看起来是这样的：

epub 则是方便在手机上阅读的格式，欢迎点击上面那个红圈里的按钮下载试读，这里就不展示了。

这个网站跟上面说的 GitHub 项目 steem-guides 完全同步。事实上，steem-guides 就是这个网站的源代码，而这个网站就是 steem-guides 项目输出结果的预览。所以，我们只需维护 steem-guides 这个 GitHub 项目就行了。

至此，写书工具已就位。剩下的，大家只需专注写内容。

参与写书的志愿者们，请先按熟悉一下协作方式，最好是学会 GitHub。我们暂时不讨论书的章节结构，这是下一步要做的事情，我会另行发帖。

此外，有两条建议：

大家发布在 steem 上的书的初稿，以及跟本书有关的帖子，建议添加个“steem-guides”标签，方便对这个项目感兴趣的人。
协作写书的过程里可能会发生一些趣事，欢迎大家写成帖子发出来，以“编辑部的故事”为主标题。我昨天就写了一篇。

你对上述协作方式和书的发布方式有什么好的建议和意见吗？欢迎留言。

《Steem 指南》进展：协作平台 | Progress in Steem Handbook

第一件事，是拉起一支队伍。

第二件事，是确定协作方式。

第三件事，是把书稿做出个样子，给大家个盼头。

相关文章