Skip to content

Latest commit

 

History

History
73 lines (48 loc) · 3.25 KB

File metadata and controls

73 lines (48 loc) · 3.25 KB

gitbook-plugin-anchor-navigation-ex

GitHub issues GitHub issues GitHub license npm npm

=============== 【DOC:中文,English 】================

=============== 【UpdateRecord:中文English】================


❗ 该项目停更,转向使用 vuepress 构建笔记了


❗ 插件配置不兼容V1.x 以下版本

插件功能

  • 给页面H1-H6标题增加锚点效果
  • 浮动导航模式
  • 页面内顶部导航模式
  • 导航标题前的层级图标是否显示,自定义H1-H3的层级图标
  • plugins["theme-default"],页面标题层级与官方默认主题的showLevel层级关联
  • plugins["theme-default"],插件样式支持官网默认主题的三种样式:White、Sepia、Night
  • 在页面中增加<extoc></extoc>标签,会在此处生成TOC目录
  • 在页面中增加<!-- ex_nonav -->标签,不会在该页面生成悬浮导航
  • config.printLog=true,打印当前的处理进度,排错很有用
  • config.multipleH1=false,去掉丑陋的多余的1. 序号(如过您的书籍遵循一个MD文件只有一个H1标签的话)
  • config.showGoTop=true,显示返回顶部按钮 V1.0.11+
  • config.float.floatIcon 可以配置浮动导航的悬浮图标样式 V1.0.12+
  • 在页面中增加<!-- ex_nolevel -->不会在该页面生成层级序号 V1.0.12+

插件效果

怎么使用插件?

在你的 book.json 中增加插件:

{
  "plugins": [
       "anchor-navigation-ex"
  ]
}

然后安装插件:

$ gitbook install ./

就可以使用了,插件详细配置,请点击这里查看

或则单独安装插件

$ npm install gitbook-plugin-anchor-navigation-ex --save

open npm : https://www.npmjs.com/package/gitbook-plugin-anchor-navigation-ex

致敬

本插件集合以下插件的功能,并重写。

  1. https://github.com/zhangzq/gitbook-plugin-navigator
  2. https://github.com/yaneryou/gitbook-plugin-anchor-navigation