GitBook¶
如果输入gitbook init命令,出现Installing version 2.1.0,需要耐性等待安装。
先到github建立一个仓库,保证有README.md等文件
然后克隆到本地
基本使用¶
README.md
这个文件相当于一本Gitbook的简介。
SUMMARY.md
这个文件是一本书的目录结构,使用Markdown语法.
Glossary.md
对于电子书内容中需要解释的词汇可在此文件中定义。词汇表会被放在电子书末尾。
例如:
* [简介](README.md)
* [第一章](chapter1/README.md)
- [第一节](chapter1/section1.md)
- [第二节](chapter1/section2.md)
* [第二章](chapter2/README.md)
- [第一节](chapter2/section1.md)
- [第二节](chapter2/section2.md)
* [结束](end/README.md)
其中,中括号内是章节名字,其为书右端可点击转跳的目录。后面小括号内为文件路径。
写完后
gitbook build
生成html格式书。默认在本地生成 _book 文件夹
然后上传到github
到gitbook 新建 book,从github上选择分支。个人网址后面填写的内容即为外部访问链接地址。
也可以将内容输出到想要的目录
gitbook build --output=<pathto>
本地网页预览
gitbook serve [--port 4000] <pathtofile>
忽略文件和文件夹
gitbook 将阅读 .gitignore .bookignore .ignore 文件,跳过文件和文件夹的列表
Glossary.md¶
其格式如下所示:
# 电子书
电子书是指将文字、图片、声音、影像等讯息内容数字化的出版物和植入或下载数字化文字、图片、声音、影像等讯息内容的集存储和显示终端于一体的手持阅读器。
# Kindle
Amazon Kindle 是由 Amazon 设计和销售的电子书阅读器(以及软件平台)。用户可以通过无线网络使用 Amazon Kindle 购买、下载和阅读电子书、报纸、杂志、博客及其他电子媒体。
电子书封面图片¶
GitBook 帮助文档建议封面图片的尺寸为 1800*2360 像素并且遵循建议:
没有边框
清晰可见的书本标题
任何重要的文字在小版本中应该可见
图片的格式为 jpg 格式。把图片重命名为“cover.jpg”放到电子书项目文件夹即可。
多语言¶
当你需要发布多个语言版本时,根目录只需要放置一个LANGS.md, 格式如下
* [English](en)
* [中文](zh)
* ...
每个zh,en文件夹现在就相当于一个独立的书籍.
插件¶
editlink
内容顶部显示 编辑本页 链接。
ad
在每个页面顶部和底部添加广告或任何自定义内容。
splitter
在左侧目录和右侧内容之间添加一个可以拖拽的栏,用来调整两边的宽度。
image-captions
抓取内容中图片的 alt 或 title 属性,在图片下面显示标题。
https://plugins.gitbook.com/plugin/image-captions
github
在右上角显示 github 仓库的图标链接。
anchors
标题带有 github 样式的锚点。
chart
使用 C3.js 图表。
https://plugins.gitbook.com/plugin/chart
styles-sass
使用 SASS 替换 CSS。
https://plugins.gitbook.com/plugin/styles-sass
styles-less
使用 LESS 替换 CSS。
https://plugins.gitbook.com/plugin/styles-less
ga
添加 Google 统计代码。
https://plugins.gitbook.com/plugin/ga
disqus
添加 disqus 评论插件。
https://plugins.gitbook.com/plugin/disqus
sitemap
生成站点地图。
latex-codecogs
使用数学方程式。
https://plugins.gitbook.com/plugin/latex-codecogs
mermaid
使用流程图。
https://plugins.gitbook.com/plugin/mermaid
book-summary-scroll-position-saver
自动保存左侧目录区域导航条的位置。
sharing
默认的分享插件。
https://plugins.gitbook.com/plugin/sharing
fontsettings
默认的字体、字号、颜色设置插件。
https://plugins.gitbook.com/plugin/fontsettings
search
默认搜索插件。
tbfed-pagefooter
自定义页脚,显示版权和最后修订时间。
page-footer-ex
定制页脚
https://plugins.gitbook.com/plugin/page-footer-ex
prism
基于 Prism 的代码高亮。
https://plugins.gitbook.com/plugin/prism
atoc
插入 TOC 目录。
ace
插入代码高亮编辑器。
https://plugins.gitbook.com/plugin/ace
highlight
默认的代码高亮插件,通常会使用 prism 来替换。
github-buttons
显示 github 仓库的 star 和 fork 按钮。
sectionx
分离各个段落,并提供一个展开收起的按钮。
https://plugins.gitbook.com/plugin/sectionx
mcqx
使用选择题。
https://plugins.gitbook.com/plugin/mcqx
include-codeblock
通过引用文件插入代码。
fbqx
使用填空题。
https://plugins.gitbook.com/plugin/fbqx
spoiler
隐藏答案,当鼠标划过时才显示。
https://plugins.gitbook.com/plugin/spoiler
anchor-navigation
锚点导航。
youtubex
插入 YouTube 视频。
redirect
页面跳转。
expandable-chapters
收起或展开章节目录中的父节点。
baidu
使用百度统计。
duoshuo
使用多说评论。
jsfiddle
插入 JSFiddle 组件。
jsbin
插入 JSBin 组件。
randoms-versions
Display a “select” with other versions of your gitbook.
https://plugins.gitbook.com/plugin/randoms-versions
http://www.css88.com/archives/6622
https://www.kancloud.cn/xiaoyulive/gitbook/506502