gitbook+git+typora 的使用过程

Posted 2021-01-21 eveblog

Typora

下载地址：https://typora.io/

gitbook

第一步：安装

npm install -g gitbook-cli

第二步：使用
对要操作的文件夹执行命令

gitbook init

执行完后，你会看到多了两个文件 —— README.md 和 SUMMARY.md，它们的作用如下：

README.md —— 书籍的介绍写在这个文件里
SUMMARY.md —— 书籍的目录结构在这里配置

然后，启动Typora 来打开这个文件夹：
[image.png-62kB][1]

编辑 SUMMARY.md 文件，内容修改为：

# 目录

• 前言
• 第一章
• 第1节：衣
• 第2节：食
• 第3节：住
• 第4节：行
• 第二章
• 第三章
• 第四章

在 mybook 文件夹中再次执行 gitbook init 命令。GitBook 会查找 SUMMARY.md 文件中描述的目录和文件，如果没有则会将其创建。
Typora 是所见即所得（实时渲染）的 Markdown 编辑器，这时候它是这样的：
[image.png-210.2kB][2]

3.预览书籍

gitbook serve

执行命令后会对 Markdown 格式的文档进行转换，默认转换为 html 格式，提示Serving book on http://localhost:4000，打开网址即可查看

4.构建书籍

gitbook build

默认将生成的静态网站输出到 _book 目录。实际上，这一步也包含在 gitbook serve 里面，因为它们是 HTML，所以 GitBook 通过 Node.js 给你提供服务了。

build 命令可以指定路径：

 gitbook build [书籍路径] [输出路径]

serve 命令也可以指定端口：

gitbook serve --port 2333

你还可以生成 PDF 格式的电子书：

gitbook pdf ./ ./mybook.pdf

生成 epub 格式的电子书：

gitbook epub ./ ./mybook.epub

生成 mobi 格式的电子书：

 gitbook mobi ./ ./mybook.mobi

4.开始写笔记，使用git add,git commit,git push -u github master,提交。

每次更新完这个文件后，在该文件的根目录下执行gitbook init，就会自动生成相应的目录。

注意：[]和()之间不能有空格，添加完后要运行gitbook init就会在对应的目录下生成对应的.md文件，然后在这些文件中添加内容
[1]: http://static.zybuluo.com/eve-0803/9em4g2zoinflre5tu9m92uep/image.png
[2]: http://static.zybuluo.com/eve-0803/s1d9c4su44fa9hxjwn0rmf7i/image.png