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语法表达数学公式

上标与下标的表达: 使用标签和表达, 表达结果为: _text 与^text
上划线表达: 使用标签X表达,表达结果为: X

13.补充

对于部分符号无法用 markdown 的公式表达,可以使用 \符号 转义表达,如 $\%$ 等

https://blog.csdn.net/katherine_hsr/article/details/79179622

posted @ 2019-12-27 17:51 CxAgoni 阅读(2431) 评论(0) 收藏举报

刷新页面返回顶部