日韩性视频-久久久蜜桃-www中文字幕-在线中文字幕av-亚洲欧美一区二区三区四区-撸久久-香蕉视频一区-久久无码精品丰满人妻-国产高潮av-激情福利社-日韩av网址大全-国产精品久久999-日本五十路在线-性欧美在线-久久99精品波多结衣一区-男女午夜免费视频-黑人极品ⅴideos精品欧美棵-人人妻人人澡人人爽精品欧美一区-日韩一区在线看-欧美a级在线免费观看

歡迎訪問 生活随笔!

生活随笔

當前位置: 首頁 > 编程资源 > 编程问答 >内容正文

编程问答

搭建Gitbook+Gitee电子书管理工具(一)

發布時間:2024/1/1 编程问答 48 豆豆
生活随笔 收集整理的這篇文章主要介紹了 搭建Gitbook+Gitee电子书管理工具(一) 小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

目錄

  • 搭建Gitbook+Gitee電子書管理工具
    • 1.安裝使用gitbook
    • 2.搭建Gitee倉庫進行版本管理

搭建Gitbook+Gitee電子書管理工具

Gitbook 是一個基于node.js命令的電子書制作工具。其支持Markdown等語法格式進行編輯,可生成HTML與PDF等格式的電子書。關于Gitbook的具體介紹可以參考博文:Gitbook 從懵逼到入門。常搭配版本管理平臺為Github (網上已有許多相關教程)。由于Github有時不穩定,本文采用Gitbook + Gitee的搭配。

1.安裝使用gitbook

具體步驟如下:

  • 安裝Node.js
    可通過 node -v檢查是否安裝Node.js以及其版本,若未安裝則選擇一個版本進行安裝。本文采用10.14.2版本,下載地址為:https://nodejs.org/download/release/
    Ps. 1)Node.js版本不匹配會導致后續出現報錯
    2)如需Node.js 多版本控制則需要用到nvm,本文不做擴充。

  • 安裝Gitbook
    采用命令 npm install gitbook-cli -g進行全局安裝
    采用命令gitbook -V查看安裝情況

  • CLI version: 2.3.2 #先出現 Installing Gitbook 3.2.3 #安裝完成后 GitBook version: 3.2.3
  • 編輯器推薦
    個人推薦Typroa

  • 實例展示
    Gitbook init 初始化
    會生成文件README.md與SUMMARY.md。
    可以通過編輯文件SUMMARY.md來確立電子書主體結構。
    示例代碼:

  • * [簡介](README.md) * [第一章](part1/part1.md)* [第一節](part1/part1_1.md)* [第二節](part1/part1_2.md)


    可在通過命令Gitbook init自動生成對應文件夾、文件。
    執行Gitbook serve后通過訪問http://localhost:4000瀏覽電子書。示例效果如下圖。

    2.搭建Gitee倉庫進行版本管理

    Gitbook + Gitee的配置類似于Gitbook + Github(網上有很多教程)。
    本文以下只做幾點注釋:

  • 為什么要配置ssh?
    并不是必須設置,但是建議設置。git基于多種傳輸協議,如https和ssh,來保障數據傳輸安全。如果不設置ssh公鑰每次提交代碼都要輸入你的帳號密碼。設置ssh密鑰的目的是為了省略輸入用戶名密碼的過程。
  • 如何添加SSH密鑰?
    生成/添加SSH公鑰的方法見:官方文檔。
  • 如何進行版本控制?
    Git相關基本操作可見網址Git基本操作。
  • 總結

    以上是生活随笔為你收集整理的搭建Gitbook+Gitee电子书管理工具(一)的全部內容,希望文章能夠幫你解決所遇到的問題。

    如果覺得生活随笔網站內容還不錯,歡迎將生活随笔推薦給好友。