1 min read

《Steem 指南》进展:协作平台 - Progress in Steem Handbook

原文链接: steemit, cnsteem, busy, chainbb, steemdb, steemd, busy, markdown

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。我们暂时不讨论书的章节结构,这是下一步要做的事情,我会另行发帖。

此外,有两条建议:

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

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

相关文章