Skip to content

gdutwyg/gitbook-notes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gitbook的安装与使用

1. 通过GitBook Editor方式

可视化编辑器Editor 是官方推荐的可视化编辑器,可以直接在编辑器里面写markdown,支持

  • 离线编辑书籍
  • 联网同步和发布
  • 还可以导出pdf和mobi格式
  • 等等

2. 通过nodejs方式

命令行方式

  • 确定安装好了node和npm

  • 安装 gitbook, 在命令行中输入并执行 npm install gitbook-cli -g

  • 输入gitbook -V 打印出gitbook版本号则说明安装成功了

  • gitbook是可以配置的,你可以新建一个 book.json,在里面配置插件等等,之后执行 gitbook install,就可以安装book.json里面的插件了,关于book.json是怎么配置的,可以查阅这篇文章

  • 接下来我们首先先手动创建 README.mdSUMMARY.md这两个文件

    book/
    ├── README.md   是对书籍的简单介绍
    └── SUMMARY.md  是书籍的目录结构

    README.md

    This is a book powered by [GitBook](https://github.com/GitbookIO/gitbook).
    

    SUMMARY.md

    * [Introduction](README.md)
    * [Chapter1](chapter1/README.md)
      * [Section1.1](chapter1/section1.1.md)
      * [Section1.2](chapter1/section1.2.md)
    * [Chapter2](chapter2/README.md)

    创建了这两个文件后,使用 gitbook init,它会为我们创建 SUMMARY.md 中的目录结构

  • markdown写完之后可以在线预览,执行 gitbook serve ,生成一个_book文件夹

现在,可以用浏览器打开 http://127.0.0.1:4000 查看书籍的效果

3. 附上gitbook常用指令

- gitbook init //初始化目录文件
- gitbook help //列出gitbook所有的命令
- gitbook --help //输出gitbook-cli的帮助信息
- gitbook build //生成静态网页
- gitbook serve //生成静态网页并运行服务器
- gitbook build --gitbook=2.0.1 //生成时指定gitbook的版本, 本地没有会先下载
- gitbook ls //列出本地所有的gitbook版本
- gitbook ls-remote //列出远程可用的gitbook版本
- gitbook fetch 标签/版本号 //安装对应的gitbook版本
- gitbook update //更新到gitbook的最新版本
- gitbook uninstall 2.0.1 //卸载对应的gitbook版本
- gitbook build --log=debug //指定log的级别
- gitbook builid --debug //输出错误信息

Releases

No releases published

Packages

No packages published