zoukankan      html  css  js  c++  java
  • GitBook配置

    GitBook 是一个通过 Git 和 Markdown 来撰写书籍的工具。
    生成格式有:JSON、ePub、PDF、Website !

    ================================

    Git 方式

    GitBook 使用 Git 进行写作内容管理。

    • 从用户的角度看,这样能够方便地进行多人协作(连程序源代码都能管好,书籍自然不在话下),还不用学习额外概念或用法

    • 从设计实现的角度看,这样能够合理利用已有工具(不重复造轮)满足产品需求,甚至扩展性更好(Git 相关服务能够利用的太多了)

    正所谓:“人发地,地法天,天法道,道法自然”啊。

    Markdown

    GitBook 不只是利用了 Git,目前非常流行的 Markdown 也被运用其中。

    使用 Markdown 最大的好处就是简单:

    • 语法简单,并且能够形象地表达出意图(例如无序列表使用 * ,强调使用 ** ,一个 # 表示 H1、两个 # 表示 H2)

    • 不干扰写作者:语法标记在视觉上对写作者的负面影响不大(不像 HTML 满屏的 <>)

    总之,Markdown 就是能够让写作者更专注于内容创作。

    不过 GitBook 不只是简单地使用 Markdown,使用 Markdown 编写的内容只是源格式,最终的目标格式可以为 PDF、ePub 等。

    ================================

    [ 配置方式 ]

    1> 下载并安装 npm

    node-v0.12.0.pkg [http://nodejs.org/download/](http://nodejs.org/download/)

    2> 安装 gitbook

    ```

    $ sudo npm install gitbook -g

    ```

    3> 进入终端 cd 到新建的电子书目录

    ```

    $ touch SUMMARY.md

    $ gitbook init

    ```

    4> 下载并安装 gitbookEditor,gitbook 本地编辑器 [https://github.com/GitbookIO/editor/releases](https://github.com/GitbookIO/editor/releases)

    * 打开并选择刚刚 init 的目录即可编辑

    5> 本地预览

    ```

    $ gitbook serve

    ```

    6> 下载并安装 calibre,生成电子书使用

    calibre-2.20.0 [http://calibre-ebook.com/download_osx](http://calibre-ebook.com/download_osx)

    * 在终端输入

    ```

    $ ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin

    ```

    7> 生成电子书

    ```

    $ gitbook epub

    或者

    $ gitbook pdf

    ```

    8> .gitignore [https://github.com/github/gitignore.git](https://github.com/github/gitignore.git)

    ================================ 

    PS: 

    [ 每日一句 ]

    静,是一种气质,也是一种修养。 

     

    [ 推荐一首英文歌 ]

    " Unforgivable Sinner " - Lene MarLin

    ================================

     

    |-> GitHub: SpongeBob-GitHub

    |--> Copyright (c) 2015 Bing Ma.

     



    " There's always more to learn, and there are always better ways to do what you've done before. " -- Trybst


  • 相关阅读:
    Java控制台五子棋编码学习
    Java Web基础
    JavaScript Unit Test with Mocha
    Cross-browser Testing Tool
    GRIDVIEW 控件
    C# .net ACCESS 网页增删改查 --留言板
    在一般处理文件中访问Session需要添加IRequiresSessionState(转载)
    win7 IIS7 发布网站 出现 "处理程序“PageHandlerFactory-Integrated”在其模块列表中有一个错误"
    http://www.cnblogs.com/hanshuhe/archive/2012/08/30/vss.html
    win 7 配置 IIS
  • 原文地址:https://www.cnblogs.com/Trybst/p/4494163.html
Copyright © 2011-2022 走看看