GitBook 准備工作
1、安裝 Node.js
GitBook 是一個基於 Node.js 的命令行工具,下載安裝 Node.js,安裝完成之后,可以使用
$ node -v
來檢驗是否安裝成功。
2、安裝 GitBook。
$ npm install gitbook-cli –g
$ gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3
3、typora安裝
4、創建目錄並初始化,
$ gitbook init
warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
info: initialization is finished
5、切換到本地版本
gitbook build --gitbook=2.6.7
輸入 $ gitbook serve
命令,然后在瀏覽器地址欄中輸入 http://localhost:4000
便可預覽書籍。
6、打開GitBook項目居然運行不了,gitbook serve和gitbook build都報錯。
Error: ENOENT: no such file or directory, stat ‘C:***demo_book\_book\gitbook\gitbook-plugin-fontsettings\fontsettings.js’
原來是一個Bug(Vesion:3.2.3)。
https://github.com/GitbookIO/gitbook/issues/1309
解決辦法如下。
用戶目錄下找到以下文件。
<user>\.gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js
Replace all
confirm: true
with
confirm: false
7、book.json
該文件主要用來存放配置信息,
{ "title": "Blankj's Glory", "author": "Blankj", "description": "select * from learn", "language": "zh-hans", "gitbook": "3.2.3", "styles": { "website": "./styles/website.css" }, "structure": { "readme": "README.md" }, "links": { "sidebar": { "我的狗窩": "https://blankj.com" } }, "plugins": [ "-sharing", "splitter", "expandable-chapters-small", "anchors", "github", "github-buttons", "donate", "sharing-plus", "anchor-navigation-ex", "favicon" ], "pluginsConfig": { "github": { "url": "https://github.com/Blankj" }, "github-buttons": { "buttons": [{ "user": "Blankj", "repo": "glory", "type": "star", "size": "small", "count": true } ] }, "donate": { "alipay": "./source/images/donate.png", "title": "", "button": "贊賞", "alipayText": "" }, "sharing": { "douban": false, "facebook": false, "google": false, "hatenaBookmark": false, "instapaper": false, "line": false, "linkedin": false, "messenger": false, "pocket": false, "qq": false, "qzone": false, "stumbleupon": false, "twitter": false, "viber": false, "vk": false, "weibo": false, "whatsapp": false, "all": [ "google", "facebook", "weibo", "twitter", "qq", "qzone", "linkedin", "pocket" ] }, "anchor-navigation-ex": { "showLevel": false }, "favicon":{ "shortcut": "./source/images/favicon.jpg", "bookmark": "./source/images/favicon.jpg", "appleTouch": "./source/images/apple-touch-icon.jpg", "appleTouchMore": { "120x120": "./source/images/apple-touch-icon.jpg", "180x180": "./source/images/apple-touch-icon.jpg" } } } }
8、https://blog.csdn.net/qq_43514847/article/details/86598399
markdown數學公式語法
markdown支持完整LaTex數學公式語法
1.上標和下標
- 下標使用符號
Y_1
表達,公式表達結果為: - 上標使用
X^{2m}
或者X^2
, 其中較為復雜的表達式用{}
包含, 公式表達結果為:
2.常見運算符
符號 | 表達式 | 符號 | 表達式 | 符號 | 表達式 |
---|---|---|---|---|---|
![]() |
\pm | ![]() |
\times | ![]() |
\div |
![]() |
\cdot | ![]() |
\leq | ![]() |
\geq |
![]() |
\neq | ![]() |
\approx | ![]() |
\equiv |
![]() |
\in | ![]() |
\notin | ![]() |
\subset |
![]() |
\supset | ![]() |
\bigcap | ![]() |
\bigcup |
3.特殊符號
- 求和符號: 使用
\sum
轉義表達求和符號,下限符號使用_{m}
,上限符號使用^\infty
, 如: - 積分符號:
\int_0^1
轉義表達積分符號, 如: - 極限符號:
\lim_{變量 \to 表達式} 表達式
, 如 - 向量符號:
\vec{a}
轉義表達向量, 如: - 空格符號: markdown支持四種空格
\, 、\;、\quad 和 \qquad
4.希臘字母的大小寫
希臘字母的大寫使用首字母大寫\Gamma
轉義,小寫使用首字母小寫\gamma
轉義, 公式表達結果為: 和
5.關於注釋
- 公式注釋: 使用
\text{內容}
轉義注釋,公式表達結果為: - 文字顏色: 使用
\color{顏色}{文字}
轉義表達帶顏色的文字,公式表達結果為:
6.分數
分數使用\frac{part I}{part II}
轉義表達,公式表達結果為:
7.公式中的大括號或大分隔符
- 在配對符號中.如公式中的括號使用
\left(
表達左括號,使用\right)
轉義表達向右的括號;如: - 在非配對符號中以
\left. 其他 \right符號
或\left符號 其他 \right.
表非配對的較大符號.如: - 注: 轉義表達不需要
{ 和 }
8.上划線與下划線
上划線使用\overline{}
轉義表達,下划線使用\underline{}
轉義表達,公式表達結果為: 和
9.開根號
多次方根使用\sqrt[n]{x}
,其中n
表示根的次數,x
表示被開方項,公式表達結果為:
10.方程組
1.表達方式一: 使用\begin{array}{c} 表達式一\\表達式二... \end{array}
2.表達方式二: 使用\begin{cases}…\end{cases}
注: 關於\\[2ex]
一個 [ex] 指一個 “X-Height”,即x字母高度。可以根據情況指定多個 [ex],如 [3ex]、[4ex] 等。 其實可以在任何地方使用 \[2ex] 語句,只要你覺得合適。
12.使用HTML語法表達數學公式
- 上標與下標的表達: 使用標簽
<sub>
和<sup>
表達, 表達結果為: text 與text - 上划線表達: 使用標簽
<SPAN style="TEXT-DECORATION: overline">X</SPAN>
表達,表達結果為: <SPAN style="TEXT-DECORATION: overline">X</SPAN>
13.補充
對於部分符號無法用 markdown 的公式表達,可以使用 \符號
轉義表達,如 等
https://blog.csdn.net/katherine_hsr/article/details/79179622