GitBook插件
记录一些实用的插件, 如果要指定插件的版本可以使用 [email protected]
- Disqus - Disqus评论
- duoshuo - 多说
- Search Pro - 支持中文搜索
- Advanced Emoji - 支持emoji表情
- Github - 添加github图标
- Ace Plugin - 支持ace
- Emphasize - 强调文字(为文字加上底色)
- KaTex - 支持数学公式
- Include Codeblock - 使用代码块显示指定文件的内容
- Splitter - 自由调节侧边栏宽度
- Mermaid -支持渲染Mermaid图表
- sharing - 分享
- Tbfed-pagefooter - 为页面添加页脚
- Toggle Chapters - 折叠章节
- Sectionx - 将页面分块显示
- Codeblock-filename - 为代码块添加文件名称
- ga - google 统计
- baidu - 百度统计
- sitemap - 生成sitemap
Disqus
添加disqus评论
"plugins": [
"disqus"
],
"pluginsConfig": {
"disqus": {
"shortName": "gitbookuse"
}
}
Duoshuo
添加多说
{
"plugins": [
"duoshuo"
],
"pluginsConfig": {
"duoshuo": {
"short_name": "your duoshuo's shortname",
"theme": "default"
}
}
}
Search Pro
支持中文搜索, 需要将默认的search插件去掉, 在window下安装该插件时总是出错
插件地址
"plugins": [
"-search",
"search-pro"
],
"pluginsConfig": {
"search-pro": {
"cutWordLib": "nodejieba",
"defineWord" : ["Gitbook Use"]
}
}
Advanced Emoji
"plugins": [
"advanced-emoji"
]
使用示例:
Github
添加github图标
插件地址
"plugins": [
"github"
],
"pluginsConfig": {
"github": {
"url": "https://github.com/zhangjikai"
}
}
Ace Plugin
使gitbook支持ace
插件地址
"plugins": [
"ace"
]
使用示例:
// This is a hello world program for C.
#include <stdio.h>
int main(){
printf("Hello World!");
return 1;
}
Emphasize
为文字加上底色
插件地址
"plugins": [
"emphasize"
]
使用示例:
This text is highlighted !
This text is highlighted with markdown!
This text is highlighted in green!
This text is highlighted in red!
This text is highlighted with a custom color!
KaTex
为了支持数学公式, 我们可以使用KaTex
和MathJax
插件, 官网上说Katex
速度要快于MathJax
插件地址
MathJax使用LaTeX语法编写数学公式教程
"plugins": [
"katex"
]
使用示例:
When , there are two solutions to and they are
Include Codeblock
使用代码块的格式显示所包含文件的内容. 该文件必须存在.
插件地址
"plugins": [
"include-codeblock"
]
使用示例:
/* CSS for website */
h1 , h2{
border-bottom: 1px solid #EFEAEA;
padding-bottom: 3px;
}
.book .book-body .page-wrapper .page-inner section.normal {
min-height:350px;
margin-bottom: 30px;
}
.book .book-body .page-wrapper .page-inner section.normal hr {
height: 0px;
padding: 0;
margin: 1.7em 0;
overflow: hidden;
background-color: #e7e7e7;
border-bottom: 1px dotted #e7e7e7;
}
Splitter
使侧边栏的宽度可以自由调节
插件地址
"plugins": [
"splitter"
]
Mermaid
"plugins": [
"mermaid"
]
使用示例:
Sharing
分享当前页面, gitbook的默认插件, 使用下面方式来禁用
plugins: ["-sharing"]
配置:
"pluginsConfig": {
"sharing": {
"weibo": true,
"facebook": true,
"twitter": true,
"google": false,
"instapaper": false,
"vk": false,
"all": [
"facebook", "google", "twitter",
"weibo", "instapaper"
]
}
}
Tbfed-pagefooter
为页面添加页脚
插件地址
"plugins": [
"tbfed-pagefooter"
],
"pluginsConfig": {
"tbfed-pagefooter": {
"copyright":"Copyright © zhangjikai.com 2015",
"modify_label": "该文件修订时间:",
"modify_format": "YYYY-MM-DD HH:mm:ss"
}
}
Toggle Chapters
是左侧的章节目录可以折叠
插件地址
"plugins": ["toggle-chapters"]
Sectionx
将页面分块显示
插件地址
"plugins": [
"sectionx"
]
使用示例
Codeblock-filename
为代码块添加文件名称
插件地址
plugins: [ "codeblock-filename" ]
使用示例:
helloworld
helloworld
test.js
console.log("test");
GA
google 统计
插件地址
"plugins": [
"ga"
],
"pluginsConfig": {
"ga": {
"token": "UA-XXXX-Y"
}
}
Baidu
百度统计
插件地址
"plugin": [
"baidu"
],
"pluginsConfig": {
"baidu": {
"token": "YOUR TOKEN"
}
}
Sitemap
生成sitemap
插件地址
{
"plugins": ["[email protected]"],
"pluginsConfig": {
"sitemap": {
"hostname": "http://mybook.com/"
}
}
}
使用1.1.0生成的xml文件有些问题, 所以这里使用1.0.2版本