博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
gitbook配置
阅读量:5234 次
发布时间:2019-06-14

本文共 1571 字,大约阅读时间需要 5 分钟。

一、是什么

明确一点Git 与 GitBook 就像雷锋和雷峰塔完全没有一点关系。

GitBook 是 一 个 基 于 Node.js 的 命 令 行 工 具 , 支 持 Markdown 和 AsciiDoc 两种语法格式,可以输出 HTML、PDF、eBook等格式的电 子书。所以我更喜欢把 GitBook 定义为文档格式转换工具。目前使用的搭配是 GitBook + Typora + Git。

 

二、如何搭建 GitBook 环境?

因为GitBook 是基于 Node.js,所以我们首先需要安装 Node.js

1、安装 Node.js 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

LTS 版本是一个支持 NodeJS 老版本特性的特殊新版本,Current 版本属于

 

 

一个全新的新版本。如果你的NodeJS 应用使用的比较老的 SDK 开发,LTS 版

 

本能让你平滑升级到新版本。

 

如果你的NdoeJS 应用使用的是全新的 SDK 开发选择 Current 版本即可。

 

 

 

 

 

2windows 安装

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

安装结束之后使用cmd 控制台输入node -v 出现版本号则成功、

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

如果命令无法找到。则需要配置环境变量。

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1、配置环境变量

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

node.js 的路径加入环境变量,重启控制台重新输出 node -v 即可

 

 

4mac 安装

 

 

1、双击安装程序安装

 

 

如下:

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

2、显示程序将会安装的位置

 

 

一直点击继续到最后为

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

3、在终端中输入命令

 

 

 

node –v

 

npm –v

 

如下:

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

若展示如上说明node 安装成功

 

 

 

 

 

 

4、若 node-v 提示为失败

 

 

- bash: node: command not found

 

需要配置环境变量了步骤如下

 

进入finder 右键选择”前往文件夹”如下

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

进入etc

 

 

 

 

 

 

 

 

 

 

 

 

 

 

文件夹中找到“profile”文件,此文件锁定可以复制一份出来加上以下语句: export NODE_HOME=" node 安装路径(bin 路径的父级路径)" export PATH=$PATH:$NODE_HOME/bin

 

步骤2 中已有 node 安装路径为/usr/local/bin/node所以我自己这边增加语句如下:

 

export NODE_HOME="/usr/local" export PATH=$PATH:$NODE_HOME/bin

 

ps:( 如果不记得 node 的安装路径,可以打开终端,输入 which node

 

即可找出node 安装路径 )

 

改完profile 副本文件保存为不带后缀的文件,名字亦为profile 即可覆盖原来的 profile,环境变量配置好了就可以按照步骤 3 来验证了。

 

 

 

 

 

2、安装 gitBook

 

 

 

 

打开命令行,执行npm install -g gitbook-cli

 

 

 

 

 

 

 

 

Gitbook-cli 不能有空格

 

 

 

 

安装完成

 

 

 

 

 

 

 

 

检验:

 

Gitbook -v

 

无错误即可

 

 

 

 

 

 

 

 

三、GitBook 如何使用

 

 

1、配置

 

 

1、创建一个文件夹名为 mybook(名字可以随便取)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

2、在控制台上找到这个文件夹并输入gitbook init

 

 

 

 

 

 

 

 

 

安装成功之后,目录下会出现两个文件。

 

 

 

 

 

 

 

 

 

 

 

 

 

 

3、将此文件夹拖拽到 VSCode 中就可以进行吧编辑

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

SUMMARY.md 为目录超链接文档,语法格式为:markdown 格式。

 

小括号内为超链接

 

 

 

 

4、点击此按钮为预览

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

5、编辑成功之后再 cmd 中运行 gitbook serve

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

浏览器访问如上地址

 

 

 

 

6、如果遇到如下问题

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

请关闭杀毒软件别问我为什么

 

 

 

 

运行成功之后为

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

7、如果要写文档则需要新建一个 .md 文档将其路径添加到对应的

 

SUMMARY.md 的超链接中

 

 

2、未完待续

3、修改配置

1)修改标题

 

转载于:https://www.cnblogs.com/ranyihang/p/10760788.html

你可能感兴趣的文章
游戏偶感
查看>>
Leetcode: Unique Binary Search Trees II
查看>>
C++ FFLIB 之FFDB: 使用 Mysql&Sqlite 实现CRUD
查看>>
Spring-hibernate整合
查看>>
c++ map
查看>>
exit和return的区别
查看>>
discuz 常用脚本格式化数据
查看>>
洛谷P2777
查看>>
PHPStorm2017设置字体与设置浏览器访问
查看>>
SQL查询总结 - wanglei
查看>>
安装cocoa pods时出现Operation not permitted - /usr/bin/xcodeproj的问题
查看>>
GIT笔记:将项目发布到码云
查看>>
JavaScript:学习笔记(7)——VAR、LET、CONST三种变量声明的区别
查看>>
JavaScript 鸭子模型
查看>>
SQL Server 如何查询表定义的列和索引信息
查看>>
GCD 之线程死锁
查看>>
NoSQL数据库常见分类
查看>>
一题多解 之 Bat
查看>>
Java 内部类
查看>>
{面试题7: 使用两个队列实现一个栈}
查看>>