手记

教你在Github写开源电子书

前段时间, 写了一篇从Github下载开源电子书, 收到很多赞, 有朋友问我, 如何写自己的开源电子书? 我在这里就详细的写一写...

前期准备:

  • 申请一个自己的github账户

  • 了解Markdown语法

  • 把文章读完的耐心 (我用了一整天写完, 读完大约需要10分钟)

写开源书分三步:

  • 在Github中建立一个仓库, 创建好书的目录

  • 通过Github授权登录Gitbook, 以Github仓库为源, 在Gitbook创建一本书

  • 在Gitbook中写文章, 然后将写作数据提交到Github仓库中

第一步: 在Github中建立一个仓库, 并创建好书的目录

新建仓库

新建仓库

建立仓库

建立仓库

添加新文件

添加新文件

建立目录

建立目录

# Summary* [编者序](README.md)

滚动到页面底部, 点击Commit new file按钮

确认对SUMMARY.md的修改

第二步: 通过Gitbook连接Github仓库

进入 https://legacy.gitbook.com/, 使用github账户授权登录

SignUp

授权登录

授权登录

添加新书

添加新书

翻到下一页

翻到下一页

从Github导入

从Github导入

选择仓库

选择仓库

确认创建新书

创建书

创建成功, 可以动笔了!

开始编辑

第三步: 动笔写书

初始界面

初始界面

添加一篇文章

添加文章

切换到markdown编辑模式

切换到Markdown格式

切换后的界面

切换后界面

复制简书markdown格式文章

Gitbook简书 都支持Markdown, 我直接从简书拷贝一篇文章, 快速预览效果

拷贝


将复制的文章粘贴到gitbook编辑器

粘贴

效果预览

效果完美

将文章更新到Github

更新到Github

查看Github仓库, Github已经更新

Github已经更新

在线观看电子书

退出编辑器


开始阅读


阅读效果


页面效果切换

  • 至此, 你已学会创建自己的开源书籍!


扩展: 可能你会遇到这些问题...

问题1: Gitbook无法关联到Github仓库

选择Settings


配置gitbook插件


保存修改

问题2: 文章的url是拼音, 有点low, 想改成英文

修改前


修改法则


修改


修改法则


修改


提交


修改后






0人推荐
随时随地看视频
慕课网APP