GitBook 使用

作者: 吴小龙同學 | 来源:发表于2017-09-06 22:33 被阅读587次

我想把我的博客总结归纳下,于是找到了 GitBook,多了一个写博客地方,我把它做为博客的备份。花了两三天学习了 GitBook,这里记录下。此教程基于 Mac,Windows 也差不多适用。

安装 Node.js

GitBook 是基于 Node.js 的命令行工具,下载安装 Node.js

检测安装是否成功:

$ node -v
v6.11.0

Gitbook 安装

Gitbook 是用 npm 安装的,命令行:

$ npm install -g gitbook-cli

检测安装是否成功:

$ gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3

更新最新版本:

$ gitbook update

卸载:

$ npm uninstall -g gitbook

GitBook Editor

官方编辑器,下载 https://www.gitbook.com/editor ,大概如图:

关于 GitBook Editor 怎么使用和注册 GitBook 等步骤较简单,这里略。

插件

book.json

新建一个 book.json 文件,可以配置网站信息、在 plugins 和 pluginsConfig 字段添加插件等。

插件命名方式为:

gitbook-plugin-X: 插件;

gitbook-theme-X: 主题。

可以在 npmjsGitBook 插件 直接搜索插件或者主题。
book.json 内容大概如下:

{
"gitbook": "3.2.3",
"title": "吴小龙同學",
"description": "http://wuxiaolong.me/",
"author": "WuXiaolong",
"language": "zh-hans",
"links": {
"sidebar": {

}
},
"plugins": ["github",
"donate",
"splitter",
"anchor-navigation-ex",
"-sharing",
"sharing-plus",
"-highlight",
"prism"
],
"pluginsConfig": {
"sharing": {
"douban": false,
"facebook": false,
"google": false,
"hatenaBookmark": false,
"instapaper": false,
"line": false,
"linkedin": false,
"messenger": false,
"pocket": false,
"qq": false,
"qzone": false,
"stumbleupon": false,
"twitter": false,
"viber": false,
"vk": false,
"weibo": false,
"whatsapp": false,
"all": [
"weibo","qq","qzone","google","douban"
]
},
"github": {
"url": "https://github.com/WuXiaolong"
},
"donate": {
"wechat": "http://7q5c2h.com1.z0.glb.clouddn.com/wechatpay.JPG",
"title": "",
"button": "赏",
"wechatText": "微信打赏"
},
"anchor-navigation-ex": {
"associatedWithSummary":false,
"showLevel":true,
"multipleH1": true,
"mode": "float",

"pageTop": {
"showLevelIcon": false,
"level1Icon": "fa fa-hand-o-right",
"level2Icon": "fa fa-hand-o-right",
"level3Icon": "fa fa-hand-o-right"
}
},
"theme-default": {
"showLevel": true
},
"fontsettings": {
"theme": "white",
"family": "serif",
"size": 2
},
"prism": {
"css": [
"prismjs/themes/prism-tomorrow.css"
]
}
}

}

说明

  • github:添加 GitHub 图标;
  • Donate:添加赞赏按钮;
  • splitter:使侧边栏的宽度可以自由调节;
  • anchor-navigation-ex:添加Toc到侧边悬浮导航以及回到顶部按钮;
  • theme-default:将 showLevel 设为 true, 就可以显示标题前面的数字索引,默认不显示。

安装插件

$ gitbook install ./

不要忘记这步,根目录 node_modules 文件下能看到安装那些插件。

或单独安装插件:

$ npm install gitbook-plugin-anchor-navigation-ex --save

默认插件

GitBook 默认带有5个插件:

highlight

search

sharing

fontsettings

livereload

如果要去除自带的插件,可以在插件名称前面加 -:

"plugins": [
"-search"
]

如果想配置直接在 pluginsConfig 配置。

GitBook 输出

本地预览

进入你的 GitBook 书籍目录,右击 - 服务 - 新建位于文件夹位置的终端窗口,输入命令行:

$ gitbook serve

然后浏览器打开 http://localhost:4000 就能预览了,control + c 停止。

输出静态网站

$ gitbook build

以上都会在书籍目录生成 _book,前者能实时预览。

输出 PDF 文件

下载 Calibre

生成 PDF 文件依赖于 ebook-convert,需要安装 Calibre;

配置 Calibre 环境变量

如何配置环境变量参考这里,在 .bash_profile 文件加入:

# Calibre
export PATH=/Applications/calibre.app/Contents/MacOS:$PATH

更新刚配置的环境变量:

$ source .bash_profile

查看所有的配置路径:

$ echo $PATH

输出 PDF 文件

命令行:

$ gitbook pdf

将在根目录下生成了 book.pdf 文件

发布


如图,GitBook Editor - Book - Repository Settings,设置需要上传的远程 git,可以是 GitBook,GitHub 等。

域名

设置 GitBook 域名

YourBook - SETTINGS - Domains,如图:

在 Domain for content 填入自己的域名,因为我已经 Github page 中设置了 Hexo 博客,因此这里用的子域名。

配置 DNS

DNS 之前用的dnspod:

解析类型选择 CNAME,将域名指向一个域名,实现与被指向域名相同的访问效果,主机记录这里值为 book,也可以其他,这样解析后的二级域名为 book
.wuxiaolong.me;记录值填写服务商提供的域名,这里填写 www.gitbooks.io

注:最后我还是删了,因为我的域名没有备案,微信会有「非微信官方网页」提示,蛋疼。

最后

1、建议使用 GitBook Editor 在线编辑,我本地编辑老是崩溃,不知道是他们软件问题还是我电脑问题,在线编辑还有个好处,插件不用下载;

2、遗留两个问题没有解决,如图:

第一问题:这里是自动生成的,我能改成其他地址吗? 已解决!

第二问题:发现没,英文全是大写,能写什么就显示什么吗?

望知道的小伙伴告知下,多谢!

参考

相关文章

  • gitbook使用入门

    gitbook使用入门 GitBook使用教程 Mac环境安装Gitbook,并导出PDF教程 使用Gitbook...

  • GitBook 使用教程

    GitBook 使用教程 背景 生成接口文档 GitBook 简介 GitBook 官网 GitBook 文档 G...

  • GitBook Quick Start Guide

    使用 Gitbook 写 markdown, GitBook 可以与 github 进行链接,GitBook 在线...

  • GitBook

    GitBook 使用入门 使用 Gitbook 打造你的电子书 GitBook 插件 插件theme-api gi...

  • [gitbook]gitbook使用

    安装 安装环境: nodejs:"^8.0.0" npm i gitbook-cli -g 安装脚手架 gitbo...

  • Mac GitBook安装和使用

    Mac GitBook安装和使用 安装 安装npm 安装GitBook 安装Gitbook Editor客户端 注...

  • gitbook

    gitbook使用文档

  • gitbook 入门教程之快速体验

    本文主要介绍三种使用 gitbook 的方式,分别是 gitbook 命令行工具,Gitbook Editor 官...

  • 如何使用gitbook制作书籍

    gitbook使用gitbook命令来制作当地文件目录和文件(并可用localhost浏览效果),使用git进行版...

  • GitBook 使用

    我想把我的博客总结归纳下,于是找到了 GitBook,多了一个写博客地方,我把它做为博客的备份。花了两三天学习了 ...

网友评论

  • wenjunyeah:求助下博主,gitbook pdf提示 没有文件或路径,stat'../gitbook-plugin-highlight\ebook.css'找不到,但是看了下对应位置你是有文件的,这是什么情况?我只是下载了gitbook editor没有进行其他插件配置
  • 43cda8b48db9:你好,请问你的第一个遗留问题怎么解决的,希望能得到你的指点,谢谢

本文标题:GitBook 使用

本文链接:https://www.haomeiwen.com/subject/ceqbjxtx.html