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


  • 相关阅读:
    远程桌面无法复制粘贴
    xshell连接时报错:Could not connect to '192.168.2.125' (port 22): Connection failed.
    xshell远程连接另一台电脑的数据库,启动图形失败
    查询表空间总大小(dba_data_files和dba_segments,dba_free_space区别)
    网关,路由,子网掩码的作用
    Windows10无线能连上但没有网络
    如何让网页上的字如何变大
    MySQL数据查询(重点)
    MySQL增删改数据
    MySQL的表管理
  • 原文地址:https://www.cnblogs.com/Trybst/p/4494163.html
Copyright © 2011-2022 走看看