我最近接触到gitbook,发现它支持markdown和git,刚好把我之前在github上的笔记可以生成一本书,于是我就开始着手捣鼓gitbook,一下午的时间就弄的差不多了,说明这个东西还是挺容易的,可以看看我的书:

《LeetBook(LeetCode详解)》

比较建议直接在github上部署你的框架,然后再导入gitbook。

创建一个新的仓库

创建过程不需要我细讲了把,如果不知道,看看github入门

创建一个新文件,名为SUMMARY.md,里面填入:

# Summary
* [前言](README.md)

创建一本书

首先进入gitbook的官网:https://www.gitbook.com/

点红色部分,用github登录

登录之后,点+NewBook

点到github,点击Link to your Github

授权完毕然后再点到这个页面

选择你需要导入的仓库,我们用刚才创建的testbook,然后标题可以自己取,下面的地址只能填英文,然后点创建

这个页面目前是在同步,等同步完毕后,就可以看到自己的书了。

可以点击read

可以发现里面就1页,就是我们刚才SUMMARY.md写的内容

增加内容

我们退回上一步,点edit

可以看到如下界面

我们点开

可以同步显示编辑后的效果

现在我们就可以完成我们的书的录入了,在目录区点击右键,可以新建一个内容页

然后点击一下,会提示创建一个文件

然后你会发现在github上也多了一个文件,这就关联起来了。

我们再看SUMMARY里面多了一个“第一页”

我们双击一下,发现就是markdown的超链接,原来这就是gitbook的内容组织方式,通过超连接把内容和github上文件关联起来。

我们修改一下名字,然后把他缩进一个tab,保存看看有什么变化

可以发现目录结构变了,然后名字也变了

通过修改SUMMARY.md你可以轻松的组织你的书

书的框架

一般来说,你的书得有一个README.md和一个SUMMARY.md。

其中SUMMARY.md是最重要的,它代表了整个书的框架,也是我们主要需要修改的地方。

当你考虑好要写一本书,你可以先粗略的想好大概要分几部分,对这几部分弄一个文件夹。然后把对应的markdown文件放进去。

然后push到github上,然后再在gitbook上修改SUMAARY使得新加的文件得以跟gitbook关联

关于地址的获取有个小诀窍,就是点击文件,邮件,有个重命名,这里可以看到文件的完整地址,复制就好。

最后,可以在自己的书的主页点击read看看效果

GitBook入门(用github做出第一本书)——超详细配图说明的更多相关文章

  1. 深度学习动手入门:GitHub上四个超棒的TensorFlow开源项目

    作者简介:akshay pai,数据科学工程师,热爱研究机器学习问题.Source Dexter网站创办人. TensorFlow是Google的开源深度学习库,你可以使用这个框架以及Python编程 ...

  2. Docker Harbor私有仓库部署与管理 (超详细配图)

    Docker Harbor私有仓库部署与管理 1.Harbor 介绍 2.Harbor部署 3.Harbor管理 1.Harbor 介绍: 什么是 Harbor ? Harbor 是 VMware 公 ...

  3. Docker consul的容器服务更新与发现(超详细配图)

    Docker consul的容器服务更新与发现 1.概述 2.部署 1.概述: (1)什么是服务注册与发现: 服务注册与发现是微服务架构中不可或缺的重要组件.起初服务都是单节点的,不保障高可用性,也不 ...

  4. 超详细从零记录Hadoop2.7.3完全分布式集群部署过程

    超详细从零记录Ubuntu16.04.1 3台服务器上Hadoop2.7.3完全分布式集群部署过程.包含,Ubuntu服务器创建.远程工具连接配置.Ubuntu服务器配置.Hadoop文件配置.Had ...

  5. 超强、超详细Redis数据库入门教程

    这篇文章主要介绍了超强.超详细Redis入门教程,本文详细介绍了Redis数据库各个方面的知识,需要的朋友可以参考下 [本教程目录] 1.redis是什么2.redis的作者何许人也3.谁在使用red ...

  6. 超强、超详细Redis数据库入门教程(转载)

    这篇文章主要介绍了超强.超详细Redis入门教程,本文详细介绍了Redis数据库各个方面的知识,需要的朋友可以参考下   [本教程目录] 1.redis是什么 2.redis的作者何许人也 3.谁在使 ...

  7. 超强、超详细Redis入门教程【转】

    这篇文章主要介绍了超强.超详细Redis入门教程,本文详细介绍了Redis数据库各个方面的知识,需要的朋友可以参考下 [本教程目录] 1.redis是什么2.redis的作者何许人也3.谁在使用red ...

  8. 超详细Redis入门教程【转】

    这篇文章主要介绍了超强.超详细Redis入门教程,本文详细介绍了Redis数据库各个方面的知识,需要的朋友可以参考下   [本教程目录] 1.redis是什么 2.redis的作者何许人也 3.谁在使 ...

  9. Github上传代码菜鸟超详细教程【转】

    最近需要将课设代码上传到Github上,之前只是用来fork别人的代码. 这篇文章写得是windows下的使用方法. 第一步:创建Github新账户 第二步:新建仓库 第三部:填写名称,简介(可选), ...

随机推荐

  1. cocos2dx的addChild接口设计

    addChild的几个重载函数挺容易用错的 主要是因为cocos2dx用来给游戏对象设置标签时,用的是整型而不是字符串 导致标签这个参数很容易和同样是使用整型的代表游戏对象的层级关系的参数混淆.

  2. 设置 ssh 使用public key 免密码登录

    第一步,生成自己公钥, 私钥 1: ssh-keygen -t rsa 2:   3: root@yjlml:~# ssh-keygen -t rsa 4: Generating public/pri ...

  3. 饿了么 PostgreSQL 优化之旅

    1. 架构演变 在O2O外卖领域,基于位置服务的需求越来越多,这就要求DB能够存储地理位置信息,而在开源数据库中,对空间地理数据支持比较好的要数PG的插件Postgis. 饿了么在使用PG的过程中,由 ...

  4. 创建TFS团队项目时自动建立代码库的文件夹结构

    很多客户都跟我提过一个这样的需求,即需要在创建团队TFS项目时,自动创建起源代码库的文档结构,例如类似下列结构的文件夹: <teamProject>   |- DEVELOPMENT   ...

  5. 正则表达式REGEXP

    正则表达式:REGular EXPression, REGEXP 元字符: .: 匹配任意单个字符 []: 匹配指定范围内的任意单个字符 [^]:匹配指定范围外的任意单个字符 字符集合:[:digit ...

  6. AngularJs2 构建简单的英雄编辑器

    参考上一篇文章的步骤,重新把相关环境准备.目录结构走一遍. 这一次我们要开始创建真正的Angularjs项目了. 显示我们的英雄 我们要在应用中显示英雄数据 我们来为 AppComponent 添加两 ...

  7. swagger 在本地正常调试 发布后出现500 : {"Message":"出现错误。"}

    点击项目属性 勾上xml 解决

  8. 多彩浏览器win10版 隐私声明

    (一)隐私保护 the  app need internet access,we won't need your private information, in other words, your i ...

  9. 12c ocp 062新考题(之前没出现过)-1

    1.One of your databases has archive logging enabled and RMAN backups are taken at regular intervals. ...

  10. codeforces 1096 题解

    A: 发现最优的方案一定是选 $ l $ 和 $ 2 * l $,题目保证有解,直接输出即可 #include <bits/stdc++.h> #define Fast_cin ios:: ...