使用 GitBook 写开源书

GitBook 让你在保持 使用 Markdown 的书写习惯外,稍加配置,就能自动发布到 GitBook 上,形成界面漂亮的各种电子书了(支持 html, pdf , ePUB, MOBI 等)。

Usage 1 用法一 使用模板快速开始

https://github.com/waylau/gitbook 这是个快速开始 GitBook 的模板项目,根据项目的结构,稍作修改,就能生成自己的电子书。

Installation 安装

gitbook 1.x 时执行:

$ npm install gitbook -g 

而从 gitbook 2.x 开始,执行下面新的命令语句:

$ npm install gitbook-cli -g 

Checkout the repository 检出模板项目

$ git clone https://github.com/waylau/gitbook.git 

Build 编译

$ gitbook build ./

This is a _book directory was created.


Run 运行

run the index.html in the _book directory .

打开该目录,右键运行 index.html 即可看到 gitbook 的效果


Usage 2 用法二 手动创建项目

Create a SUMMARY.md file 编辑 SUMMARY.md 文件

Edit content like:

# Summary

This is the summary of my book.

* section 1
 * [example 1](section1/example1.md)  * [example 2](section1/example2.md) * [section 2](section2/README.md)
 * [example 1](section2/example1.md) 

Create the directories and files for a book from its SUMMARY.md file using 根据 SUMMARY.md 自动生成目录结构

$ gitbook init

Build 编译

$ gitbook build ./

Run 运行

时间: 2024-12-30 18:37:26

使用 GitBook 写开源书的相关文章

用 Github、Markdown 和 GitBook 写开源书

之前一直是在 Github 上写开源书(见:http://www.waylau.com/books/)但,由于 Github 本身的目录结构并不一定符合阅读的习惯,而且没有提供 pdf , ePUB, MOBI 等格式的转换下载.很多同学也还是习惯离线看文档.GitBook 就是解决这一问题. GitBook 让你在保持在 Github 的书写习惯外,稍加配置,就能自动发布到GitBook 上,形成界面漂亮的电子书了(支持 html, pdf , ePUB, MOBI 等). 如果你是第一次使用

吴恩达导师Michael I. Jordan刚去清华手写版书讲了三天课,这有一份他的课程笔记

被称为"机器学习之父"的Michael I. Jordan教授上周(9月12-14日)在清华进行了为期三天的校内公开课,面对清华同学分享了他在伯克利AMP Lab和RISE Lab的最新研究成果. Jordan教授本次亲自上阵授课实属难得,为保证教学质量,本次系列课程也只面向清华学生开放,且不设录像直播,颇为珍贵.据大数据文摘了解,Jordan教授授课风格颇传统,全程抛弃多媒体设备,手写版书公式.本次讲座内容由机器学习方法和系统组成,主要涉及概率图模型.统计推断和模型评判,以及大规模机

模板类-学数据结构是一个叫殷人昆写的,书里各种bug,下面的重载函数到底怎么写?不要+内容,只要重载格式

问题描述 学数据结构是一个叫殷人昆写的,书里各种bug,下面的重载函数到底怎么写?不要+内容,只要重载格式 #ifndef SORTEDCHAIN_INCLUDED #define SORTEDCHAIN_INCLUDED #include #include using namespace std; template struct ChainNode { E data; ChainNode* link; ChainNode(): link(NULL){}; ChainNode(E& e1, Ch

使用Gitbook写电子书

工作以来一直有些博客的习惯,除了在各大站长写博客外,还可以使用 gitbook 将博客整理成电子书出版,如果受到好评还可以将图书弄成电子版出版. 经过近半年的整理,我的新书<React Native移动开发实战>就要发售了,提前打个广告,书名和封面样式还在确认中,也欢迎大家给出好的点子. 今天要给大家说的是如何利用GitBook编写一本属于自己的点子书. 1,GitBook Editor 首先到官网下载GitBook Editor,目前支持Mac.Linux.Windows主流平台. 安装完成

用 gitbook 为项目写本书吧

达尔文曾经说过:「任何一个项目都应该有一个 README」. 恩,README.md 对于任何一个项目来说都是不可或缺的一部分,无论是对于使用者还是后续维护者都是灰常重要哒:p 对于小型项目,一个 README.md 足以,但是如果是一个大项目的话(如 midway),那就不是一个 README.md 可以搞定的啦.本文就来扯一下使用 gitbook 为你的项目写一本**书**. 1. 安装 tnpm i -g gitbook 2. 初始化: 在你的文档目录下新建文件 SUMMARY.md,这个

写给初学asp.net的新人们 新手学习经验_自学过程

关于书本 新人们常常会说我看了多少多少的书,看过某某人写的书,仿佛书看了就会做了.其实不然,很多新人在面试的时候夸夸其谈,说啥啥都知道一点,到真正做的时候,啥都不会.归根到底是没有经验,技术这玩意儿经验非常重要,很多东西如果不是你碰到了,你从书上一辈子都找不到答案. 我看书的习惯一般都是先把整个书翻翻,了解一下书的基本内容,然后在实际项目中遇到相应的问题再去翻书,当然这是因为我对技术已经有一定的了解,不需要通读整本书.初学者应该找一些适合自己的书,通读一遍,其中的例子要认真做,一定要自己去写代码

每个程序员都该了解的开源世界

如昨天的图文所言,李世石在经历了三败之后,迸发出巨大的能量,绝地反击,靠78「神之一手」挖,击败了 AlphaGo,捍卫了人类棋手的荣耀. 最绚烂的火花,永远产生于森然秩序被打破,天才超然于规律之外的那一瞬间 3月15日,希望李世石能够赢得第五局! 今天文章的作者是朱赟,莱斯大学女博士,Airbnb 女工程师.可能是文章内容和锤子科技有点关系,于是执意在 MacTalk 首发,深感荣幸.关于软姐的介绍,请参考「神童的世界你不懂」,以下是全文. OpenResty 和春哥的故事 今天见到了传说中的

写给有目标却还称迷茫的大三学生

[来信] 贺老师,您好! 首先自我介绍一下.本人现在大三,在北京的一所985大学,主修计算机科学与技术专业,副修统计学专业. 当年选择计算机这个专业,是觉得比较符合时代潮流,虽然我上大学之前都没怎么接触过电脑. 其实大三了,感觉动手能力还是比较差的,不能很快地找到解决问题的方法,但因为我理解能力还不差,功课还是不错的,数学比一般计算机系的人要强,还参加了学院的一个实验室.目前是看计算机视觉方面的论文,还是用机器学习来做的. 现在的问题是没有一个明确的方向. 副修统计是以为和大数据有关系,进实验室

SEMFLY:真正的高流量软文应该这样写

现在有很多网友与我讨论一个直观影响SEO的问题,那就是除了利用搜索引擎拉流量,还有什么方法可以拉来大量的网站流量,这个问题直观的影响着我们每一个站长的心,因为在互联网世界里奋斗的人,最有价值的就是流量了,所以流量是一个很关键的问题,当我们讨论如何拉来大量流量的时候,我们想到的第一件事就是软文,因为一篇好的软文可以拉来大量的流量,一篇好的软文也可以辅助SEO增长排名,可以说软文确实很"牛",当我们已经确定软文可以给网站带来大流量的同时,出现最大的问题就是如何写一篇可以带来高流量的软文,经