前段時間, 寫了一篇從Github下載開源電子書, 收到很多贊, 有朋友問我, 如何寫自己的開源電子書? 我在這里就詳細的寫一寫...
前期準備:
- 申請一個自己的github賬戶
- 了解Markdown語法
- 把文章讀完的耐心 (我用了一整天寫完, 讀完大約需要10分鐘)
寫開源書分三步:
- 在Github中建立一個倉庫, 創(chuàng)建好書的目錄
- 通過Github授權(quán)登錄Gitbook, 以Github倉庫為源, 在Gitbook創(chuàng)建一本書
- 在Gitbook中寫文章, 然后將寫作數(shù)據(jù)提交到Github倉庫中
第一步: 在Github中建立一個倉庫, 并創(chuàng)建好書的目錄
新建倉庫
新建倉庫
建立倉庫
建立倉庫
添加新文件
添加新文件
建立目錄
建立目錄
# Summary
* [編者序](README.md)
滾動到頁面底部, 點擊Commit new file按鈕
確認對SUMMARY.md的修改
第二步: 通過Gitbook連接Github倉庫
進入 https://legacy.gitbook.com/, 使用github賬戶授權(quán)登錄
SignUp
授權(quán)登錄
授權(quán)登錄
添加新書
添加新書
翻到下一頁
翻到下一頁
從Github導入
從Github導入
選擇倉庫
選擇倉庫
確認創(chuàng)建新書
創(chuàng)建書
創(chuàng)建成功, 可以動筆了!
開始編輯
第三步: 動筆寫書
初始界面
初始界面
添加一篇文章
添加文章
切換到markdown編輯模式
切換到Markdown格式
切換后的界面
切換后界面
復(fù)制簡書markdown格式文章
Gitbook 和 簡書 都支持Markdown, 我直接從簡書拷貝一篇文章, 快速預(yù)覽效果
拷貝
將復(fù)制的文章粘貼到gitbook編輯器
粘貼
效果預(yù)覽
效果完美
將文章更新到Github
更新到Github
查看Github倉庫, Github已經(jīng)更新
Github已經(jīng)更新
在線觀看電子書
退出編輯器
開始閱讀
閱讀效果
頁面效果切換
- 至此, 你已學會創(chuàng)建自己的開源書籍!
擴展: 可能你會遇到這些問題...
問題1: Gitbook無法關(guān)聯(lián)到Github倉庫
選擇Settings
配置gitbook插件
保存修改
問題2: 文章的url是拼音, 有點low, 想改成英文
修改前
修改法則
修改
提交
修改后
福利: 給你開源項目的署名:
超級棒的"派神"書
最近我在編寫開源的python書《超級棒的“派神”書》,如果有小伙伴, 愿意參與書的編寫, 或者有好的建議,可以私信或留言,我會給在開源書的扉頁為你添加署名的! 希望這本書盡快完成的小伙伴,可以給開源項目點個星哈! 開源項目在這里...
我的博客即將搬運同步至騰訊云+社區(qū)，邀請大家一同入駐：https://cloud.tencent.com/developer/support-plan?invite_code=37xtfq9gnbc4k
