gitbook搭建一個簡單的faq網站
阿新 • • 發佈:2019-02-14
1. npm安裝gitbook-cli
npm install -g gitbook-cli
2. 新建一個專案目錄,進到目錄裡執行
gitbook init
3. 新建book.json(這是配置檔案),加入faq主題
{
“plugins”:[“theme-faq”]
}
4. 再加入中文搜尋功能
{
“plugins”:[“theme-faq”, “-lunr”, “search-jieba”]
}
5. 加入外掛後需要執行
gitbook install
6. 啟動服務
gitbook serve
7. 啟動後訪問localhost:4000,頁面樣式就像這樣
8. Gitbook Editor很好用,可以新增、管理文章
有一些坑:
- 官網上說最多可以新增100篇文章,可能是說線上gitbook,具體需要嘗試
- 中文搜尋由於分詞的關係,搜尋單字時效果不好
- 搜尋框內輸入過快、或者說快速變化輸入的單詞時,搜尋的結果和預期的不一樣
- README會顯示在搜尋框下方,不顯示在文章列表裡,但是下面第一部分的文章數量又包含了README,強迫症很糾結