|
《LINUX实操：Gitbook简易使用教程》要点：
本文介绍了LINUX实操：Gitbook简易使用教程，希望对您有用。如果有疑问，可以联系我们。
简介
GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书.GitBook支持输出以下几种文档格局
-
静态站点：GitBook默认输出该种格局
-
PDF：必要安装gitbook-pdf依赖
-
eBook：必要安装ebook-convert
准备安装
在使用GitBook 之前,我们需要先安装一些必需的工具,Node.js、GitBook、GitBook Editor、Git版本控制器.
Node.js
Node.js 是一个基于Chrome JavaScript 运行时建立的一个平台,用来便利地搭建快速的,易于扩展的网络应用· Node.js 借助事件驱动,非阻塞 I/O 模型变得轻量和高效,非常适合 run across distributed devices 的 data-intensive 的实时应用.
1、win下安装Node.js
直接到nodejs官网下载,简单安装即可,此处不再细述.
2、检测是否安装胜利
node -v //显示v4.1.1
GitBook
GitBook 是一个基于 Node.js 的命令行对象,可使用 Github/Git 和 Markdown 来制作精美的电子书.通过Node.js命令安装GitBook
1、NMP安装Gitbook
npm install gitbook -g
2、安装gitbook CLI
想在系统上的任何地方的gitbook命令,必要安装“gitbook CLI”,执行以下命令
//安装敕令
npm install -g gitbook-cli
//卸载敕令
npm uninstall -g gitbook
3、查验下是否安装成功
gitbook -V //显示0.4.2
Git
Git是一款免费、开源的分布式版本控制系统,用于敏捷高效地处理任何或小或大的项目.基本安装请点击安装教程.如果不需要从GitHub更新书到当地再编译,则可以不安装Git.
GitBookEditor
GitBook官方客户端编纂器,支持Win、Linux、Mac系统.请点击下载GitBookEditor.使用该编纂器可以快速的创建、编纂GitBook.安装具有以下步骤：
基本使用
GitBook 大致分为两种使用方式,即离线和在线.最简单的使用方式是使用GitBook Editor编纂GitBook,然后使用相关命令编译成功HTML.当然还有以下几种方式
gitBookEditor
使用客户端方式,支持在线和本地两种方式创建、编辑GitBook,再执行相关命令编译成HTML,这种方式比较方便,保举使用.以本地创建书籍为例
1、gitBookEditor客户端根本使用
2、使用命令对已经创立的Book进行编译
找到必要编译的书籍所在目录,执行gitbook serve 命令,在本电脑的默认路径为C:UsersQGYGitBookLibraryImportgitbooksimpletutorial,如图所示
高级扩展
掌握了“基本使用”,但有时候想要gitBook更美观,或者更符合我们本身的需求,则通过book.json配置进行自定义、以及安装一些常用的插件等.
Book.json配置
GitBook 在编译册本的时候会读取册本源码顶层目录中的 book.js 或者 book.json,这里以 book.json 为例,参考 GitBook 文档 可以知道,book.json 支持如下配置
?
{
//样式风格配置格式
"styles": {
"website": "styles/website.css","ebook": "styles/ebook.css","pdf": "styles/pdf.css","mobi": "styles/mobi.css","epub": "styles/epub.css"
},//插件安装配置格式
"plugins": ["myplugin"],"pluginsConfig": {
"myPlugin": {
"message": "Hello World"
}
}
}
自定义插件扩展
插件是扩展GitBook功能最好的办法.使得GitBook功能更加强大,例如,把数学公式显示支持,跟踪回访使用谷歌解析,…以toggle-chapters插件为例
toggle-chapters 插件的效果是默认只在目录导航中显示章的标题,而不会显示小节的标题,点击每一章或者每一节会显示当前章或节的子目录,如果有的话,但是同时会收起其它之前展开的章节.所以,个人认为不是非常实用,因为这样子用户不能快速跳转到没有展开的章节!
一、搜刮、安装插件方式
1、编纂器方式(没成功)
2、经由过程GitHub方式
www.plugins.gitbook.com
3、node.js敕令方式
?
C:UsersQGYAppDataRoamingnpmnode_modules
?
npm install gitbook-plugin-toggle-chapters
二、通过Book.json设置装备摆设插件
?
"plugins": ["toggle-chapters"],"pluginsConfig": {
"myPlugin": {
"message": "Hello World"
}
}
本文永远更新链接地址： 编程之家PHP培训学院每天发布《LINUX实操：Gitbook简易使用教程》等实战技能，PHP、MYSQL、LINUX、APP、JS,CSS全面培养人才。 （编辑：李大同）
【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!
|
