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