gitbook使用記錄

gitbook-convert

可以將docx,pdf轉換成gitbook markdown文件目錄

可以使用npm install gitbook-convert -g安裝

gitbook

是一個文檔工具,可以將文檔發布為靜態網站、pdf、ebook等

可以使用npm install gitbook-cli -g安裝

常用的指令是:

gitbook install

可以安裝book.json 里的gitbook插件;

gitbook build

可以由markdown生成靜態網頁;

gitbook serve

可以運行一個靜態網頁的服務器

book.json參考格式

{ ??"gitbook":?"*", ??"basePath":?".", ??"language":?"", ??"theme":?"default", ??"title":?"xxxx", ??"description":?"xxxx", ??"plugins":?[ ???"highlight", ???"expandable-chapters", ????"copy", ??"search", ???"lunr", ???"sharing", ???"fontsettings", ???"add-js-css" ??], ??"pluginsConfig":?{ "search":?{}, "lunr":?{ "maxIndexSize":?1000000, "ignoreSpecialCharacters":?false }, "fontsettings":?{ "theme":?"white", "family":?"sans", "size":?2 }, "highlight":?{}, "copy":?{}, "expandableChapters":?{ "cssFile":?["expandable-chapters-theme.css"] }, "sharing":?{ "facebook":?true, "twitter":?true, "google":?false, "weibo":?false, "instapaper":?false, "vk":?false, "all":?["facebook",?"google",?"twitter",?"weibo",?"instapaper"] }, "expandable-chapters":?{}, ????"add-js-css":?{ ????"js":?[ ????], ????"css":?[ ??????"./styles/style.css" ????] ?????} ????} }

兩個問題:

（一）我的環境需要設置git代理

1.設置git代理

git config --global https.proxy https://域賬號:密碼@xxxxx.com:8080

git config --global http.proxy http://域賬號:密碼@xxxx.com:8080

如果密碼中有特殊字符，可以使用chrome的consle，在其中輸入:encodeURIComponent(密碼)，查看轉義后的內容，進行設置

2、不支持git協議，使用https協議代替git協議: git config --global url."https://".insteadOf git://

3、不驗證ssl協議：git config --global http.sslVerify false

（二）npm代理設置

no-proxy=.xxx.com---不需要代理的域

registry=https://repo.xxxx.com/repository/npm/

_auth="repository pass"----如果倉帶auth驗證

always-auth=true

proxy=http:///域賬號:密碼@xxxxx.com:port/

https-proxy=http:///域賬號:密碼@xxxxx.com:port/

prefix=npm本地倉路徑--如果要放到非C盤下默認路徑的時候指定

由于我的npm設置了prefix,所以后來在全局安裝了gitbook后,直接運行gitbook命令還是找不到，需要將prefix路徑加到環境變量或者直接到該路徑執行指令

參考:

https://blog.csdn.net/axi295309066/article/details/61420694

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。