自游客

  • 首页
  • 程序园
  • 游记 | 读书
    • 读书
    • 游记
  • 工具
  • 活动&资源
  • 友链
  • 留言板
  • 关于我们
Kratos
一款专注于用户阅读体验的响应式博客主题
  1. 首页
  2. 效率工具
  3. 正文

Gitbook安装与使用

2016年11月27日 33134点热度 0人点赞 0条评论

GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书。

目录

  • 1 1、安装
  • 2 2、初始化gitbook
  • 3 3、编辑内容,并查看
  • 4 4、发布电子书gitbook官网
  • 5 5、导出电子书
  • 6 总结
  • 7 参考:

在这篇博客中,记录了一下gitbook的安装使用,更详细的使用请查看下面内容:
gitbook详细使用文档:help.gitbook.com
gitbook官网:https://www.gitbook.com
github地址:https://github.com/GitbookIO/gitbook

1、安装

首先到nodejs下载,安装Node.js的包管理器npm。
然后,通过sudo npm install -g gitbook-cli命令安装gitbook

2、初始化gitbook

创建一个文件夹,然后初始化

mkdir test
gitbook init

初始化之后会有两个文件README.md和SUMMARY.md,README.md 是作品的介绍,SUMMARY.md 是作品的目录结构,里面要包含一个章节标题和文件索引的列表。

下面是一个SUMMARY.md文件的内容:

# Summary

This is the summary of my book.

* [section 1](section1/README.md)
    * [example 1](section1/example1.md)
    * [example 2](section1/example2.md)
* [section 2](section2/README.md)
    * [example 1](section2/example1.md)

在这里,我们可以先创建对应的文件夹,然后在里面编辑对应的内容,之后更新SUMMARY.md这个目录文件;如果在编辑之前我们已经确定好了内容标题和目录,也可以先编辑SUMMARY.md文件,然后通过gitbook init来初始化一遍,它会自动创建文件目录和对应的md文件。

3、编辑内容,并查看

初始化书以后,我们就可以对我们的内容进行编辑了。
例如:
我要将本篇博客放入目录为gitbook下,首先在test目录建立一个gitbook文件夹,然后建立一个gitbook安装使用.md文件,目录如下:

|____gitbook
| |____gitbook安装使用.md
|____README.md
|____section1
| |____example1.md
| |____example2.md
| |____README.md
| |____test.md
|____section2
| |____example1.md
| |____README.md
|____SUMMARY.md

之后,我们像写博客一样,使用markdown语言编辑gitbook安装使用.md中的内容。
编辑完之后,需要将gitbook安装使用.md这篇文章放入SUMMARY.md目录中。

# Summary
* [gitbook]
    * [gitbook安装使用](gitbook/gitbook安装使用.md)
* [section 1](section1/README.md)
    * [example 1](section1/example1.md)
    * [example 2](section1/example2.md)
* [section 2](section2/README.md)

这样,就加入了gitbook安装使用.md这篇文章。之后,可以使用下面命令启动一个本地web服务,来预览本地的内容。

gitbook serve

这个时候,简洁、优雅的界面就出来了。

注意:

  • 在查看的时候没有看到刚刚加入的文章,查看一下SUMMARY.md是否添加
  • 在预览的时候能看到文章,但是点击不起作用,查看是否目录正确

如果想将gitbook放到web服务器作为网站浏览,先使用gitbook build命令,之后会生成静态网页到_book目录下,只要将_book目录copy到web服务器上就行了。

4、发布电子书gitbook官网

到gitbook官网创建一个账号,创建一本test电子书,创建电子书的时候,gitbook会创建git仓库https://git.gitbook.liuchungui/test.git。

然后下载gitbook editor,登陆账号,将电子书clone一份下来,将前面新建电子书将前面编辑的内容拖到这个电子书下,然后同步到官网就可以看到内容了,例如我的test。

上面的操作我们也可以用命令行进行操作。先在官网建立一个电子书,然后clone下来,之后编写我们的电子书内容和目录,然后使用git命令将内容Push到git仓库就行了。

5、导出电子书

其实,上面建立的test已经在官网上可以进行电子书下载了,有三种格式PDF、EPUB、MOBI。
而在本地,使用下面命令导出

pdf [options] [source_dir] 构建 pdf 格式的电子书
epub [options] [source_dir] 构建 ePub 格式的电子书
mobi [options] [source_dir] 构建 mobi 格式的电子书

如果导出失败,需要我们下载Calibre进行电子书转换。

###gitbook的相关命令

build [options] [source_dir] 根据文档目录构建书籍
serve [options] [source_dir] 构建并且提供书籍的 web 托管
install [options] [source_dir] 安装 GitBook 插件
pdf [options] [source_dir] 构建 pdf 格式的电子书
epub [options] [source_dir] 构建 ePub 格式的电子书
mobi [options] [source_dir] 构建 mobi 格式的电子书
init [source_dir]      根据 SUMARRY.md 文件的内容生成相应的目录和文件
publish [source_dir]   如果已绑定 GitBook.io,该命令可以直接发布书籍

-h, --help     输出命令的使用说明
-V, --version  输出程序的版本号

总结

gitbook操作其实就分为两个方面内容,一个是建立git仓库对内容进行管理,另外一个就是使用markdown对内容进行编辑,然后使用SUMARRY.md生成书的目录。
而gitbook这么优雅大方的页面,我们喜欢的话,完全可以将它做成我们的技术博客。而它还具有简单标题检索功能,我甚至想过将它做成一个api接口管理页面。

参考:

Gitbook 的使用和常用插件
Mac下GitBook制作电子书
使用GitBook

标签: Gitbook
最后更新:2020年10月10日

hosea

这个人很懒,什么都没留下

点赞
< 上一篇
下一篇 >

文章评论

取消回复

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据。

hosea

这个人很懒,什么都没留下

文章目录
  • 1、安装
  • 2、初始化gitbook
  • 3、编辑内容,并查看
  • 4、发布电子书gitbook官网
  • 5、导出电子书
  • 总结
  • 参考:
最新 热点 随机
最新 热点 随机
我的数据与服务 ubuntu下基于php和dnspod的ddns(包含ipv4和ipv6) 如何在 ubuntu 20.04上安装 kvm ubuntu 安裝 Transmission ubuntu 安装 MQTT 服务 Ubuntu CPU压力测试
深度学习 chapter 1 ubuntu 安装r8168 网卡驱动 在Ubuntu中挂载BitLocker加密的磁盘 Redis 和 Memcached 的区别 Android 源码编译运行指南(清华aosp) ubuntu 耳机没有声音
标签聚合
Android 深度学习 程序员 MySQL 数据库 google 工具 ubuntu
3,614条垃圾评论已被Akismet阻挡
书签
  • 极客技术分享 极客技术分享

COPYRIGHT © 2022 自游客. ALL RIGHTS RESERVED.

Theme Kratos Made By Seaton Jiang