iT邦幫忙

5

來做一個 gitbook 電子書八~

  • 無須任何git技術也可入門,所以下面的教學都為操作步驟
  • 當然如果會git技術就可以更加輕鬆上版
  • 先講為何來說這技術的目的
    • 可以增加技術的交流
    • 對於任一技術有更佳的結構化認識
    • 能更有效的學習
    • 更有可能因此可以寫書!?

如果沒有 github 跟 gitbook帳號可以去申請一下~

所以我們開始來寫書嚕 ~

  • 在本機建立一個專案資料夾
  • 進入此資料夾並創立 README.md SUMMARY.md
  • .gitbook.yaml 放在你可以抓到的檔案位置
    • README.md 為首頁
    • SUMMARY.md為目錄
    • .gitbook.yaml 為 gitbook設定檔
  • README.md 範例 :
## 我的首頁
#### 看起來還不錯
  • SUMMARY.md 範例 :
# Summary

* [我的首頁](README.md)
    * [我的首頁分頁](my.md)
* [更多內容](content.md)
  • .gitbook.yaml 範例 :
# Root directory to locate the content
# Default is the root directory of the repository.
root: ./你的專案資料夾名稱/

# Files to use as SUMMARY/README.
# (Relative to <root> directory)
structure:
  readme:  README.md
  summary: SUMMARY.md

# Redirect urls to specific files (relative to the <root> directory)
#redirects:
  #previous/page: new-folder/page.md

將所有內容都創建完後(包括 其他 md 檔案),就可以做書了!

github 步驟

  • 請先在 github 創立一個專案
    若不太會git建議起初創立README.md,之後可透過 upload files 直接上傳
  • 先將 .gitbook.yaml 設定檔上傳以後,再將專案資料夾上傳即可
  • 原本github創建的 README.md 可以用來介紹此專案的目的

gitbook 步驟

  • 當創建完帳號,一定會創立一個組織
  • 名字都可以隨意(因為都可以更改頭像與名字)
  • 在組織裡創建一個 space(電子書)
  • space 的名字也可自取~最重要的是 與 github 連結(方便上版到gitbook)
  • 點選左下方的 藍色方塊按鈕 找到 integrations 可以看到 github
  • 點選以後,與當初在github的專案連結起來即可

有沒有很簡單!一本電子書就此誕生了!?
當然 node 也可製作 gitbook 本機離線版 (在下面留言 介紹使用)

我自己製作的 bootstrap gitbook,小小範例(如果可以隨手幫加顆星星~3q)

我的gitbook製作

如果有問題歡迎發問

若有做出來的新書,歡迎留言發表,彼此交流技術 與 結構設計


0
partyyaya
iT邦新手 5 級 ‧ 2018-07-05 11:32:01

node gitbook 使用

  • 安裝 node : https://nodejs.org/en/
  • 使用 node(cmd) 安裝 gitbook
    • npm install gitbook -g
    • npm install gitbook-cli -g
  • 創建依專案資料夾,並用 cmd 進入
  • 初始化 gitbook 文件指令 : gitbook init
  • 會看到node已經幫建立 README.md , SUMMARY.md
  • 照上面主篇的格式寫入檔案中

gitbook pdf & 離線網頁版

  • 前面的目錄檔案都需準備好
  • 安裝 calibre (為了產生 pdf)
  • 設定book.json檔 為 gitbook 製作設定檔(注意要放在同一目錄資料夾)
  • book.json 範例 : 裡面包含 pdf 設定 與 plugin 插件
{   
    "title": "自取名稱",
    "description": "自行描述",
    "language": "zh",
    "pluginsConfig": {
        "fontSettings": {
          "theme": "white",
          "family": "msyh",
          "size": 2
        } 
    },
    "plugins": [
      "multipart",
      "yahei",
      "katex",
      "search",
      "splitter",
      "collapsible-chapters"
   ],
  "pdf": {
    "pageNumbers": true, 
    "fontFamily": "Arial",
    "fontSize": 12,
    "paperSize": "a4",
    "margin": {
      "right": 0,
      "left": 0,
      "top": 0,
      "bottom": 0
    }
  }
}

gitbook 主要指令 :

  • gitbook install : 安裝所有 plugin 插件
  • gitbook build : 做出離線網頁版 book
  • gitbook serve : 開啟網頁 gitbook
  • gitbook pdf : 做出 電子書 pdf

我自己製作的 bootstrap gitbook,小小範例

我的gitbook製作

0
小魚
iT邦高手 1 級 ‧ 2018-07-05 12:38:27

所以,
是做成PDF的意思嗎?
我以為是那種可以翻的電子書.

0
darwin0616
iT邦新手 3 級 ‧ 2018-07-05 18:00:52

gitbook有沒有什麼管道找出版社出版???例如點擊率達標或其他, 有辦法吸引Amazon或其他出版社幫出書嗎???

這倒是沒有耶 ~ 如果想出書我建議直接找出版社會更快
可以讓他看你github書的點閱率或星星數或許他就讓你出版了

Homura iT邦研究生 2 級‧ 2018-07-05 23:24:24 檢舉

以前在看.Net社群sky的blog時有看到雜誌編輯還是什麼,找他去寫文章之類的..
不過他本人好像沒興趣吧
沒回留言

我要留言

立即登入留言