gitbook 入门教程之环境要求
gitbook
是基于 node.js
的命令行工具,首先需要安装并配置好 node.js
环境,然后才能安装gitbook
相关工具.
由于安装工具全部都是国外网站,因此速度可能会很慢,也可能需要FQ,请耐心等待或者学会科学上网.
当然如果安装过程中遇到任何问题,也可以找我要一下安装包或者我帮你免费解决下.
环境预检查
检查 git
环境[可选]
git
是免费开源的分布式版本控制系统,主要用于电子书的更新管理和团队协作,如果不需要将电子书托管到github
网站上,则可以不安装 git
.
如果打印出 git
版本信息,则表示本机已安装 git
环境,跳过此步骤.
$ git --version
git
安装配置教程请参考初识 git
检查 node.js
环境[必须]
node.js
是 js
在服务端运行的环境基础,从而使得 js
从浏览器端延伸到服务端领域,而 gitbook
则是运行在 node.js
基础之上的命令行工具,因此必须先安装好 node.js
开发环境.
如果打印出 node.js
版本信息,则表示本机已安装 node.js
环境,跳过此步骤.
$ node -v
node.js
安装配置教程请参考 https://nodejs.org/
检查 gitbook
环境[必须]
gitbook-cli
是 gitbook
的脚手架工具,帮助我们更方便构建 gitbook
应用,当然也可以直接安装 gitbook
,只不过那样的话,略显麻烦,不推荐.
如果打印出 gitbook
和 cli
版本信息,则表示本机已安装 gitbook
环境,跳过此步骤.
$ gitbook -V
否则的话,本机可能并没有安装 gitbook
环境,则需要安装 gitbook
相关工具.
因为 gitbook
是基于 node.js
环境,而安装好 node.js
后默认提供了 npm
包管理工具,而我们则是通过 npm
来安装其他工具.
安装 gitbook-cli
工具[必须]
假设你已经搭建好 node.js
环境,现在我们开始安装 gitbook
相关工具了!
$ sudo npm install -g gitbook-cli
全局安装的话,可能需要超级管理员权限,输入下相应密码即可继续安装,如无报错,则表示安装成功.
安装成功后会带有 gitbook
命令,现在再次运行下 gitbook -V
查看版本信息.
# 打印出 `CLI` 和 `GitBook` 版本信息即可,安装版本可能已经大于 `2.3.2`
$ gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3
$
安装 GitBook Editor
编辑器[可选]
gitbook
官方客户端编辑器,支持 windows
, mac
和 linux
,主要用于可视化编辑文档,组织文档结构.
下载相应平台的 GitBook Editor,正常安装即可.
gitbook
的使用方法大致可以有三种,而 GitBook Editor
编辑器只是其中一种,所以这一步是可选的.
- 使用
gitbook-cli
脚手架提供的各种命令直接在命令行管理gitbook
,适合一定编程经验的软件从业人员. - 使用
GitBook Editor
编辑器管理gitbook
,适合无任何编程的文学创作者. - 使用
gitbook.com
官网在线管理gitbook
,适合不具备本地开发环境的萌新体验者.
小结
gitbook
基于 node.js
开发环境,因此首先要安装好 nodejs 环境,其次再使用 node.js
提供的 npm
包管理工具来安装 gitbook
.
只需运行 sudo npm install -g gitbook-cli
即可安装,接着运行 gitbook -V
查看安装版本信息确认已经安装成功.
至此 gitbook
的必要开发环境已经准备妥当,接下来让我们赶紧体验一下 gitbook
的魅力吧!
gitbook 入门教程之环境要求的更多相关文章
- gitbook 入门教程之小白都能看懂的 Gitbook 插件开发全流程
什么是插件 Gitbook 插件是扩展 GitBook 功能(电子书和网站)的最佳方式. 只要是 Gitbook 默认没有提供的功能,基于插件机制都可以自行扩展,是插件让 Gitbook 变得更加强大 ...
- gitbook 入门教程之从零到壹发布自己的插件
什么是插件 Gitbook 插件是扩展 Gitbook 功能的最佳方式,如果 Gitbook 没有想要的功能或者说网络上也没有现成的解决方案时,那么只剩下自食其力这条道路,让我们一起来自力更生开发插件 ...
- gitbook 入门教程之前置知识
markdown 基本知识 markdown 是一种简化的 html 语法,相比于 txt 无格式文本更强大. 你可以用专门的软件去编辑 markdown 文件,就像需要使用软件编辑 txt 文件一样 ...
- gitbook 入门教程之使用 gitbook.com 在线开发电子书
gitbook 官网是官方提供的图书托管的在线平台,分为新版官网(需要FQ) https://www.gitbook.com/ 和旧版官网(无需FQ) https://legacy.gitbook.c ...
- gitbook 入门教程之使用 gitbook-cli 开发电子书
gitbook 生成电子书主要有三种方式: gitbook-cli 命令行操作,简洁高效,适合从事软件开发的相关人员. gitbook-editor 编辑器操作,可视化编辑,适合无编程经验的文学创作者 ...
- Linux pwn入门教程(0)——环境配置
作者:Tangerine@SAINTSEC 0×00前言 作为一个毕业一年多的辣鸡CTF选手,一直苦于pwn题目的入门难,入了门更难的问题.本来网上关于pwn的资料就比较零散,而且经常会碰到师傅们堪比 ...
- gitbook 入门教程之快速体验
本文主要介绍三种使用 gitbook 的方式,分别是 gitbook 命令行工具,Gitbook Editor 官方编辑器和 gitbook.com 官网. 总体来说,三种途径适合各自不同的人群,找到 ...
- gitbook 入门教程之发布电子书
输出目标文件 语法格式: gitbook build [book] [output] 默认情况下,gitbook 输出方式是静态网站,其实 gitbook 的输出方式有三种: website, jso ...
- gitbook 入门教程之导出电子书
gitbook 既可以将源码文件单独输出,也可以仅输出单个文件,常见的导出电子书格式主要有三种(ePub, Mobi, PDF),而这三种格式都依赖于系统本身提供的 ebook-convert 工具. ...
随机推荐
- vue技术分享-你可能不知道的7个秘密
前言 本文是vue源码贡献值Chris Fritz在公共场合的一场分享,觉得分享里面有不少东西值得借鉴,虽然有些内容我在工作中也是这么做的,还是把大神的ppt在这里翻译一下,希望给朋友带来一些帮助. ...
- dubbo实现原理简单介绍
一.什么是dubbo Dubbo是Alibaba开源的分布式服务框架,它最大的特点是按照分层的方式来架构,使用这种方式可以使各个层之间解耦合(或者最大限度地松耦合).从服务模型的角度来看, ...
- SpringBoot拦截器中Bean无法注入(转)
问题 这两天遇到SpringBoot拦截器中Bean无法注入问题.下面介绍我的思考过程和解决过程: 1.由于其他bean在service,controller层注入一点问题也没有,开始根本没意识到Be ...
- Ubuntu软件中心的完全启用
新安装的Ubuntu英文版如果不做配置是无法使用Ubuntu软件中心下载或安装软件的,本文就简单介绍一下安装完Ubuntu后该做哪些配置才能完全启用Ubuntu软件中心. 安装完Ubuntu后我们要对 ...
- matplotlib简单的使用(二)
1.折线图 import matplotlib as mlb from matplotlib import pylab as pl # 折线图 # 分别创建x,y坐标 x = [1,3,5,7,6,9 ...
- 利用 ssh 的用户配置文件 config 管理 ssh 会话
http://dhq.me/use-ssh-config-manage-ssh-session 利用 ssh 连接远程服务器,一般都要输入以下类似命令: 1 ssh user@hostname -p ...
- infolite(中文检索系统)~爬虫利器
infolite 今天为大家分享一个爬虫利器-infolite.这是一个chrome浏览器的插件,如果你在写爬虫的时候对复杂繁琐的控件路径分析是深恶痛绝.那么infolite绝对是你最好的选择. 安装 ...
- 【双连通分量】Bzoj2730 HNOI2012 矿场搭建
Description 煤矿工地可以看成是由隧道连接挖煤点组成的无向图.为安全起见,希望在工地发生事故时所有挖煤点的工人都能有一条出路逃到救援出口处.于是矿主决定在某些挖煤点设立救援出口,使得无论哪一 ...
- bzoj 2724 蒲公英 分块
分块,预处理出每两个块范围内的众数,然后在暴力枚举块外的进行比较 那么怎么知道每一个数出现的次数呢?离散后,对于每一个数,维护一个动态数组就好了 #include<cstdio> #inc ...
- BZOJ_3316_JC loves Mkk_ 二分答案 + 单调队列
BZOJ_3316_JC loves Mkk_ 二分答案 + 单调队列 题意: 分析: 拆成链,二分答案,奇偶两个单调队列维护最大子段和,记录方案. 代码: #include <cstdio&g ...