如何在 Spring RestDoc (asciidoc) 中折叠 TOC(目录)? [英] How to collapse TOC(table of contents) in spring RestDoc (asciidoc)?

查看:33
本文介绍了如何在 Spring RestDoc (asciidoc) 中折叠 TOC(目录)?的处理方法,对大家解决问题具有一定的参考价值,需要的朋友们下面随着小编来一起学习吧!

问题描述

我使用过 SpringRestDoc 并且想要折叠目录.

在我的index.adoc

下面

= Service Rest Docs API 文档:doctype: 书:icons: 字体:source-highlighter: highlightjs:toc2: 左:主题: 断然:toclevels: 1:sectlinks:[[介绍]]==信息----弹簧休息文件----...

谢谢,

解决方案

Asciidoctor 的默认模板不包括展开/折叠 ToC 的功能.您需要添加自己的 CSS/JavaScript 才能实现该目标.

最简单的方法是使用docinfo"文件.请参阅 https://docs.asciidoctor.org/asciidoctor/latest/docinfo/详情.

这是一个非常简单的实现来演示这个概念:

  1. 在您的文档的标题中(例如,就在 :doctype: 属性定义下),添加行 :docinfo: shared.

  2. 创建一个名为docinfo.html"的文件;在与您的文档相同的文件夹中;此文件包含您的自定义 CSS 和 JavaScript.

  3. docinfo.html文件中添加如下内容: