# mybook

**Repository Path**: vjs/mybook

## Basic Information

- **Project Name**: mybook
- **Description**: Gitbook 项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2019-03-04
- **Last Updated**: 2020-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GitBook简介

## 安装
  gitbook依赖nodejs环境，需先安装nodejs，cmd执行以下命令：

  使用npm执行

    npm install -g gitbook-cli

  使用yarn执行

    yarn global add gitbook-cli

  mac 加上 sudo 获取管理员权限

## 使用

  ** 1、初始化 **

  新建一个mybook文件夹，cd mybook 执行以下命令：

    gitbook init

  执行完后，你会看到多了两个文件 —— README.md 和 SUMMARY.md，它们的作用如下：

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

  编辑 SUMMARY.md 文件，内容修改为：

  ```
    * [GitBook环境搭建](README.md)
    * [Markdown语法](Markdown/README.md)
        * [标题](Markdown/title.md)
        * [字体](Markdown/font.md)
        * [段落](Markdown/stage.md)
        * [区块引用](Markdown/block.md)
        * [代码区块](Markdown/codeBlock.md)
        * [列表](Markdown/list.md)
        * [分割线](Markdown/split.md)
        * [链接](Markdown/link.md)
        * [图片](Markdown/image.md)
        * [反斜杠](Markdown/backSlant.md)
        * [符号](Markdown/mark.md)
        * [表格](Markdown/table.md)
        * [流程图](Markdown/flow.md)    
  ```

回到命令行，在 mybook 文件夹中再次执行 gitbook init 命令

GitBook 会查找 SUMMARY.md 文件中描述的目录和文件，如果没有则会将其创建。

> *执行 gitbook init 命令，已创建的目录和文件不会被删除


 ** 2、预览 **

 执行 

     gitbook serve

执行命令后会对 Markdown 格式的文档进行转换，默认转换为 html 格式

最后提示 Serving book on http://localhost:4000

> 预览过程修改 *.md 文档会实时生成刷新内容 

> 预览过程修改 SUMMARY.md 不会创建新文件，若要创建执行 gitbook init 命令

指定端口启动

    gitbook serve --port 8080


 ** 3、构建 **
 
  执行命令
  
      gitbook build 
      
  构建书籍，默认将生成的静态网站输出到 _book 目录

  build 命令可以指定路径：

      gitbook build [书籍路径] [输出路径]

  生成 PDF 格式的电子书：

      gitbook pdf ./ ./mybook.pdf

  生成 epub 格式的电子书：

      gitbook epub ./ ./mybook.epub

  生成 mobi 格式的电子书：

      gitbook mobi ./ ./mybook.mobi