gitbook入门

参考文章:GitBook 从懵逼到入门

一、介绍

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

  1. GitBook + Markdown + Git优点:

    • 语法简单
    • 兼容性强
    • 导出方便
    • 专注内容
    • 团队协作
      注:本文使用搭配:GitBook + Typora + Git
  2. 相关markdown编辑器:


    markdown编辑器

二、安装

  1. 全局安装gitbook-cli
    npm i -g gitbook-cli

2、安装软件:Git、Typora
百度网盘 提取码:aljw

三、使用

  1. 新建mybook文件夹,初始化:gitbook init
    gitbook init

README.md —— 书籍的介绍写在这个文件里
SUMMARY.md —— 书籍的目录结构在这里配置

  1. 启动Typora编辑器,引入文件夹


    Typora打开mybook
  2. 编辑SUMMARY.md

# 目录

* [前言](README.md)
* [第一章](Chapter1/README.md)
  * [第1节:衣](Chapter1/衣.md)
  * [第2节:食](Chapter1/食.md)
  * [第3节:住](Chapter1/住.md)
  * [第4节:行](Chapter1/行.md)
* [第二章](Chapter2/README.md)
* [第三章](Chapter3/README.md)
* [第四章](Chapter4/README.md)
  1. 再次执行gitbook init,生成新目录结构

    gitbook init

    新目录

  2. 浏览器浏览:gitbook serve
    执行 gitbook serve 来预览这本书籍,执行命令后会对 Markdown 格式的文档进行转换,默认转换为 html 格式,最后提示 “Serving book on http://localhost:4000

    gitbook serve

  3. 构建书籍:gitbook build
    默认:将生成的静态网站输出到 _book 目录
    指定路径:gitbook build [书籍路径] [输出路径]
    指定端口:gitbook serve --port 2333
    生成pdf格式:gitbook pdf ./ ./mybook.pdf
    生成epub格式:gitbook epub ./ ./mybook.epub
    生成 mobi 格式:gitbook mobi ./ ./mybook.mobi

注意:如果生成不了,你可能还需要安装一些工具,比如 calibre、ebook-convert,或者在 Typora 中安装 Pandoc 进行导出。

四、用 Git 做版本管理

在远端建好git仓库,在 mybook 目录下执行 git init 初始化仓库,执行 git remote add 添加远程仓库。接着就可以愉快地 commit,push,pull …

本文制作实例:

查看git仓库
浏览器查看

推荐阅读更多精彩内容

  • 概述 GitBook 是使用 GitHub / Git 和 Markdown(或AsciiDoc)构建漂亮书籍的命...
    辉这样说阅读 2,765评论 0 4
  • 最近遇到一些问题,就是团队中会有些伙伴踩得坑的收集问题或者有些较为复杂的业务需求文档共享上成本较高,所以考虑弄...
    tobAlier阅读 3,596评论 0 5
  • 我最近接触到gitbook,发现它支持markdown和git,刚好把我之前在github上的笔记可以生成一本书,...
    voidsky_很有趣儿阅读 11,104评论 4 51
  • gitbook使用npm进行安装,全局安装和检测安装命令如下: 创建目录结构 创建一个目录,并将如下的结构写入SU...
    钟晃阅读 404评论 0 0
  • 连野兽也懂得养育之恩,人如果把这个大自然的道理给忘掉,那就连动物都不如。 以孝为先不是夸大其对于人格的重要性,孝,...
    davluo阅读 282评论 0 0
  • Test Typora 标题试验 三级标题 四级标题 五级标题 六级标题 最多到六级标题 序列号 有序序列 序列1...
    梁寅plus阅读 154评论 0 0
  • 本来是想要去健身房运动的~然后一开始分享~不知不觉就分享了将近一个钟~结束才发现自己是跪在沙发和大家语音分享的~膝...
    苏苏美学坊阅读 38评论 0 0