來做一個 gitbook 電子書八~

gitbook github

居然解出來了 2018-07-04 23:51:35 ‧ 8999 瀏覽

分享至

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

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

github : https://github.com/
gitbook : https://www.gitbook.com/join

所以我們開始來寫書嚕 ~

在本機建立一個專案資料夾
進入此資料夾並創立 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製作

如果有問題歡迎發問

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

熱門推薦

{{ item.channelVendor }} | {{ item.webinarstarted }} |

直播中

3 則留言

居然解出來了

iT邦好手 1 級 ‧ 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
    }
  }
}