Learn Coding with Open Source

This book uses GitBook to build.

License: CC BY-NC-SA 4.0

Welcome! Join us to finish this book.

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

for developers

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

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

enter the git repository directory
```
cd learn-with-open-source
npm install
```

generate the ebook via:

./node_modules/.bin/gitbook build . _book

./node_modules/.bin/gitbook serve .

./node_modules/.bin/gitbook pdf .

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.

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 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

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

诚邀您的参与！

License: CC BY-NC-SA 4.0