前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >教你在Github写开源电子书

教你在Github写开源电子书

作者头像
zhaoolee
发布2018-04-19 17:42:11
2.3K0
发布2018-04-19 17:42:11
举报
文章被收录于专栏:木子昭的博客

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

前期准备:

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

写开源书分三步:

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

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

新建仓库
建立仓库
添加新文件
建立目录
代码语言:javascript
复制
# 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书《超级棒的“派神”书》,如果有小伙伴, 愿意参与书的编写, 或者有好的建议,可以私信或留言,我会给在开源书的扉页为你添加署名的! 希望这本书尽快完成的小伙伴,可以给开源项目点个星哈! 开源项目在这里...

我的博客即将搬运同步至腾讯云+社区,邀请大家一同入驻:https://cloud.tencent.com/developer/support-plan?invite_code=37xtfq9gnbc4k

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2018.04.15 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 前期准备:
  • 写开源书分三步:
  • 第一步: 在Github中建立一个仓库, 并创建好书的目录
    • 新建仓库
      • 建立仓库
        • 添加新文件
          • 建立目录
            • 滚动到页面底部, 点击Commit new file按钮
            • 第二步: 通过Gitbook连接Github仓库
              • 进入 https://legacy.gitbook.com/, 使用github账户授权登录
                • 授权登录
                  • 添加新书
                    • 翻到下一页
                      • 从Github导入
                        • 选择仓库
                          • 确认创建新书
                          • 第三步: 动笔写书
                            • 初始界面
                              • 添加一篇文章
                                • 切换到markdown编辑模式
                                  • 切换后的界面
                                    • 复制简书markdown格式文章
                                      • 将复制的文章粘贴到gitbook编辑器
                                        • 效果预览
                                          • 将文章更新到Github
                                            • 查看Github仓库, Github已经更新
                                              • 在线观看电子书
                                              • 扩展: 可能你会遇到这些问题...
                                                • 问题1: Gitbook无法关联到Github仓库
                                                  • 问题2: 文章的url是拼音, 有点low, 想改成英文
                                                  • 福利: 给你开源项目的署名:
                                                  领券
                                                  问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档