gitbook使用教程
1. 說明
gitbook網站是一個簡單的個人線上書籍網站,在這裡可以把自己的文件整理成書籍釋出出來,便於閱讀。
gitbook網站: https://legacy.gitbook.com/
本文主要講解在gitbook網站上釋出一個書籍文件和使用gitbook提供的工具在本地開發一個書籍文件部署到自己的服務上
在此之前你需要會如下準備:
- 賬號: github有賬號,gitbook使用github賬號註冊
- git:程式碼管理工具
- Markdown:gitbook主要使用MD語法來編寫書籍的
- gitbook工具:如果你在本地開發需要安裝此外掛,下面有介紹
- nodejs環境:gitbook外掛需要的執行環境
- 一款Markdown編輯器:方便本地開發,推薦 Typora 或gitbook自己的編輯器 gitbook editor
2. 在gitbook網站上建立一本文件書籍
此種方式是使用github網站加gitbook網站的方式來建立書籍的。
首先你要有一個github賬號,然後在github網站中建立了一個repo倉庫,用於存放書籍內容的倉庫。
注意: gitbook網站有時需要使用代理才能開啟。
2.1 登陸gitbook網站
gitbook網站支援直接使用github賬號登陸的,推薦直接使用github賬號登陸。
開啟gitbook網站: https://legacy.gitbook.com/
點選右上角的 Sign In
登陸,然後選擇 Sign in with GitHub
選擇使用github賬號進行登陸。
第一次登陸gitbook網站時,需要github網站的認證,還需要到註冊github網站的郵箱中點選確認。
2.2 建立一本書
2.2.1 點選新建一本書按鈕
登陸網站後,點選右上角的使用者圖示,然後選擇 Your Profile
。然後就會在右上角看見 + new
按鈕,點選此按鈕就是建立一本書。
或者在gitbook的dashboard頁面有一個 New Book
按鈕,點選也可以建立一個書籍:
或者開啟此連結,直接進入建立書籍頁面: https://legacy.gitbook.com/new
2.2.2 在建立書籍中選擇github