我的第一本書 | <ECMAScript關鍵30天> 心路歷程 | 出版的眉角分享

我的第一本書 | <ECMAScript關鍵30天> 心路歷程 | 出版的眉角分享

心路歷程

今年解鎖了一項從來沒想過的成就,就是我成為作家出書了!

一切要從幾年前說起。那時候看到一位朋友在 iT 鐵人賽拿了優選,除了知道有這個比賽以外,自己也想挑戰看看。寫30天的文章來強迫自己學習技術,雖然有點辛苦,但應該會是件蠻有成就的事,而且可以探索寫程式以外的體驗,嘗試其他的可能性。於是前兩年就有持續地報名參加。

不過去年是個蠻特別的一年。記得從年中開始,就陸續給自己找了不少事做,像是心血來潮報名另一個比賽,還有腦衝在台南買房子🤣。原本想說鐵人賽就跟之前一樣,報名一個主題就好。但是在發想主題的時候,一時的腦袋短路跟自以為時間管理大師XD,一口氣報名了三個主題,一個是新書延伸的主題以外,另外兩個分別是-

記得 9 月的每一天,工作以外不是忙新家的事,就是趕著每天的死線寫文章。那時候只想著能夠完賽就很厲害了。很慶幸最後不但順利完賽(雖然有幾篇真的趕不及就先上大綱XD),而且還有主題獲得佳作,當下真的是超超超開心!

決定跟編輯自薦前,其實經過了不少的自我懷疑和猶豫。不過回過神後就已經加了編輯的 LINE ,然後在寫出書計畫了🤣。在埋頭寫書的這半年,完全可以體驗到寫作過程中產生的煩躁、無助、詞窮、鬼打牆、校稿時的不耐煩、每次跟編輯說要 delay 的罪惡感、時程壓力等等,甚至有幾次萌生想放棄的念頭。

最後身體還出點小狀況。因為久坐加沒注意多喝水,就在交稿的前幾天血尿發燒,半夜還跑去掛急診。生活中也有些插曲,有段時間必須要幫忙張羅家裡,沒有辦法付出太多心力在書上。不過默默地,我也就走到現在了,也很開心終於完成了這項創舉😊

出書以外的新體驗

寫完書後,雖然會有種終於解脫的舒適感,不過並不代表就這樣結束。寫書的目的之一,就是希望大家手上都能擁有自己寫的那本書。因此不只要行銷書,也要行銷自己,建立專業形象。雖然我不是那麼地擅長,但是到目前為止的這些嘗試,都是全新的體驗和樂趣,算是寫書以外的新收獲吧!

目前做的嘗試有-

  • 主動參與技術社群: 今年中加入了 ALPHACamp 的 TA 社群,除了可以跟學生教學相長,也有蠻豐富的技術資源,像是不定期的講座和技術分享等。
  • 投稿 conference 的議程: 在 ModernWeb’21 和 JSDC 都獲得新鮮的講者體驗。
  • 經營 SNS 與部落格: 去年開始自架部落格和經營 FB ,除了可以做知識管理,集中文章的產出,也可以熟悉架設部落格或的FB的操作眉角。

給即將踏上這條路的你

去年的頒獎典禮上,<IoT沒那麼難!新手用JavaScript入門做自己的玩具!>的作者-17有分享一些技巧和需要注意的地方。對第一次寫書的我給了不少幫助。經過這次的體驗,我也統整編輯給的修改建議,以及一些在出版上的眉角。如果你也準備踏上這條路,希望能給你點幫助。

圖片

  • 為了方便排版人員進行,圖片需要獨立存在一個目錄下,並且按照章節分別存放。
    按照章節建立目錄

  • 程式碼也是以插入圖片的方式建立的話,也要將程式碼截圖存入,並在章節目錄底下區別一般圖檔跟程式碼截圖。
    章節目錄底下再分一般圖檔跟程式碼截圖

  • 圖檔名稱是以<章節-編號>的格式儲存。另外,如果。需要注意的是,程式碼截圖的編號是跟一般圖檔的編號是分開的,而且名稱前面要再加「程」。

一般圖檔的命名

程式碼截圖的命名

  • 在文檔中,一般圖檔的下方要註記程這樣的格式-「圖」+ 檔案名稱 + 空格 + 圖檔說明文字。程式碼截圖的話只要把檔案名稱括號起來,顏色改成紅色即可。

在文檔中的一般圖檔註記

在文檔中的程式碼截圖註記

  • 如果在製圖的時候需要有比較精緻的圖示或素材,一定要找免費商用的圖片來源,或是直接買授權過的圖示庫。

表格

  • 表格名稱是以<章節-編號>的格式儲存。

  • 在文檔中,表格的上方要註記程這樣的格式-「表」+ 標格名稱 + 空格 + 表格說明文字。在內文銜接到表格的最後一段文字,需要註明表格的參考處。

兩個表格的呈現

三個表格的呈現

  • 如果表格中有欄位是空的,則要填上文字「無」。不過這應該可以跟編輯討論是否需要加。

空欄位填無

程式碼

程式碼的截圖我是用Carbon產出的。可以一開始在設定中先調整自己的視覺偏好,然後匯出成一個設定檔存在書稿的目錄中。如果瀏覽器cache被清除的話,就能匯入設定,保持圖片呈現的一致。

程式碼內文我會在重點語法的部分上粗體,然後在第一行 comment 對應的程式檔名。由於這件事情我是在很後面才想要這麼做。所以等於是全部的程式碼截圖都要重新製作。因此也建議在一開始就先想好要怎麼呈現程式碼的內文。

程式碼截圖

內文格式

以博碩來說的話,只能接受 word 檔。另外排版人員會決定具體的標題和內文的大小、字體或間距等,又或著是延伸重點的版面呈現。如果沒有特別別要求的話,其實不用花太多時間在自訂樣式上,使用 word 預設的標題級距和內文設定就可以囉!

最後有關於上面提到的圖表跟程式碼等等,建議可以初稿完成 8.9 成,基本上不會再有相關的異動的時候,再來處理就好。不然修改的過程中,很容易需要重新編號和變動檔案,這也是件很傷心費神的事,常常會頭暈眼花標錯😵

推薦序

建議可以盡早決定可以幫忙寫推薦序的人選。以編輯的建議的話,盡量是請知名度高,或是在技術社群上有影響力的人幫忙寫。另外如果跟推薦人不熟的話,需要先準備好自己的背景介紹(我是直接上繳履歷XD)、書籍的文案整理,還有至少寫了 2/3 的書稿。另外也可以再多找一至兩位推薦人幫你寫推薦序,只不過要事先跟你的編輯討論喔。

時程上的話,最晚是在最後一校前把推薦序給編輯。如果怕推薦人太忙,導致時程會拖延的話,可以把編輯說的時程,再早個兩三個禮拜跟推薦人說。這樣時程上比較充裕。

文案

通常交完初稿後,編輯會再跟你說要準備文案和作者介紹。這些會變成封面封底的文案內容,在銷售網站上的介紹也會從文案截取。所以需要花點時間構思一下。像是-

  • 書名: 可以加入關鍵字
  • 封面標語: 本書主要在介紹什麼
  • 作者簡介: 照片和名字不一定要真的,大致介紹自己的經歷
  • 內容簡介: 比較詳細的書籍介紹
  • 書籍特色: 列出三到四個特色總覽和簡單說明

小結

或許這本書不是厲害到可以讓程式小白成為技術大神。但是寫的當下都在思考 如果回到 2015 年,怎麼樣的學習方式和內容對我來說是最好的。所以不管是語法呈現或是章節編排,其實大大小小改了很多次,目的就是希望這本書真的可以為一些人帶來價值。

如果對書有興趣的話,可以去天瓏翻翻看。有對到妳/你電波 非常歡迎把它帶回家👏👏
如果沒辦法到實體門市的話,也可以在以下的網站下單購買喔!

我的第一本書 | <ECMAScript關鍵30天> 心路歷程 | 出版的眉角分享

https://yuri-journal.me/成就解鎖/2021111515/

作者

Yuri Tsai

發表於

2021-11-15

更新於

2023-01-16

許可協議

評論