0216
0216
3月前 · 3 人阅读

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

前期准备:

  • 申请一个自己的github账户
  • 了解Markdown语法
  • 把文章读完的耐心 (我用了一整天写完, 读完大约需要10分钟)

写开源书分三步:

  • 在Github中建立一个仓库, 创建好书的目录
  • 通过Github授权登录Gitbook, 以Github仓库为源, 在Gitbook创建一本书
  • 在Gitbook中写文章, 然后将写作数据提交到Github仓库中

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

新建仓库

建立仓库

添加新文件

建立目录

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

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

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

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

授权登录

添加新书

翻到下一页

从Github导入

选择仓库

确认创建新书

创建成功, 可以动笔了!

第三步: 动笔写书

初始界面

添加一篇文章

切换到markdown编辑模式

切换后的界面

复制简书markdown格式文章

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

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

效果预览

将文章更新到Github

查看Github仓库, Github已经更新

在线观看电子书





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

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



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






福利: 给你开源项目的署名:


最近我在编写开源的python书《超级棒的“派神”书》,如果有小伙伴, 愿意参与书的编写, 或者有好的建议,可以私信或留言,我会给在开源书的扉页为你添加署名的! 希望这本书尽快完成的小伙伴,可以给开源项目点个星哈! 开源项目在这里...

收藏 0
github 开源 仓库 gitbook 文章 ...
评论 ( 0 )