中文字幕无码av不卡一区,亚洲综合AV永久无码精品一区二区,黑人巨大白妞出浆,黄色高清无码免费看,久久久久免费精品国产,久久无码人妻丰满熟妇区毛片,欧美日韩国产综合草草,久久福利网站,亚洲一区二区三区中文字幕在线,av国内精品久久久久影院

本文主要圍繞 GitBook 的安裝、使用、集成、書籍發布四個方面來論述。

GitBook 是一項致力于文檔編制、數碼寫作和出版的新型、簡單的解決方案。它不僅提供了簡單且強大的電子書創建工具 GitBook，同時還提供了在線電子書制作平臺 GitBook.com。

GitBook?is where you create, write and organize documentation and books with your team.

簡單點說，如果你想自己寫開源的需求文檔玩也打算讓其他人加入一起參與創作，就可以嘗試選擇 Gitbook 了。

為什么要將需求文檔開源呢？日常工作中，復雜程度很高的業務需求（如醫療行業）單個人或者單個組織的知識范圍和深度難以分析透徹，眾人拾柴火焰高，將需求文檔轉變為眾創的形式，就極有可能在一段時間的演化后輸出品質極高的需求文檔，人人編寫，人人使用，這也是互聯網開放開源精神的體現！

很多東西就是玩出來的，如果你不滿不同行業的知識壁壘和樂于分享你的知識，同時，你也打算自己改變這種現狀，這篇文章就值得一看。（預計花費8分鐘閱讀完，消化并熟練掌握需2小時）

本文主要圍繞 GitBook 的安裝，使用，集成，書籍發布四個方面來論述，還會分享一些Gitbook 書籍資源，文末還會發起開源的編寫不同行業的需求文檔的活動。

Let’s play~

安裝

首先，你需要安裝 node.js ，以便使用“命令提示符” （Mac 系統打開“終端”）來安裝 Gitbook 。

安裝只需要一步就能實現，簡單移動。

$ npm install gitbook -g

由于網絡的原因，安裝的時間可能會較長一些，請耐心等待直到安裝完成。

安裝完成后可以輸入以下命令，以查看 GitBook 版本的方式檢查是否安裝成功：

$ gitbook -V

使用

基本的用法并不復雜，一般來說需要兩步：

1. 使用?gitbook init?初始化書籍目錄
2. 使用?gitbook serve?編譯書籍

下面使用一個簡單直觀的示例來介紹 Gitbook 的基本使用方法。

gitbook init

首先，創建如下目錄結構：

$ tree book/
book/
├── README.md
└── SUMMARY.md

0 directories, 2 files

README.md 和 SUMMARY.md 是兩個必須文件，README.md 是對書籍的簡單介紹：

$ dog book/README.md
# README

This is a book powered by [GitBook](https://github.com/GitbookIO/gitbook).

SUMMARY.md 是書籍的目錄結構。內容如下：

$ dog book/SUMMARY.md
# SUMMARY

* [Chapter1](chapter1/README.md)
* [Section1.1](chapter1/section1.1.md)
* [Section1.2](chapter1/section1.2.md)
* [Chapter2](chapter2/README.md)

創建了這兩個文件后，使用?gitbook init，它會為我們創建 SUMMARY.md 中的目錄結構。

$ cd book
$ gitbook init
$ tree
.
├── README.md
├── SUMMARY.md
├── chapter1
│ ├── README.md
│ ├── section1.1.md
│ └── section1.2.md
└── chapter2
└── README.md

2 directories, 6 files

gitbook serve

書籍目錄結構創建完成以后，就可以使用?gitbook serve?來編譯和預覽書籍了：

$ gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit …

info: 7 plugins are installed
info: loading plugin “livereload”… OK
info: loading plugin “highlight”… OK
info: loading plugin “search”… OK
info: loading plugin “lunr”… OK
info: loading plugin “sharing”… OK
info: loading plugin “fontsettings”… OK
info: loading plugin “theme-default”… OK
info: found 5 pages
info: found 7 asset files
info: >> generation finished with success in 1.8s !

Starting server …
Serving book on http://localhost:4000

gitbook serve?命令實際上會首先調用?gitbook build?編譯書籍，完成以后會打開一個 web 服務器，監聽在本地的 4000 端口。

現在，可以用瀏覽器打開?http://127.0.0.1:4000?查看書籍的效果，如下圖：

現在，gitbook 為我們創建了書籍目錄結構后，就可以向其中添加真正的內容了，文件的編寫使用 markdown 語法，在文件修改過程中，每一次保存文件，gitbook serve?都會自動重新編譯，所以可以持續通過瀏覽器來查看最新的書籍效果！

此外，你還可以下載 Gitbook 編輯器，實現所見所得編輯體驗。

圖書輸出

目前為止，Gitbook支持如下輸出：

• 靜態HTML，可以看作一個靜態網站
• PDF格式
• eBook格式（Mobi&ePub）
• 單個HTML文件
• JSON格式

輸出PDF

輸出為PDF文件，需要先安裝gitbook pdf。

$ npm install gitbook-pdf -g

如果在安裝gitbook-pdf時，覺得下載phantomjs包太慢的話，你可以到phantomjs的官方網站上去下載。http://phantomjs.org/

這個包的安裝方式，參考其官網的說明文檔。

然后，用下面的命令就可以生成PDF文件了。

$ gitbook pdf {book_name}

如果，你已經在編寫的gitbook當前目錄，也可以使用相對路徑。

$ gitbook pdf .

然后，你就會發現，你的目錄中多了一個名為book.pdf的文件。

發布

可以使用Github Pages服務將我們寫的gitbook發布到互聯網上，前提是你已經了解了Git、Github及Github Pages的使用。

創建倉庫與分支

1. 登陸到Github，創建一個新的倉庫，名稱我們就命名為book，這樣我就得到一個book倉庫。
2. 克隆倉庫到本地：?git clone git@github.com:/USER_NAME/book.git
3. 創建一個新分支：?git checkout -b gh-pages，注意，分支名必須為gh-pages。
4. 將分支push到倉庫：?git push -u origin gh-pages。
5. 切換到主分支：git checkout master。

經過這一步處理，我們已經創建了gh-pages分支了，有了這個分支，Github會自動為你分配一個網址。

Gitbook資源

李笑來《重生》

只推薦這本書吧，七年一重生，開拓新的人生維度~

這就是一本開源的書籍，同樣的，需求文檔也是可以是開放式的。

拓展

直接將排版好導出的文檔可以放入 Kindle 或 iBooks 中，閱讀體驗可以得到不小提升~

歡迎加入到編輯開源需求文檔的隊伍中~

本文由 @姚磊 原創發布于人人都是產品經理。未經許可，禁止轉載。