/learn-with-open-source

借助开源项目，学习软件开发

Primary LanguageShellOtherNOASSERTION

Learn Coding With Open Souce

Join the chat at https://gitter.im/zhuangbiaowei/learn-with-open-source

This book uses GitBook to build.

All contents licensed under the Creative Commons Attribution Non Commercial Share Alike 4.0 license

Welcome! Join us to finish this book.

You can visit the online ebook: Learn Coding With Open Source

for developers

Build the book

Note: you will need Linux or MacOS. Windows is not yet supported.

  1. install node.js
  2. install ebook-convert from calibre
  • for pdf,epub etc ebook generation.
  • go Calibre > Misc > Install Command Line Tool after installed
    • or ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin

  1. enter the git repository directory

    cd learn-with-open-source
npm install

  2. generate the ebook via:

    1. generate html pages:
    ./node_modules/.bin/gitbook build . _book
    1. run a local server to read html:
    ./node_modules/.bin/gitbook serve .
    1. generate the pdf:
    ./node_modules/.bin/gitbook pdf .

Update contributions automatically

It will update contributoions through git commits after a pull request or merge is executed. If you want to update it manually:

This script will update the "Contributor.md" file and copy it to the "zh" folder.

cd learn-with-open-source
./.githooks/post-merge/update-contributors

The contributors configuration file is the ".contributors" file on the root of the repository.

Update TOC automatically

TODO: this is not finished.

The gitbook uses the SUMMARY.md to get the TOC. the list in the SUMMARY.md will be the TOC.

1. [Topic](topic.md)
  1. [SubTopic](subtopic.md)
    1. TheSameFileTopicNoLinkAllowed
    1. TheSameFileTopicNoLinkAllowed
1. [Topic2]

note:

  • the parent directory is not supported via gitbook.
  • the topic in same file could not be a link.

the workflow automation is:

  • a text file to determine the markdown files order. or use the file name order in a directory.
  • get toc of each markdown file.
  • merge it into SUMMARY.md

《借助开源项目，学习软件开发》

本书使用 GitBook 来 build 电子书。

联机电子书版本在这里: Learn Coding With Open Source

开放文档：《借助开源项目，学习软件开发》

诚邀您的参与！

著作权申明

  • 本作品选择采用：署名-非商业性使用-相同方式共享 的CC协议。
    • 您可以：复制、发行、展览、表演、放映、广播或通过信息网络传播本作品。以及创作演绎作品。
    • 惟须遵守下列条件：
      • 署名 — 您必须按照作者或者许可人指定的方式对作品进行署名。
        • 署名方式为：在转载或新作品开头的显著位置，注明原作者的姓名、来源及其采用的知识共享协议，与本作品在Github上的原发地址建立链接
      • 非商业性使用 — 您不得将本作品用于商业目的。
      • 相同方式共享 — 如果您改变、转换本作品或者以本作品为基础进行创作，您只能采用与本协议相同的许可协议发布基于本作品的演绎作品。