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.
GitBook配置的更多相关文章
- Gitbook配置目录折叠
如果有多个目录,Gitbook在浏览器上打开时,默认所有的目录都会打开,当目录比较多时,全部显示不利于阅读. 可以使用插件配置目录折叠,使得打开浏览器时这些目录默认是关闭的. 在执行gitbook i ...
- 使用 Gitbook 打造你的电子书
本文详细讲解了 Gitbook 生成电子书的完整过程,内容包括:安装.命令.配置.文档结构.生成电子书.部署. 限于篇幅,本文不介绍任何 Gitbook 定制化页面的内容. 想看看 Gitbook 在 ...
- gitbook一仓库多本书持续化部署
引言 本文档用户指导新手如何部署GitLab+Jenkins自动化构建GitBook,并使用Nginx发布资料.在部署过程中,如遇到任何问题,请自行百度. 注意: 此文章的环境和数据,仅为用于调试的片 ...
- GitBook插件整理 - book.json配置
目录 1. 配置概况 1.1. 全局配置 1.2. 插件列表 plugins 1.3. 插件属性配置pluginsConfig 2. 一些实用插件 2.1. back-to-top-button 回到 ...
- 【Gitbook】实用配置及插件介绍
前言 实际效果可以查看这里 github地址 配置 title 设置书本的标题 "title" : "Gitbook Use" author 作者的相关信息 & ...
- GitBook相关使用以及配置笔记
本地安装 GitBook的安装非常简单.您的系统只需满足这两个要求: NodeJS(推荐使用v4.0.0及以上版本) Windows,Linux,Unix或Mac OS X gitbook-cli 是 ...
- gitbook的插件配置
原生的gitbook样式比较单一,美观度和功能欠佳,可通过相关插件进行拓展. 插件地址:https://plugins.gitbook.com/ 主目录下新建book.json: { "au ...
- Gitbook简易教程
简介 GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书.GitBook支持输出以下几种文档格式 静态站点:GitBook ...
- 局域网内利用gitlab,jenkins自动生成gitbook并发布(nginx)
安装了GitBook,内网使用,没法用上gitbook的网页. 用gitbook serve只能展示一本书,而且也不利于长期维护. 于是使用gitlab,jenkins,和nginx配合gitbook ...
随机推荐
- 获取activity的根视图
Activity的根视图是什么? Activity所谓的根视图,就是Activity的最底层的View,也就是在Acitivty创建的时候setContentView的时候传入的View. 如何获取到 ...
- USB OTG简要
1 介绍 随着USB2.0发布版本号,USB更受欢迎.它已成为一种标准接口.现在,USB它支持三种速度:低速(1.5Mb/s).全速(12Mb/s)速(480Mb/s),四种传输类型:块传输.同步传输 ...
- 排序算法门外汉理解-Shell排序
#include <stdio.h> /* 希尔排序 基本思想:希尔排序又称为缩小增量排序,对简单插入排序的优化. (外部分组gap,组内部插入排序! ! ) 特点:一种不稳定的排序 */ ...
- 采用CSS3 Media Query技术适应Android平板屏幕分辨率和屏幕像素密度
采用HTML5在开发移动应用程序满足各种需求Android分辨率和屏幕的平板设备密度,这是非常麻烦的过程,最终的解决方案是使用css media query,匹配相同的时间分辨率和屏幕像素密度.上进行 ...
- HDU——B-number(数字DP)
标题效果: 要了解1至n如何号码之间有许多含有13,并13可分 记忆化搜索: dp[pos][pre][mod][statu],pos位数,pre前一位,mod余数,statu状态 有2个状态:含13 ...
- 如何定义AIDL跨进程间通信
当进程A要去调用进程B中的service时,并实现通信,我们通常都是通过AIDL来操作的 projectA: 首先在我们自己的包com.wzp.aidlservice中创建一个RemoteServic ...
- Model绑定
Model绑定 在前面的几篇文章中我们都是采用在URI中元数据类型进行传参,实际上ASP.NET Web API也提供了对URI进行复杂参数的绑定方式--Model绑定.这里的Model可以简单的理解 ...
- 一个好用的web甘特图
前些天一直在弄web甘特图,发现网上很多web甘特图框架,但大部分是收费的.偶尔发现了向日葵甘特图 感觉不错,特此写下来一方面当做记录,另一方面也为寻找web甘特图的同学们少走一些弯路,双赢嘛~ ...
- mysql及powerdesigner的初次使用
原文:mysql及powerdesigner的初次使用 MYSQL的下载与安装: 下载与安装指导教程: http://jingyan.baidu.com/article/597035521d5de28 ...
- Android 动画深入分析
一些娱乐动画安德鲁斯被广泛使用应用上述的.在不牺牲性能,它可以带来非常好的体验,下面会解释具体的实现安卓动画.知识的学校一个明确清晰的白色. 动画类型 Android的animation由四种类型组成 ...