GitBook 使用教程及markdown數學公式語法


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安裝

https://www.typora.io/

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表達,公式表達結果為: y_1
  • 上標使用 X^{2m}或者X^2, 其中較為復雜的表達式用{}包含, 公式表達結果為: X^{2m}+X^2

2.常見運算符

符號 表達式 符號 表達式 符號 表達式
\pm \pm \times \times \div \div
\cdot \cdot \leq \leq \geq \geq
\neq \neq \approx \approx \equiv \equiv
\in \in \notin \notin \subset \subset
\supset \supset \bigcap \bigcap \bigcup \bigcup

3.特殊符號

  • 求和符號: 使用\sum 轉義表達求和符號,下限符號使用_{m},上限符號使用^\infty, 如: \sum_{m=0}^\infty
  • 積分符號: \int_0^1轉義表達積分符號, 如: \int_0^1
  • 極限符號: \lim_{變量 \to 表達式} 表達式, 如 \lim_{1 \to 5} 表達式
  • 向量符號: \vec{a}轉義表達向量, 如: \vec{a}
  • 空格符號: markdown支持四種空格\, 、\;、\quad 和 \qquad

4.希臘字母的大小寫

希臘字母的大寫使用首字母大寫\Gamma轉義,小寫使用首字母小寫\gamma轉義, 公式表達結果為: \Gamma\gamma

5.關於注釋

  • 公式注釋: 使用\text{內容}轉義注釋,公式表達結果為: \text {公式注釋}
  • 文字顏色: 使用\color{顏色}{文字}轉義表達帶顏色的文字,公式表達結果為: \color{green}{文字}

6.分數

分數使用\frac{part I}{part II}轉義表達,公式表達結果為: \frac{(-1)^m}{m!(m + 1)}

7.公式中的大括號或大分隔符

  • 在配對符號中.如公式中的括號使用\left(表達左括號,使用\right)轉義表達向右的括號;如: \left({\frac{x}{2} }\right)
  • 在非配對符號中以\left. 其他 \right符號\left符號 其他 \right. 表非配對的較大符號.如: \left.\frac{du}{dx}\right|_{x=0}
  • 注: 轉義表達不需要{ 和 }

8.上划線與下划線

上划線使用\overline{}轉義表達,下划線使用\underline{}轉義表達,公式表達結果為: \overline{a+b+c+d}\underline{a+b+c+d}

9.開根號

多次方根使用\sqrt[n]{x},其中n表示根的次數,x表示被開方項,公式表達結果為: \sqrt[n]{3}

10.方程組

       1.表達方式一: 使用\begin{array}{c} 表達式一\\表達式二... \end{array}
\left\{ \begin{array} {a} a_1x+b_1y+c_1z=d_1 \\ a_2x+b_2y+c_2z=d_2 \end{array} \right.
2.表達方式二: 使用\begin{cases}…\end{cases}
f(n) = \begin{cases} \frac{n}{2}, & \text{if $n$ is even} \\[2ex] 3n+1, & \text{if $n$ is odd} \end{cases}
注: 關於\\[2ex]一個 [ex] 指一個 “X-Height”,即x字母高度。可以根據情況指定多個 [ex],如 [3ex]、[4ex] 等。 其實可以在任何地方使用 \[2ex] 語句,只要你覺得合適。

12.使用HTML語法表達數學公式

  • 上標與下標的表達: 使用標簽<sub><sup>表達, 表達結果為: texttext
  • 上划線表達: 使用標簽<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


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM