五天内如何写完一本书

尚无读者喜欢这篇文章。
Publishing the open source way

Opensource.com

如果你把一群兴趣相投的人关在一个房间里一周,他们会玩得很开心并写出一本书。

— Adam Hyde,FLOSS Manuals 创始人

这就是 2013 年 Google Summer of Code (GSoC) 文档营发生的事情。一群 20 位开源爱好者在十月中旬聚集在一起,在短短五天内写出了三本书,而不仅仅是一本。

我很幸运能够参加这次活动。以下是那五天发生事情的简要回顾。

GSoC 文档营部分是非正式会议,部分是图书冲刺,由 Google 开源项目办公室组织,并由 Aspiration 的 Alan Gunn 和 FLOSS Manuals 的 Adam Hyde 协助举办。

本次活动吸引了来自全球各地(北美、欧洲、非洲、印度、斯里兰卡和新西兰)的 20 人来到 Google 在加利福尼亚州山景城的园区。大多数参与者来自以下项目之一:Mallard(一种用于编写在线帮助的标记语言)、OpenMRS(一个电子病历系统平台)和 BRL-CAD(一个强大的设计和建模工具)。该小组由四名自由代理人(包括我自己在内,他们不隶属于上述任何项目)组成。

决定写哪本书

第一天,Alan Gunn 带领大家进行了一些练习,这些练习有三个主要目的:互相认识、引导我们提出关于书籍内容的问题,以及让我们走出舒适区。

之后,Gunn 让我们思考书籍的三个受众以及读者从书中获得的三个收获。这个练习可能是所有练习中最有用的。它帮助每个人专注于他们对书籍的想法。

Deciding what to write

照片由 Adam Hyde 提供

到一天结束时,每个项目都确定了他们书籍的主题。BRL-CAD 选择了编写潜在贡献者指南,Mallard 决定专注于其标记语言指南,而 OpenMRS 则选择了开发者指南。我和其他“自由代理人”加入了不同的项目。我加入了 BRL-CAD 团队。这是一个有趣的选择,因为我对 CAD 一无所知,也没有任何兴趣。这真是在走出我的舒适区!

开始工作

第二天开始了。每个小组在上午花了半天时间为他们的书籍构思目录。这是以一种非常低科技的方式完成的:使用便利贴。与数字工具相比,使用便利贴可以更轻松地添加、重新排列、编辑和删除书籍的章节。

写作过程

在这个过程中,Adam Hyde 告诫我们要杀死你的宠儿,意思是不要害怕删除章节或章节。即使是你喜欢的章节。我们的想法是让我们专注于我们的书中需要包含什么,而不是我们想要或认为应该包含什么。

从那时起,写作正式开始了。一些参与者怀疑是否有可能在我们拥有的时间内写完一本书。尽管如此,他们还是把这些疑虑抛到一边,拿起一章,开始拼命写作。

这不仅仅是三组人在他们自己的小泡泡里打字。所有小组的成员之间都有相当多的来回交流。关于结构和风格的问题,关于采取的方法的对话等等。每个问题和争论都得到了快速、高效和和平地解决。很高兴看到这种合作和最少的以自我为中心的行为。

The process of writing

照片由 Adam Hyde 提供

然而,对实现目标的担忧仍然存在。直到 Adam Hyde 在快结束时突然出现,告诉 BRL-CAD 团队我们已经写了接近 8,000 字——这与其他团队完成的工作相当。那一刻,我能感觉到每个人的疑虑都烟消云散了。

虽然在接下来的两天里写作速度稍微放慢了一些,但重点是扩展我们在第一天写的内容并对其进行完善。内容和结构变得更加坚定,我们开始添加细节。同样,合作发挥了作用。这一次,每个团队都与其他团队交换了他们的工作。当你离你正在写的东西很近时,你需要一双新的眼睛来指出你无疑错过的缺陷。正是在那时,杀死你的宠儿的告诫开始了自己的生命。以 BRL-CAD 书籍为例,我无情地删除了我写的一个章节,有人指出该章节没有达到目的。

到第四天结束时,每个团队都完成了一本书。然后 Adam Hyde 将书籍转换为 PDF,用封面包装起来,并将其发送到当地的按需印刷服务机构以制作纸质副本。印刷出来的书籍是对辛勤工作的一点小奖励。

如何宣传书籍

在活动的第一天,Alan Gunn 要求我们思考如何在书籍完成后宣传它们。正如他所说,我们的努力可能会像海滩上的浪潮一样达到顶峰,然后流入大海,或者它们可能会改变世界。每个团队的目标是至少找到中间地带。

这是 GSoC 文档营最后一天的重点。每个团队都集思广益,并为他们的书籍制定了营销计划。这些计划包括,但不仅限于,仅仅在 Twitter、博客文章和邮件列表中宣布书籍。几位参与者撰写了文章以供发表,一些人计划在未来几个月在开源活动中分发书籍。

How to publisize a book

照片由 Adam Hyde 提供

我过去曾参加过图书冲刺或写作马拉松,但我从未经历过从头到尾的过程。这使得这五天既紧张又非常令人满意。我们制作的书籍并不完美,但它们非常出色。尽管它们是由多人编写的,但这些书籍用一种声音说话。

GSoC 文档营展示了有效协作的力量。而且,从本质上讲,这不正是开源的全部意义所在吗?

标签
That idiot Scott Nesbitt ...
我是一位自由/开源软件的长期用户,并为乐趣和利润撰写各种文章。我并没有把自己看得太认真,我所有的特技都是自己完成的。

7 条评论

多么精彩的故事。很高兴看到 Scott 的帖子。

感谢你的赞美,Bryan!我参加过三次图书冲刺,我总是对一次冲刺的成果感到惊讶——无论是数量还是质量。

文章写得不错,但我想知道使用了哪些技术/工具。例如,是否使用了 Markdown 或 LaTeX?

想了解更多关于所做的一些技术决策。

这些书是使用 <a href="http://booki.flossmanuals.net">BookType</a> 编写的,BookType 是 <a href="http://flossmanuals.net">FLOSS Manuals</a> 项目使用的创作和出版工具。BookType 是一种协作工具,可以发布多种格式的书籍——包括一组网页、PDF 和 EPUB。

BookType 具有 WYSIWYG 界面(抱歉,我忘记使用了哪个编辑器控件;可能是 TinyMCE),尽管也有 HTML 代码视图。但老实说,这个视图非常混乱。

BRL-CAD 团队计划将他们编写的书籍转换为 DocBook,并将其拉入他们的版本控制系统,以便可以使用他们自己的软件和文档版本进行更新和编译。

毫不奇怪,Mallard 团队已将其书籍转换为 Mallard

https://gitorious.org/introduction-to-mallard/introduction-to-mallard

我想知道 OpenMRS 团队是否对他们的书做了类似的事情。

我想感谢您为撰写这篇文章所做的努力。我希望将来也能看到您同样出色的作品。

知识共享许可协议本作品根据知识共享署名-相同方式共享 3.0 未本地化版本许可协议获得许可。
© . All rights reserved.