我是如何完成《iOS開發進階》的編寫的？

《iOS 開發進階》終于出版了，在架構師峰會的簽售會上，首批 100 本圖書在簽售的兩天很快就賣光了，前幾天首先在互動出版社上架的首批圖書也在一天內賣缺貨了，能得到讀者這么熱烈地支持，我還是很驚喜。技術人攻略的創始人張蘭說：“你應該寫一篇總結”。我自己也想好好的整理一下這個出版的過程，給大家分享一下此書的寫作過程。

選擇出版社

去年年底，電子工業出版社博文視點的張春雨老師在微博上私信我，問我愿不愿意寫一本 iOS 方面的技術書籍。其實在這之前已經有將近 5 個出版社的老師聯系過我，但是我都因為創業太忙沒有答應。后來有一次差點答應過的一個出版社老師，但因為她堅持要我提供 Word 版本的書稿以及一些溝通上的問題，我最終在簽合同前終止了合作。

張老師是足夠開明大度的，在寫作時間和內容上給了我足夠的自由度，前期幾乎沒有干涉過文稿內容和寫作進度（不過后來發現其實是他比較忙，沒空管 我）。后期也僅僅是對文章表達可能有歧義的地方提建議。這種散養式的風格非常適合我，因為我從來就是一個比較自律，以及喜歡按自己節奏做事的人。

寫作格式和工具

我之前在某個出版社老師的要求下，曾經也嘗試在 Mac 下用 Word 寫作。但由于 Mac 下 Word 的糟糕體驗以及對代碼糟糕的排版支持，那完全就是一段不堪回首的痛苦過程。

而張春雨老師鼓勵我用任何喜歡的工具寫作，這一點是我同意合作的很大原因。我的博客都是用 markdown 語法來完成的，所以我一開始就打算用 markdown 來寫作。

在軟件上，我一開始選擇 Mou 來寫作，但是發現 Mou 對于篇幅超過 1 萬字的文章，預覽渲染會非常卡，CPU 長期達到 100% 占用。我的最新款 Macbook Air 的風扇呼呼狂響，讓我不得不終止了 Mou 的進程。

之后有一段時間我就用 Evernote 或 Sublime text 來寫作，它們麻煩之處就是 Evernote 寫完之后還需要把圖片轉成 markdown 的鏈接。而 Sublime text 的問題就是無法方便地預覽最后效果。

這一切的不便在我發現gitbook后被改變。gitbook是一個專業的為 markdown 格式寫作者提供的圖書編寫工具。它甚至集成了在線銷售相關的功能。它也支持將書稿導出成 PDF、HTML 或 ePub 格式。

以下是 gitbook 的編輯界面（最左邊是目錄，中間是 markdown 源碼，最右邊是預覽）：

我用gitbook完成了此書后半部分的編寫。gitbook 有時候會出現兩個中文字符在顯示時重疊的問題，不過整體體驗比 Mou 和 Evernote 要好多了。唯一的一次事故是 gitbook 對中文支持不太好，如果章節名不帶因為的話，gitbook 會錯誤的地將章節覆蓋到父級的圖書目錄，造成其他章節的內容被覆蓋。我幸運的將書稿內容保存在了 Dropbox 目錄下，所以恢復出來了。

配圖和示例代碼

對于寫作中需要的示意圖截圖，簡單的我就直接用 QQ 截圖了，復雜的我使用的是Clarify，它的標記功能比較豐富（不過中文支持比較差）。另外一些類圖或架構圖，我就直接使用 keynote 來做了。

考慮到技術書籍通常配圖都比較少，所以我這次嘗試，那時用比較多的配圖來做輔助說明。另外我盡量把圖書的涉及代碼都放到網上，僅僅留一些關鍵的代碼片段以節省篇幅。

如何安排時間和控制進度

由于有過寫作的經驗，所以我預先就估計好了這會是一個一年左右的工作。實際上它確實花了一年時間。

我希望把這個當做一個自己的 “創業項目” 來做，看自己能否執行好一個較長遠的規劃。我把圖書編寫拆分成每一個章節的寫作工作，然后希望用 1~2 周完成一個章節。這樣的好處是每周都可以看到明確的進展和產出。

我具體在做的時候是嘗試用 Scrum 的方式來安排自己周末的時間。簡單來說就是把書稿的內容進行拆分，然后對于細分到每一個章節的內容進行估分。接著我的每一個周末的目標就是把當周安排的章節寫作完成。

當然，人都是需要休息的。所以周末兩天我通常不會安排滿。我會安排一整天用來寫作，而另外一天做小量的修改和休息。如果有加班，就暫停寫作。

雖然我沒有跑過馬拉松，但我感覺寫作的體驗和跑馬拉松類似。前期的起跑和最后的沖刺都比較激動，但是中途長達一年的寫作過程卻是孤獨，枯燥和寂寞的。這個時候，需要自己的堅持和自我鼓勵。

關于電子版

該書我專門保留了電子版的版權，我本來希望把書放在多看上銷售，主要是因為我個人就是多看的重度用戶，而且我知道多看對電子書有加密保護。但是后來 聯系多看閱讀時才發現他們已經不和個人作者合作了，他們建議我將版權授權給出版社。這讓我感覺非常失望。多看閱讀這種作法使得它無法顛覆傳統出版社的渠 道，另外如果競爭對手允許個人作者的話，多看閱讀還可能失去不少優秀的圖書的發行機會，進而影響它的電子書平臺的地位。

在網上抱怨了此事以后，有一位朋友說可以協助我在豆瓣閱讀發布此書。所以順利的話，稍后會有豆瓣閱讀的電子書版本銷售。如果豆瓣閱讀的出版進行得順利，我也會將電子版發布在百度閱讀、淘寶閱讀等其它電子書平臺上。

關于作品收入

技術書籍的寫作通常都是不怎么掙錢的。那拿我的書來說，估計版稅一共會有2萬塊錢。而寫作此書大概花掉了我將近一年的周末時間。如果是要專門為了掙錢的話，可以有非常多其它的性價比更高的，更輕松的方式。

但是，如果可以重來，我還是會選擇寫這本書。傳遞知識的樂趣和成就感還是比掙錢更有意思一些。也希望有更多的一線開發者投入到寫作分享的行列中。

一些小結

• 推薦用 markdown 格式配合gitbook寫作。
• 推薦用 Scrum 的方式安排進度。
• 推薦用Clarify作配圖標記。
• 書稿放在Dropbox下自動同步會非常安全。當然，你需要學會KX上網。
• 如果想在 Mac 下寫作，那還是找一個不需要 Word 方式審稿的出版社吧，與我合作的電子工業出版社就是這樣。博文視點的張春雨老師和劉蕓老師(微信號:ly15201392806)都非常不錯。
• 從交稿到出版至少也有 1 個月時間，做好心理準備，前期不要宣傳太猛，我這回從簽售會到網上能夠買到，將近過了一個月。我由于不懂事，簽售時宣傳得太狠，結果弄得跟饑餓營銷似的。

寫作者的未來

未來互聯網的發展會使得傳播更加容易，所以我相信：好的內容會更容易獲得讀者，出版社和書商作為渠道的力量會越來越弱。到那個時候，或許寫作真正的能成為很多人的職業，并給他們提供不菲的收入。

到那個時候，我希望我能夠成為其中的一員，不但可以隨意地選擇工作時間和地點，還可以享受傳遞知識的樂趣和成就感，希望這一天能夠早日到來。

Posted by唐巧Jan 11th, 2015summary

原創文章，版權聲明：自由轉載-非商用-非衍生-保持署名 |Creative Commons BY-NC-ND 3.0

原文鏈接: http://blog.devtang.com/blog/2015/01/11/how-to-finish-ios-pro-book/