文档章节

用github写开源书籍

tantexian
 tantexian
发布于 2016/10/25 20:47
字数 675
阅读 31
收藏 0

用github写开源书籍

gitbook

http://blog.csdn.net/hk2291976/article/details/51173850

 

用github写书籍

 

 

创建一个新的仓库

创建新文件,SUMMARY.md

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

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

  • 1
  • 2
  • 1
  • 2

创建一本书

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

点红色部分,用github登录

登录之后,点+NewBook(或在右上角+NEW,页面稍有改版)

 

这个页面目前是在同步,等同步完毕后,就可以看到自己的书了(不是什么原因这里会一直是这个界面不会跳转,但其实收到了通知邮件已经创建好了,打开主页刷新就可以看到)。

点击edit,可以发现里面就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看看效果

 

Github绑定域名

原理和博客绑定域名是一样的

链接:http://blog.csdn.net/lan842632/article/details/52846689

 

 

个人学习笔记,不当之处还请指正。
----------不定期更新------------

原文地址:http://blog.csdn.net/lan842632/article/details/52847853

本文转载自:

tantexian
粉丝 225
博文 527
码字总数 746616
作品 0
成都
架构师
私信 提问
Github最值一读开源好书及BAT面试题库

  【IT168 评论】正版书籍太贵,盗版书看着不爽,英文原版看着费力,中文译本错误百出。对技术人员而言,进阶路上似乎一直找不到合适的书籍或者资源可供学习,即便找到了,似乎也没有合适的...

it168网站
2017/11/27
0
0
开源图书--《Go Web编程》

因为自己对web开发比较感兴趣,所以最近抽空在写一本开源的书籍《Go Web编程》《build web application with golang》。写这本书不表示我能力很强,而是我愿意分享,和大家一起分享Go写web应...

astaxie
2012/09/18
67.7K
13
掘金 AMA:我是知乎专栏《V8 引擎》作者-- justjavac(迷渡),你有什么问题要问我吗?

掘金 AMA(ask me anything) 是掘金沸点的一个话题,掘金团队会邀请一位技术大牛通过「你问我答」的形式回答你的问题,让大家在技术、工作、生活方面有所成长。 AMA 嘉宾 掘金 AMA 第八期嘉宾...

清蒸不是水煮
2018/09/17
0
0
BookChat v2.3 发布,通用书籍阅读小程序,增加分享海报和广告功能

BookChat 介绍 BookChat - 面向程序员的开源书籍和文档阅读学习小程序,同时也是一款基于 Apache 2.0 开源协议进行开源的通用书籍阅读微信小程序。 它非常轻量,200KB 左右的大小,麻雀虽小五...

皇虫
08/14
1K
3
DICOM:开源书籍之『DICOM标准中文版』启动计划

题记: 博客早已不是时下最流行的传播媒介,或许在技术圈子还仅存一线生机。之所以选择技术博客,初衷是为了记录自己工作中的点滴,因为随着岁月流逝,记忆力已大不如从前;其次是为了交流和...

zssureqh
2015/06/14
0
0

没有更多内容

加载失败,请刷新页面

加载更多

教你玩转Linux—添加批量用户

添加和删除用户对每位Linux系统管理员都是轻而易举的事,比较棘手的是如果要添加几十个、上百个甚至上千个用户时,我们不太可能还使用useradd一个一个地添加,必然要找一种简便的创建大量用户...

xiangyunyan
23分钟前
6
0
返回提示信息,如:xxx创建成功!

【服务端】在输出的方法块中,加入要输出的字段(qcm_batch_id) QCMUserType.cs: public struct QCM_Custom_Create_Batch_Out_Tag { public BASCoreType.Cmn_Out_T......

_Somuns
23分钟前
5
0
Aliyun Serverless VSCode Extension v1.12.0 发布

Aliyun Serverless VSCode Extension 是阿里云 Serverless 产品 函数计算 Function Compute 的 VSCode 插件,该插件结合了函数计算 Fun 工具以及函数计算 SDK ,是一款 VSCode 图形化开发调试...

阿里云官方博客
24分钟前
6
0
程序员如何培养解决复杂问题的能力?

今天在上网时候,突然看到了这篇文章,感觉非常的适合现在的自己去思考下,可能也适用在座的读者。程序员不仅仅是敲代码,更是一个复合能力的结合体,也不仅仅停留在技术和代码阶段。你想要成...

哥本哈根的小哥
27分钟前
8
0
市场变化驱动产品思维升级

宜信科技中心财富管理产品部负责人Bob,与大家一起聊聊个性化推荐产品功能的设计和B端产品的功能策划方式。 拓展阅读:回归架构本质,重新理解微服务 智慧金融时代,大数据和AI如何为业务赋能...

宜信技术学院
28分钟前
8
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部