GitBook学习入门教程
一、Gitbook介绍
GitBook 并非关于 [Git]的教程,GitBook 是一个基于 Node.js 的命令行工具,支持 Markdown 和 AsciiDoc 两种语法格式,使用它可以输出 HTML、PDF、eBook 等格式来制作精美的电子书。
Gitbook 使用方案:
- GitBook + Typora / Vscode+ Git:推荐
- GitBook + Gitbook Editor+ Git
GitBook + Markdown + Git
优点:
- 语法简单
- 兼容性强
- 导出方便
- 专注内容
- 团队协作
注:本文使用搭配:GitBook + Typora + Git
使用GitBook需要依赖 Node.js和Git,Node.js 和 Git 安装都很简单,这里就不再赘述,
相关下载链接如下,大家自行下载安装即可:
- Node.js
- Git
- Typora
二、Gitbook 安装及使用
在已经安装node.js环境的前提下,使用以下命令安装gitbook:
npm install -g gitbook-cli
安装好之后,Node.js的安装目录下,会多了一个 gitbook 命令
现在来初始化一本书:
cd F:
mkdir mybook
cd mybook
gitbook init # 初始化
执行完毕会发现 mybook 目录中多了两个文件:
- README.md:书籍介绍
- SUMMARY.md:书籍目录结构
用 Typora 打开 SUMMARY.md,编辑如下(此步是编写书籍目录):
# 目录* [前言](README.md)* [第1节:HTML 简介](HTML/intro.md)* [第2节:URL 简介](HTML/url.md)* [第3节:元素的属性](HTML/attribute.md)* [第4节:字符编码](HTML/encode.md)* [第5节:语义结构](HTML/semantic.md)* [第6节:文本标签](HTML/text.md)* [第7节:列表标签](HTML/list.md)* [第8节:图像标签](HTML/image.md)* [第9节:链接标签](HTML/link.md)* [第11节:多媒体标签](HTML/multimedia.md)* [第11节: iframe标签](HTML/iframe.md)* [第12节:表格标签](HTML/table.md)* [第13节:表单标签](HTML/form.md)* [第14节:其他标签](HTML/elements.md)
再执行 gitbook init,gitbook 就会自动创建相应章节,如下图所示:
执行以下命令可以生成 HTML 静态文件,然后在浏览器中查看:
gitbook serve
在浏览器中访问:
http://localhost:4000/
配置
所有的配置都以JSON格式存储在名为 gitbook.json
的文件中。
字段
gitbook
{ "gitbook": ">=2.0.0" }
这个选项是用来探测用来生成书本的GitBook的版本的。格式是一个 SEMVER 条件。
在 gitbook.com 中,这个值是根据平台中输入的标题定义的。
description
{ "description": "This is such a great book!" }
这个选项定义了书本的描述,默认是从 README(第一段)中提取的。
在 gitbook.com 中,这个值是根据平台输入的描述定义的。
isbn
{ "isbn": "978-3-16-148410-0" }
这个选项定义了你书本的ISBN。
language
{ "language": "fr" }
这个选项定义了你书本的语言,默认值是 en
。
这个值是用来做国际化和本地化的,它改变网站的文字。
在 gitbook.com 中,这个值是根据探测到的语言或指定的设置定义的。
direction
{ "direction": "rtl" }
这个选项是用来重新设置语言的文字方向的。建议将 language
字段设置为带有正确的文字方向的语言。
styles
这个选项是用来自定义书本的css的。
例子:
{"styles": {"website": "styles/website.css","ebook": "styles/ebook.css","pdf": "styles/pdf.css","mobi": "styles/mobi.css","epub": "styles/epub.css"}
}
plugins
{ "plugins": ["mathjax"] }
书本使用的插件列表被定义在 book.json
的配置中。
pluginsConfig
{"plugins": ["myplugin"],"pluginsConfig": {"myPlugin": {"message": "Hello World"}}
}
structure
这个选项是用来覆盖GitBook使用的路径的。
例如你想要使用 INTRO.md
代替 README.md
:
{"structure": {"readme": "INTRO.md"}
}
variables
{"variables": {"myTest": "Hello World"}
}
这个选项定义在 模板 中使用的变量值。
三、常用命令
# 构建书籍,默认将生成的静态网站输出到 _book 目录
gitbook build# 指定路径
gitbook build [书籍路径] [输出路径]# 指定端口
gitbook serve --port 2333# 你还可以生成 PDF 格式的电子书
gitbook pdf ./ ./mybook.pdf
gitbook epub ./ ./mybook.epub # epub 格式
gitbook mobi ./ ./mybook.mobi # mobi 格式
其他命令:
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 //输出错误信息
GitBook学习入门教程相关推荐
- 深度学习入门教程UFLDL学习实验笔记三:主成分分析PCA与白化whitening
深度学习入门教程UFLDL学习实验笔记三:主成分分析PCA与白化whitening 主成分分析与白化是在做深度学习训练时最常见的两种预处理的方法,主成分分析是一种我们用的很多的降维的一种手段,通 ...
- 深度学习入门教程UFLDL学习实验笔记一:稀疏自编码器
深度学习入门教程UFLDL学习实验笔记一:稀疏自编码器 UFLDL即(unsupervised feature learning & deep learning).这是斯坦福网站上的一篇 ...
- caffe linux 教程,Caffe 深度学习入门教程 - 安装配置Ubuntu14.04+CUDA7.5+Caffe+cuDNN_Linux教程_Linux公社-Linux系统门户网站...
安装配置Ubuntu14.04+CUDA7.5+Caffe+cuDNN 一.版本 Linux系统:Ubuntu 14.04 (64位) 显卡:Nvidia K20c cuda: cuda_7.5.18 ...
- jsx 调用php,JavaScript_JavaScript的React框架中的JSX语法学习入门教程,什么是JSX?
在用React写组件的 - phpStudy...
JavaScript的React框架中的JSX语法学习入门教程 什么是JSX? 在用React写组件的时候,通常会用到JSX语法,粗看上去,像是在Javascript代码里直接写起了XML标签,实质上 ...
- 转g代码教程_图深度学习入门教程(九)——图滤波神经网络模型
本教程是一个系列免费教程,争取每月更新2到4篇.(由于精力有限,近期停止了一段时间,在此向大家道个歉). 主要是基于图深度学习的入门内容.讲述最基本的基础知识,其中包括深度学习.数学.图神经网络等相关 ...
- Michael Nielsen的神经网络与深度学习入门教程
Michael Nielsen的神经网络与深度学习入门教程 作者:Michael Nielsen 这是我个人以为目前最好的神经网络与机器学习入门资料.作者以MNIST为例详细介绍了神经网络中的基本 ...
- 强化学习入门教程(附学习大纲)
零基础,想要入门或从事强化学习研究的同学有福了! CSDN学院特邀资深讲师为大家分享<强化学习深入浅出完全教程>从零基础开始入门强化学习,在教学的过程中,配合 具体案例.代码演示 , ...
- python3爬虫入门教程-Python3爬虫学习入门教程
本文实例讲述了Python3爬虫相关入门知识.分享给大家供大家参考,具体如下: 在网上看到大多数爬虫教程都是Python2的,但Python3才是未来的趋势,许多初学者看了Python2的教程学Pyt ...
- 图深度学习入门教程(六)——注意力机制与图注意力
深度学习还没学完,怎么图深度学习又来了?别怕,这里有份系统教程,可以将0基础的你直接送到图深度学习.还会定期更新哦. 主要是基于图深度学习的入门内容.讲述最基本的基础知识,其中包括深度学习.数学.图神 ...
最新文章
- [征询意见][投票]先集中力量做好一个开源项目
- python简单程序代码-有那些用python修改python程序代码的简单方法?
- AdaBoost人脸检测原理
- python动态语言解释_python是动态语言吗
- maile:教你程序员怎么发邮件
- 我的ASP.NET AJAX控件——PopupNotificationExtender:实现OWA或Messenger样式的信息提示窗口...
- CTF-MISC杂项题1
- 推特超2K赞,DeepMind强化学习综述:她可以很快,但快从慢中来
- 006 认识BeanNameAware
- Linux基本信息查看命令
- Linux 64位的操作系统版本,查看cpu 以及linux和windows系统是32为还是64位?+查看操作系统版本...
- 329.矩阵中的最长递增路径
- Tomcat免安装版+Eclipse配置
- html常用js统计图表插件
- 桌面计算机快捷打不开,桌面快捷方式打不开怎么办【解决方法】
- 关于企业高校相关重要电气设备漏电保护方式的探究
- python如何赚外快 淘宝_Python如何爬取淘宝MM呢?教你一招
- USB over Network通过本地网络或 Internet 共享的远程 USB 设备
- 【哲理】你的上限是什么?如何打破上限?-莫安迪
- ubuntu22.04 安装ROS2
热门文章
- 《反精益创业》第二章
- 西门子PLC编程,西门子PLC远程下载
- 桌面怎样同步计算机,电脑桌面记事本如何同步到手机上
- mac编码查看及修改
- 计算机电子电路原理图,学看电路原理图入门知识积累
- mysql8的load data_mysql8.0 使用LOAD DATA LOCAL INFILE 批量插入数据
- mysql 查询前面显示序号1 2 3 4 5 ......等
- c语言读word,C语言实用读取word文档的方法
- 解决printe spooler服务自动关闭、无法添加打印机等(工作中经常碰到)
- WhatsApp受众画像概述