1. 程式人生 > >gitbook搭建一個簡單的faq網站

gitbook搭建一個簡單的faq網站

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,強迫症很糾結