learn-with-open-source, 借助开源项目,学习软件开发

分享于 

4分钟阅读

GitHub

  繁體
借助开源项目,学习软件开发
  • 源代码名称:learn-with-open-source
  • 源代码网址:http://www.github.com/zhuangbiaowei/learn-with-open-source
  • learn-with-open-source源代码文档
  • learn-with-open-source源代码下载
  • Git URL:
    git://www.github.com/zhuangbiaowei/learn-with-open-source.git
    Git Clone代码到本地:
    git clone http://www.github.com/zhuangbiaowei/learn-with-open-source
    Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/zhuangbiaowei/learn-with-open-source
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    
    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.

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

    • generate html pages:
    ./node_modules/.bin/gitbook build . _book
    • run a local server to read html:
    ./node_modules/.bin/gitbook serve .
    • 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上的原发地址建立链接
        • 非商业性使用 - 您不得将本作品用于商业目的。
        • 相同方式共享 - 如果您改变、转换本作品或者以本作品为基础进行创作,您只能采用与本协议相同的许可协议发布基于本作品的演绎作品。

    相关文章