跳到主要內容

使用 Gitbook 寫一本書

使用 Gitbook 寫一本書

很多人會期待自己都可以擁有自己一本書籍,或者是期待自己可以推出自己的小說,透過 gitbook 這個工具其實非常容易完成。

在約莫一個多月前, Node.js 中文書籍進行改寫計畫,當時似乎沒有找到 gitbook 這類的工具,那時候社群就打算自己打造類似 gitbook 這樣的工具,讓大家可以透過 cli 直接可以產生 html, pdf, epub 等不同格式,讓大家都可以直接線上閱讀。

我們就來看一下 gitbook 到底要怎麼使用。

gitbook

gitbook 是一個 open source 的專案,主要是針對電子書寫手可以直接入門,讓大家可以透過開發者所習慣的 markdown 格式,以及 cli 的方法直接產出靜態網站,以及資料。

安裝方法

安裝方式只要透過 npm 就可以立刻安裝完成,

npm install -g gitbook

使用方法

快速上手的方法,其實十分簡單,我們只需要在專案資料夾底下設定檔案 SUMMARY.md ,建立書籍大綱, SUMMARY.md 的範例檔案可以參考。範例

# Node.js 網站開發快速上手指南

一本屬於繁體中文,從華人自身發起給予『Node.js 新手的學習手冊』,藉由實際動手開發的過程中,讓大家了解到 Node.js 開發有趣之處。

* [Node.js 介紹](source/intro/nodejs.md)
* [Node.js 安裝](source/install/installNode.md)
  * [Node.js 安裝](source/install/installNode.md)
  * [Node.js 線上測試環境](source/install/onlineEnv.md)

gitbook 指令

gitbook 提供幾種不同的指令給予大家參考,

當一開始 SUMMARY.md 檔案建立好之後,可以透過 init 的步驟,gitbook 會自動幫忙建立對應的資料夾,以及檔案名稱。

gitbook init

建立 static server ,會自動幫你開啟一個 4000 port 的靜態伺服器,當然你可以透過設定檔去修改 port 的位置。

gitbook serve

產生 pdf, epub 等格式

gitbook [pdf|ebook]

後記

這類工具目前看起來主要大宗還是以程式開發背景的人員為主,大家現在都漸漸可以習慣 wiki, md 這類的標記文章,讓格式統一,也讓整體瀏覽方式比較一致。

對於寫書來說透過 gitbook 可以更快進行發佈,畢竟類似像 Node.js 這類程式發展速度還是太快,可能真的書商發佈推出書籍的時候 Node.js 的相依模組,或者是套件可能都已經不敷使用,或者跟不上更新的速度,造成開發者的困擾。

透過線上更新,可以讓更多人看到最新的消息,也讓大家知道第一手資訊,同時也可以透過 open 的力量,將知識傳遍所有地方。

留言

這個網誌中的熱門文章

[分享] 腳踏車環島注意事項

很多人都期望自己能夠做點什麼,做些什麼,而退伍之後的第二個星期,就展開了環島之旅。 對很多人來說這不算什麼,甚至有人展開了走路、跑步、溜滑板、單輪車等方式環島一周,充分展現對台灣的愛與關懷。 這篇主要讓不知道怎麼準備環島的人,作一個完善的解說,首先隨身的東西要有: 證件現金類 : 身份證 健保卡 學生證 現金 提款卡 悠遊卡

館長的網站技術瓶頸,小弟弟來解答 - notorious-2019.com

館長的網站技術瓶頸,小弟弟來解答 - notorious-2019.com 昨天看到館長的網站倒了,也看到館長說一個月花費大概一百萬左右的月費在支持這個架設的電商網站,也對外發布出來訊息,希望求救, 直接講結論 建議解法, 1. 首先要做的事情是讓整個網站可以橫向擴展 (Load Balancer + n 台伺服器),對,相信我,IIS 也是可以做 Scale out, 這是對於 Application layer 服務的解法。 2. 資料的部分 SQL 吞吐量,建議改成 GCP Cloud SQL, 或者就直接轉到 Azure SQL Server 環境上會相對容易解決 SQL 的問題。 上述 2 個步驟都處理完,其實 100 萬的費用,應該 20000 concurrent user 是沒有問題的,但前提是要設定『對』! 額外需要花較長期時間要處理的,建議就是在 Queue 的處理,購物車的狀態都可以進入到 Queue 再來處理 SQL insert 的問題,減少不斷的 insert / update 的狀態,後文會提到 ... 底下詳細的會再說明如何後後續還有哪些處理的細節。 這兩天剛好有個小空擋,就來分析一下狀況, 可以從外部讀取得到的服務大致上如下, ASP.Net : 4.0 IIS 10 + Windows (廢話) SQL Server (推測) OP Service: PleskWin Host: Google Cloud DNS: Cloudflare 前端服務內容架構 Server-side render, jQuery base, 推測有可能採用現成購物車來進行,看起來不太像是用 wooCommerce 比較像是 Cart Functionality 這類的項目直接搭建而成(當然這純屬猜測) 功能拆解 因為網站是透過 Server site render 所有頁面都需要重新透過伺服器進行載入,這樣的狀況,如果在頻繁忙碌的 eCommerce 網站架構下會是一個致命傷, 簡單來說,數量的查詢,特惠價,優惠碼等等資訊的處理,使用者每做一步都需要重新跳轉頁面,或者整頁面重新讀取,只是為了部分的資料更新,這些都可以抽取出來成為 API ,透過 AJAX 的方式進行讀取。 讀寫分離 在不了解目前資料庫複雜狀態下,首先要讓所有人都

[教學] 快快樂樂刪除CodeIgniter index.php

預設的CI網址預設都設定為index.php同一層級,因此所有的程式都必須指定index.php導向才能開始,例如 http://localhost/ci/index.php/welcome/test http://localhost/ci/welcome/test 本文將說明如何將惱人的index.php消除,還你一個漂亮的URL。 設定開始: 接下來說明如何使用rewrite方式將惱人的index.php去除。 rewrite不清楚的人,煩請先自行google 首先要先確定Apache的 mod_rewrite 有 開啟 ,如果沒有開啟請設定好之後重新啟動apache。 接著,在根目錄底下建立一個新檔案,檔名為 .htaccess ,裡面程式碼如下: <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php/$1 [L] </IfModule> 接著到 application/config/config.php ,開啟檔案修改 $config['index_page'] = ""; 注意: /index.php/$1 要根據你目錄,例如 http://localhost/index.php ,網站根目錄為 /ci/index.php 則要寫成 /ci/index.php/$1 接著至CI目錄下,尋找 config\config.php , 修改一下裡面的檔案,修改如下: $config['index_page'] = ""; 存檔後,如此一來大功告成。 參考資料 官方網站說明