解决GitBook不支持[TOC]生成的本页目录

2024-08-21 04:32

本文主要是介绍解决GitBook不支持[TOC]生成的本页目录,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

问题如下

在编写GitBook的过程中,不可能避免有些篇章会篇幅比较长,此时就会想到markdown有个[TOC]可以生成目录。
但是在使用GitBook运行服务gitbook serve打开页面的时候,却是不支持的,如下图:

13423234-dc49ca8a8e2c649c.png

正常文档中的显示如下:

13423234-ffa8a0507a2017a5.png

那么有没有什么好办法去处理呢?

解决方法

发现Github的一个项目https://github.com/ekalinin/github-markdown-toc能够帮助我解决这个问题。

安装方式

Linux

$ wget https://raw.githubusercontent.com/ekalinin/github-markdown-toc/master/gh-md-toc
$ chmod a+x gh-md-toc

OSX

$ curl https://raw.githubusercontent.com/ekalinin/github-markdown-toc/master/gh-md-toc -o gh-md-toc
$ chmod a+x gh-md-toc

首先我在Centos7安装好工具

[root@centos7 ~]# mkdir gh-md-toc
[root@centos7 ~]# cd gh-md-toc/
[root@centos7 gh-md-toc]# ls
[root@centos7 gh-md-toc]# wget https://raw.githubusercontent.com/ekalinin/github-markdown-toc/master/gh-md-toc
--2019-04-17 16:33:05--  https://raw.githubusercontent.com/ekalinin/github-markdown-toc/master/gh-md-toc
Resolving raw.githubusercontent.com (raw.githubusercontent.com)... 151.101.228.133
Connecting to raw.githubusercontent.com (raw.githubusercontent.com)|151.101.228.133|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 8039 (7.9K) [text/plain]
Saving to: ‘gh-md-toc’100%[======================================================================>] 8,039       16.9KB/s   in 0.5s   2019-04-17 16:33:07 (16.9 KB/s) - ‘gh-md-toc’ saved [8039/8039][root@centos7 gh-md-toc]# ls
gh-md-toc
[root@centos7 gh-md-toc]# chmod a+x gh-md-toc
[root@centos7 gh-md-toc]# 
[root@centos7 gh-md-toc]# ls -ll -h
total 8.0K
-rwxr-xr-x 1 root root 7.9K Apr 17 16:33 gh-md-toc
[root@centos7 gh-md-toc]# 

使用gh-md-toc生成目录

用法:./gh-md-toc 文件.md

[root@centos7 gh-md-toc]# ls
Chapter6.zip  gh-md-toc
[root@centos7 gh-md-toc]# unzip Chapter6.zip 
Archive:  Chapter6.zipinflating: 集群节点缩容演练.md  inflating: 集群节点扩容演练.md  
[root@centos7 gh-md-toc]# 
[root@centos7 gh-md-toc]# ls
Chapter6.zip  gh-md-toc  集群节点扩容演练.md  集群节点缩容演练.md
[root@centos7 gh-md-toc]# 
[root@centos7 gh-md-toc]# ./gh-md-toc 集群节点扩容演练.md Table of Contents
=================* [第2节:集群节点扩容演练](#第2节集群节点扩容演练)* [演练场景说明](#演练场景说明)* [演练步骤](#演练步骤)* [部署一主一从、双哨兵](#部署一主一从双哨兵)* [配置Master(M1)](#配置masterm1)* [配置Slave(R1)](#配置slaver1)* [查看主从情况](#查看主从情况)* [测试主从写入数据](#测试主从写入数据)* [配置双sentinel(S1/S2) 的关键配置](#配置双sentinels1s2-的关键配置)* [sentinel (S1) 的配置](#sentinel-s1-的配置)* [sentinel (S2) 的配置](#sentinel-s2-的配置)* [master故障](#master故障)* [模拟master服务故障](#模拟master服务故障)* [sentinel的日志](#sentinel的日志)* [查看原slave redis(R2)服务是否已经promotion为master节点](#查看原slave-redisr2服务是否已经promotion为master节点)* [恢复原master redis节点服务,查看是否转为slave redis](#恢复原master-redis节点服务查看是否转为slave-redis)* [启动原master redis节点服务](#启动原master-redis节点服务)* [sentinel的日志](#sentinel的日志-1)* [检查主从切换后的role以及数据写入情况](#检查主从切换后的role以及数据写入情况)* [调整双哨兵 quorum = 2](#调整双哨兵-quorum--2)* [修改第一个sentinel(S1)服务](#修改第一个sentinels1服务)* [修改第二个sentinel(S2)服务](#修改第二个sentinels2服务)* [新增服务器配置 slave redis (R3) 以及 sentinel (S3) 加入集群](#新增服务器配置-slave-redis-r3-以及-sentinel-s3-加入集群)* [新增slave redis(R3)](#新增slave-redisr3)* [新增第三个sentinel(S3)服务](#新增第三个sentinels3服务)* [验证扩容节点之后的数据同步](#验证扩容节点之后的数据同步)* [查看新增的slave redis(R3)数据的同步情况](#查看新增的slave-redisr3数据的同步情况)* [往master节点写入新数据](#往master节点写入新数据)* [查看R3是否同步数据](#查看r3是否同步数据)Created by [gh-md-toc](https://github.com/ekalinin/github-markdown-toc)
[root@centos7 gh-md-toc]# 

将生成的目录数据拷贝到md中

13423234-d302a71a609c6dc0.png

再使用gitbook serve展示看看

13423234-cc71922b3da95520.png

算是可以了,点击也可以跳转至对应的标题下。

13423234-9e26a8e440e466ab.png

这篇关于解决GitBook不支持[TOC]生成的本页目录的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1092127

相关文章

Nginx 配置跨域的实现及常见问题解决

《Nginx配置跨域的实现及常见问题解决》本文主要介绍了Nginx配置跨域的实现及常见问题解决,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来... 目录1. 跨域1.1 同源策略1.2 跨域资源共享(CORS)2. Nginx 配置跨域的场景2.1

qt5cored.dll报错怎么解决? 电脑qt5cored.dll文件丢失修复技巧

《qt5cored.dll报错怎么解决?电脑qt5cored.dll文件丢失修复技巧》在进行软件安装或运行程序时,有时会遇到由于找不到qt5core.dll,无法继续执行代码,这个问题可能是由于该文... 遇到qt5cored.dll文件错误时,可能会导致基于 Qt 开发的应用程序无法正常运行或启动。这种错

SpringBoot排查和解决JSON解析错误(400 Bad Request)的方法

《SpringBoot排查和解决JSON解析错误(400BadRequest)的方法》在开发SpringBootRESTfulAPI时,客户端与服务端的数据交互通常使用JSON格式,然而,JSON... 目录问题背景1. 问题描述2. 错误分析解决方案1. 手动重新输入jsON2. 使用工具清理JSON3.

华为鸿蒙HarmonyOS 5.1官宣7月开启升级! 首批支持名单公布

《华为鸿蒙HarmonyOS5.1官宣7月开启升级!首批支持名单公布》在刚刚结束的华为Pura80系列及全场景新品发布会上,除了众多新品的发布,还有一个消息也点燃了所有鸿蒙用户的期待,那就是Ha... 在今日的华为 Pura 80 系列及全场景新品发布会上,华为宣布鸿蒙 HarmonyOS 5.1 将于 7

MySQL 设置AUTO_INCREMENT 无效的问题解决

《MySQL设置AUTO_INCREMENT无效的问题解决》本文主要介绍了MySQL设置AUTO_INCREMENT无效的问题解决,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参... 目录快速设置mysql的auto_increment参数一、修改 AUTO_INCREMENT 的值。

关于跨域无效的问题及解决(java后端方案)

《关于跨域无效的问题及解决(java后端方案)》:本文主要介绍关于跨域无效的问题及解决(java后端方案),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录通用后端跨域方法1、@CrossOrigin 注解2、springboot2.0 实现WebMvcConfig

Go语言中泄漏缓冲区的问题解决

《Go语言中泄漏缓冲区的问题解决》缓冲区是一种常见的数据结构,常被用于在不同的并发单元之间传递数据,然而,若缓冲区使用不当,就可能引发泄漏缓冲区问题,本文就来介绍一下问题的解决,感兴趣的可以了解一下... 目录引言泄漏缓冲区的基本概念代码示例:泄漏缓冲区的产生项目场景:Web 服务器中的请求缓冲场景描述代码

解决JSONField、JsonProperty不生效的问题

《解决JSONField、JsonProperty不生效的问题》:本文主要介绍解决JSONField、JsonProperty不生效的问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑... 目录jsONField、JsonProperty不生效javascript问题排查总结JSONField

github打不开的问题分析及解决

《github打不开的问题分析及解决》:本文主要介绍github打不开的问题分析及解决,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、找到github.com域名解析的ip地址二、找到github.global.ssl.fastly.net网址解析的ip地址三

Linux使用scp进行远程目录文件复制的详细步骤和示例

《Linux使用scp进行远程目录文件复制的详细步骤和示例》在Linux系统中,scp(安全复制协议)是一个使用SSH(安全外壳协议)进行文件和目录安全传输的命令,它允许在远程主机之间复制文件和目录,... 目录1. 什么是scp?2. 语法3. 示例示例 1: 复制本地目录到远程主机示例 2: 复制远程主