Gitbook从小白到熟练使用，看这里就好！

最新推荐文章于 2022-06-03 16:39:35 发布
最新推荐文章于 2022-06-03 16:39:35 发布
阅读量650 收藏 4
点赞数 2
分类专栏： gitbook 文章标签： git npm
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/starsky__/article/details/104366577
版权

前言

最近想找一个记笔记的软件，试了几款都觉得差点意思，后来看到别人用gitbook写的笔记就想试试，接触以后发现很多大佬讲的其实不适合我这种啥都不懂的人，于是我就想自己写一遍文章，再加上一直想写篇博客玩，于是就有了这篇，我的第一篇博客。

文章目录

Gitbook的安装

node.js的安装

gitbook是一个基于Node.js的命令行工具，所以要先安装Node.js(下载地址：https://nodejs.org/en/，找到对应平台的版本安装即可)。

Node.js都会默认安装npm（node包管理工具），所以不需要单独安装npm，打开命令行，执行以下命令安装GitBook:

npm install -g gitbook-cli

如果提示npm不是内部会外部命令，可以cd到node.js的安装目录在执行或将npm的目录添加到系统变量path中。

编辑工具的安装

这里给大家介绍两个编辑工具：gitbook editer和typora

gitbook editor

这个编辑工具对新手来说是个不错的选择，它集成了gitbook，git，Markdown等功能，可以将书籍同步到gitbook.com网站和github。但是gitbook editor的注册和登录需要翻墙，而且这东西的官网进不去，所以还下不到。

这里给大家分享一下这个工具，会翻墙的可以尝试一下这个工具

https://pan.baidu.com/s/1LEf2b9QwIRNgsoXJVBV90g

提取码：vtpv

typora

这个工具是我目前在使用的，推荐这个也没有啥特别的原因，就是我自己感觉挺好用的

下载地址:https://www.typora.io/

直接进官网下载对应平台的版本就可以了

Gitbook的使用

创建笔记文件夹

在你想要的位置新建一个文件夹，然后打开命令行，cd到这个文件夹下。

接着执行以下命令

gitbook init

执行完后，文件夹里会多两个文件
在这里插入图片描述

README.md（书籍的介绍在这个文件里）

SUMMARY.md（书籍的目录结构在这里配置）

写目录

后面我介绍了一个生成目录的插件，所以不一定要自己弄目录，但这里还是说下怎么写

上面说到SUMMRAY.md文件就是整个文件夹的目录，写目录其实就是编辑这个文件，刚打开时这个文件里什么都没有，我先在给他编写一下:
在这里插入图片描述

在给大家看看源代码

# Summary

* [Introduction](README.md)
* [前言](readme.md)
* [第一章](part1/README.md)
    * [第一节](part1/1.md)
    * [第二节](part1/2.md)
    * [第三节](part1/3.md)
    * [第四节](part1/4.md)
* [第二章](part2/README.md)
* [第三章](part3/README.md)
* [第四章](part4/README.md)

大家可以复制源代码过去试一下

简单给大家说一下语法：中括号里是这个目录的名字，小括号里是路径。

写完目录后再次执行gitbook init Gitbook会查找SUMMARY.md中描述的目录和文件，如果没有则会创建。上面的目录运行后是这样的
在这里插入图片描述

写笔记

在这里给大家介绍一些typora比较常用的功能

各级标题

在typora中使用crtl + 1~6可以创建1-6级标题，1级最大，6级最小。同时typora的大纲会显示所有标题，如图：
在这里插入图片描述

表格

可以在段落—>表格中插入表格，或者按快捷键crtl+T

代码块

这个功能用的很频繁，可以在段落—>代码块中插入，也可以使用快捷键(```+空格)

专注模式和打字机模式

打字机模式就是让当前输入行保持在屏幕中间，专注模式就是输入行正常颜色，其他行变灰，可以在视图中打开

源代码模式

源代码模式就是展示Markdown的文件本来的样子，如图
在这里插入图片描述

这个模式会展示出Markdown文件的标识符

插入图片

这个不多说，在格式—>图像里，快捷键crtl+shift+i

插入链接

用两个尖括号括起来就行，如下：

<www.baidu.com>
在这里插入图片描述

更换主题

直接点主题就好，typora内置了6个主题，值得一提的是typora的主题是css格式，所以会css的小伙伴可以自己写主题，或者调整已有的主题

内容目录

就是你们在本文上面看到的那个目录，简单点说就是把大纲放到了文章里，在段落—>内容目录里可以找到（有标题时才能用）

常见的格式

就比如加粗，斜体，下划线什么的。在格式里有，快捷键如下：
在这里插入图片描述

我的使用方法

其实单个md文件可以存储很多笔记，我现在是把一块笔记存在一个md文件里，有一定规模后再装文件夹，然后放在gitbook中，再使用我介绍的插件生成目录。

插件的使用方法

在gitbook中有很多有用的插件，但是使用起来会有一点麻烦，这里给大家讲解一下怎么用。

gitbook的插件大部分都在npm上，可以访问npm官网查看搜索插件https://www.npmjs.com/

这里用一个自动生成目录的插件给大家介绍使用方法

名字叫:gitbook-plugin-summary

  1. 首先打开你笔记文件夹下的book.json文件，没有就自己创建一个

  2. 将以下代码复制进去

    {
  "plugins": ["summary"]
}

  3. 打开命令行，在这个文件夹中执行命令gitbook install安装插件

  4. 执行命令gitbook serve然后在查看的时候就会发现，之前明明没有写目录，现在却有了目录

大家想要用别的插件可以直接去npm上找，都有使用方法的

生成电子书

写完后我们可以执行gitbook serve来预览这本书，执行后会把Markdown格式的文档转换为html格式，最后提示"Serving book on http://localhost:4000"此时用浏览器打开" http://localhost:4000"即可预览书本

如图：
在这里插入图片描述

执行完后你的笔记文件夹里会多一个_book文件夹，里面是转化后的html文件

笔记的同步

同步单个的md文件

对于单个的md文件，我建议同步到石墨文档，可以在网页版，桌面版，移动版三个版本上查看和编辑。操作方法就是打开然后带入就行了。当然，在博客上发布也不失为一种好的同步方法。

同步整个笔记文件

可以使用git同步到github，由于我对git不太熟悉，就不误导大家了，大家可以去网上找找

件夹，里面是转化后的html文件

笔记的同步

同步单个的md文件

对于单个的md文件，我建议同步到石墨文档，可以在网页版，桌面版，移动版三个版本上查看和编辑。操作方法就是打开然后带入就行了。当然，在博客上发布也不失为一种好的同步方法。

同步整个笔记文件

可以使用git同步到github，由于我对git不太熟悉，就不误导大家了，大家可以去网上找找

最后，这是我第一次写博客，而且我从接触gitbook到写完这篇博客只有短短三天，如果有哪里不对，请各位指正

Broken故城
关注
  • 2
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 3
    评论
专栏目录
gitbook-plugin-summary:Gitbook插件自动生成SUMMARY.md
08-04
gitbook-plugin-summary Gitbook插件自动生成SUMMARY.md 介绍 这个插件是出于无法从基本树结构自动生成SUMMARY.md文件的挫败感而创建的。 结果是你安装了这个插件，它就在你当前的book.json文件book.json 。 无需自定义配置。 安装 首先你需要使用安装包 $ npm i gitbook-plugin-summary --save 之后，您需要将插件添加到您的book.json中，如下所示 { " plugins " : [ " summary " ] } 最后运行命令 $ gitbook serve 规则 姓名 README.md ：取自他们的目录名 文件：取自文件的第一个标题（例如： # title ） 目录：目录名称 条目类型 gitbook 根目录 有了第一级自述文件，它将显示为普通链接 如果没有，它将显
gitbook-publish:从Github到gh-pages的自动gitbook发布
04-27
运行命令： 使用gitbook build 检出gh-pages分支删除gh-pages的先前版本从book文件夹中提取文件并将其放置在外部将新版本提交到gh-pages用法安装软件包： npm install gitbook-publish@latest 导航到包含您的...
GitBook 知识总结
louisgeek的专栏
04-08 366
GitBook 简介 https://www.gitbook.com 一个可以创建、书写、阅读电子书的网站 支持将 md 等格式文件导入形成电子书 提供 Gitbook CLI（Command Line Interface）工具，基于 Node.js Gitbook CLI 基于 Node.js 安装 node.js https://nodejs.org/en/download 由于在使用 gitbook 时候出现如下报错 gitbook init Error: TypeErr
如何用gitbook写书
余璜的技术博客
11-27 7750
假设你 已经知道如何编写Markdown 已经安装好gitbook软件 目标生成一本小书，它有前言，章节1，章节2，后记。例如：简介 第一章：如何造火箭 1. 燃料学 2. 空气动力学 3. 总装工程学 第二章：如何回收火箭 1. 自动控制原理 2. 二次利用要点 结束准备工作建一个写书的目录，以后所有工作都在这个目录下搞。例如/Users/rayw
gitbook 【插件】gitbook-summary
爱死亡机器人
01-21 1426
1.gitbook plugin summary Gitbook 插件：自动生成 summary.md 文件内容，如果有很多md文件，这个插件可以帮助你生成初始版本。 $ npm init This utility will walk you through creating a package.json file. It only covers the most common items, and tries to guess sensible defaults. See `npm help init.
GitBook-auto-summary 根据markdown 标题生成目录文件SUMMARY.md
爱死亡机器人
06-03 1635
我们了解 gitbook plugin summary 自动生成 summary.md 文件内容 这是命令依赖markdown文章名字组成目录结构的样子。 但我的需求是可以依据文章标题来生成整个结构，因为如果你有一批大量的markdown文章一个一个手写改动、添加、删除都是一件非常麻烦的事。我发现来自mofhu/GitBook-auto-summary的功能接近我的需求。 功能：但这离我渴望的需求还差一点点，那就是当文章内容存在标题，我更选择它来做链接名片，当不存在标题再去依赖文章名字（英文或中文）作为链接
jekyll-gitbook:用GitBook样式构建Jekyll网站！
05-23
为什么Jekyll使用GitBook GitBook是一种惊人的前端样式，用于在Web上呈现和组织内容（例如书中的章节和博客）。 在上部署GitBook的典型做法是在本地构建HTML文件，然后将其推送到Github存储库，通常是gh-pages分支...
gitbook安装过程中使用的软件.zip
05-15
本资源包用于gitbook安装过程中所需要使用的软件，包括:calibre-64bit-4.16.0.msi,node-v12.16.3-x64.msi,phantomjs-2.1.1-windows.zip。安装文档见http://mindh.gitee.io/gitbook/
gitbook-summary：用于为Gitbook生成summary.md的命令行工具
02-01
Gitbook摘要 的命令行工具来生成SUMMARY.MD从一个文件夹。 电子书 《 Nodejs区块链开发2》： : 《 Nodejs区块链开发》： : 《用Gitbook和Github轻松构建自出版平台》： : 《 sails.js官方文档多语言电子书》： : 更多Gitbooks： ://www.gitbook.com/@imfly 产品特点 通过使用带有某些选项的CLI生成SUMMARY.md 用book.json设置 将README.md链接到父目录 仅获取“ .md”文件 按字母或数字排序 ... CoC（配置公约） 源目录： sources ├── 1-FirstChapter // The first chapter，format: {orderNumber or alphabet}-{chapterName}.md ├────── 1-FirstDocument.md ├────── 5-SecondDocument.md // concentrating solely on the order, not the numbers. ├
gitbook SUMMARY.md
爱死亡机器人
06-03 958
GitBook默认使用SUMMARY.md文件实现目录结构的设定，在该文件中，可以通过缩进实现多级目录的效果，如： 但是有个问题：gitbook默认只支持两层的导航栏，在遇到内容比较多需要章节层次比较深时，很不方便。好在后来gitbook终于提供了多级导航栏的支持。 要实现一个多级的导入栏很简单，就改动两个地方：也可以通过使用标题或者水平线标识将GitBook目录分为几个不同的部分： 5. grunt 为了方便发布到github，我选择了使用grunt。同样为了支持多层导航栏，grunt相关的插件也需要使用
git仓库同步到GitHub中的完整流程及Summary
lixiuxiu2017的博客
03-22 1993
1、把git仓库中的文件推送到GitHub中的完整流程（1）先把本地要上传的所有文件夹及文件都添加到git仓库中首先进入到放置所有要上传的文件及文件夹的目录下，单击右键选择“git bash”进入git命令行，然后初始化git仓库、添加到暂存区、提交岛git仓库中，如下图所示：  （2）再把本地仓库master分支上的所有文件都推送到GitHub远程仓库origin对应的master分支中先远程添...
如何写一篇英文文章的Summary？
Algorithmguy的专栏
09-28 1万+
摘要是对一篇文章的主题思想的简单陈述。它用最简洁的语言概括了原文的主题。写摘要主要包括三个步骤：（1）阅读；（2）写作；（3）修改成文。        第一步：阅读 A．认真阅读给定的原文材料。如果一遍不能理解，就多读两遍。阅读次数越多，你对原文的理解就越深刻。 B．给摘要起一个标题。用那些能概括文章主题思想的单词、短语或短句子作为标题。也可以采用文中的主题句作为标题。主题句往往
gitbook入门详解
weixin_34259232的博客
11-23 322
gitbook入门详解 在ata上面看了几篇关于gitbook的文章，感觉都是适合之前已经了解过gitbook的同学来学习的，是跳跃式的，说得比较简略，省略了中间的一部分步骤，这并不适合零基础的新人，于是下面向新人详细介绍gitbook。 说到gitbook，很容易联想到git和github，那么它们究竟有什么关系呢？ 其实就是java跟javascri...
GitBook 从懵逼到入门
热门推荐
人人都懂物联网
07-18 16万+
　　本文从 “是什么”、“为什么”、“怎么办”、“好不好” 四个维度来介绍 GitBook，带你从黑暗之中走出来，get 这种美妙的写作方式。 是什么？ 　　在我认识 GitBook 之前，我已经在使用 Git 了，毋容置疑，Git 是目前世界上最先进的分布式版本控制系统。 　　我认为 Git 不仅是程序员管理代码的工具，它的分布式协作方式同样适用于很多场合，其中一个就是写作（这会是一个...
GitBook目录语法
测试
06-28 3966
目录 GitBook目录页1. 目录页2. 注意事项 GitBook目录页 1. 目录页 SUMMARY.md就是各个页面的链接总和。 示例： # Summary ### Part I * [Writing is nice](part1/writing.md#wr...
四. GitBook 使用入门
毕小烦的学习笔记
05-21 1万+
GitBook 是一个基于 Node.js 开发的命令行工具，使用它可以很方便的管理电子书，GitBook 是目前最流行的开源书籍写作方案。使用 GitBook 可以让创作者专注写作，自由的挥洒，不必太多的关心内容排版、发布和版本管理等问题。除了通过 GitBook 命令行管理电子书外，还可以在线（gitbook.com）或者使用桌面编辑器 GitBook Editor
手把手教你GitBook使用
AI悦创·编程私教1v1
10-10 5495
你好，我是悦创。 详细的记录了一步步搭建自己的电子文档笔记 1. 环境搭建 1.1 安装 Nodejs 大佬级别直接看下面这句话，就没啥问题： 这个安装很简单，只需要下载，然后一路 next 即可。下载链接：https://nodejs.org/en/ 小白继续看看下来： 用于所有主流平台的官方软件包，可访问 http://nodejs.cn/download/ 安装 Node.js 的其中一种非常便捷的方式是通过软件包管理器。 对于这种情况，每种操作系统都有其自身的软件包管理器。 在 macOS 上，
gitbook使用教程
最新发布
04-29
GitBook 是一个基于 Git 和 Markdown 的文档编辑和发布工具，可以用于创建在线文档、电子书和教程等等。下面是 GitBook 的使用教程： 1. 安装 GitBook 首先，你需要在你的电脑上安装 GitBook。你可以在 GitBook 官网上下载并安装 GitBook Desktop，或者使用命令行安装： ```bash npm install gitbook-cli -g ``` 2. 创建 GitBook 项目 在你的电脑上创建一个文件夹，然后在该文件夹下使用命令行创建一个 GitBook 项目： ```bash gitbook init ``` 这个命令会创建一个默认的 GitBook 项目结构，包括 README.md、SUMMARY.md 和 book.json 文件。 3. 编写文档 在你的 GitBook 项目文件夹下创建和编辑 Markdown 文件，这些文件将会组成你的在线文档。 4. 预览文档 使用下面的命令在本地预览你的 GitBook 项目： ```bash gitbook serve ``` 这个命令将会启动一个本地服务器，在浏览器中打开 http://localhost:4000 就可以预览你的 GitBook 项目了。 5. 发布文档 你可以使用 GitBook 官网提供的服务将你的 GitBook 项目发布为在线文档，也可以将你的 GitBook 项目发布到 GitHub Pages 或者其他网站。 具体操作可以参考 GitBook 官方文档。
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值