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

in cn •  9 months ago

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. 协作写书的过程里可能会发生一些趣事,欢迎大家写成帖子发出来,以“编辑部的故事”为主标题。我昨天就写了一篇。

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

相关文章

Authors get paid when people like you upvote their post.
If you enjoyed what you read here, create your account today and start earning FREE STEEM!
Sort Order:  

不错不错,进展神速

·

吓他们一跳!

写个小建议,我看了看目录,给我的第一感觉这是一本厚重且无聊的说明书。
这书对新手的帮助无疑是巨大的,但是它提不起人的阅读兴趣。
谁会看一本十来万字的说明书呢?
所以我建议每章前面插入一个有关这章内容的小故事。
比如说到密码安全的时候可以写一个关于账号被盗的故事,或者以黑客的角度写一个如何盗号的故事。
这样全书的可阅读性会提高不少。
可以把人员分为两批,一批写故事,一批写教程。cn区不少人写故事是一把好手,不能浪费了这批人才。

·

“一批写故事”,如今是你孤军奋战……

看上去还不错,希望大鹏哥能够获得圆满的成功!

·

谢谢支持!

你们是真的理想主义,点个赞。

·

谢谢赞。来加入吧?

·
·

我可能是个假的理想主义者。。。。。

很速度啊!加油!希望最后可以实现最初的设想!

·

努力加快进度,让大家能赶紧动手。

加油, 加油, 大家一起努力!

·

鼓足干劲

@dapeng 不错不错,好的开始是成功的一半。各位伙伴们努力加油~

PS: @rileyge这哥们写的github真心不错,有兴趣的可以去阅读与关注!

·

一起努力!

大鹏哥要出书吗?这书对我们实在是太有用了。
啥也不说,一个满赞。尽微薄之力。

·

谢谢。能不能出书还不好说,目前是把大家的资源整合一下。

·
·

尽管如此也是大工程啊

@dapeng, 写得太棒了,我喜欢!

@dapeng, 写得好好哇~~~ img

BTW, @cn-naughty.boy 淘气包,好像快情人节了咧,嘻嘻...