位置: 编程技术 - 正文
推荐整理分享GitBook 制作电子书详细教程(搭建gitbook),希望有所帮助,仅作参考,欢迎阅读内容。
文章相关热门搜索词:搭建gitbook,搭建gitbook,gitbook生成html,gitbook生成html,gitbook怎么用,gitbook生成pdf,gitbook怎么用,gitbook 在线编辑,内容如对您有帮助,希望把文章链接给更多的朋友!
gitbook安装:
下载node.js源代码(点击绿色的INSTALL),
解压
成功执行后,npm就被安装好了。
2. gitbook 安装命令
查看gitbook是否安装成功。
ref
===
1. wanqingwong.com/gitbook-zh/index.html
gitbook使用
===========
1. 根据目录生成图书结构
1.1 README.md 与 SUMMARY编写
README.md
这个文件相当于一本Gitbook的简介。
SUMMARY.md
这个文件是一本书的目录结构,使用Markdown语法,
如我们这本书的SUMMARY.md:
输入
* [简介](README.md)* [第一章](chapter1/README.md) - [第一节](chapter1/section1.md) - [第二节](chapter1/section2.md)* [第二章](chapter2/README.md) - [第一节](chapter2/section1.md) - [第二节](chapter2/section2.md)* [结束](end/README.md)
1.2 生成图书结构
当这个目录文件创建好之后,我们可以使用Gitbook
的命令行工具将这个目录结构生成相应的目录及文件:
├── chapter1│ ├── README.md│ ├── section1.md│ └── section2.md├── chapter2│ ├── README.md│ ├── section1.md│ └── section2.md├── end│ └── README.md├── README.md└── SUMMARY.md
我们可以看到,gitbook给我们生成了与SUMMARY.md所对应的目录及文件。
每个目录中,都有一个README.md文件,相当于一章的说明。
2. 生成图书
2.1 输出为静态网站
你有两种方式输出一个静态网站:
2.1.1 本地预览时自动生成
当你在自己的电脑上编辑好图书之后,你可以使用Gitbook的命令行进行本地预览:
然后浏览器中输入:
这样就可以预览生成的以网页形式组织的书籍。
这里你会发现,你在你的图书项目的目录中多了一个名为_book的文件目录,而这个目录中的文件,即是生成的静态网站内容。
使用build参数生成到指定目录
与直接预览生成的静态网站文件不一样的是,使用这个命令,你可以将内容输入到你所想要的目录中去:
2.2 输出PDF
输入为PDF文件,需要先使用NPM安装上gitbook pdf:
我在执行上面这条命令的时候出现了下面的错误:
***************************************************
***************************************************
由错误报告内容的第一行可以知道,发生错误的原因是下载
phantomjs发生了错误,因此我们需要手动下载和安装。
解决方法:[1]
然后,使用下面的命令,要PDF文件,首先安装依赖库:
发生错误:
*****************************************************
*****************************************************
解决方法[2]
ref
===
问题
===
1. 如果输入gitbook init命令,出现Installing version 2.1.0,
需要耐性等待安装。
标签: 搭建gitbook
本文链接地址:https://www.jiuchutong.com/biancheng/371439.html 转载请保留说明!上一篇:实战模拟监控MySQL服务shell脚本小结(模拟监控app)
友情链接: 武汉网站建设