2016-07-05 8 views
2

私はSpring Rest Docsを使用してドキュメントを生成しています。私はBootstrapのTogglable tabsのようなことをしたいと思います。AsciiDoc(Spring Rest Docs)のタブを使用

春のドキュメントでは切り替え可能なタブが使用されていますが、その方法はわかりません。以下はその例です(MockMvc/REST Assured):http://docs.spring.io/spring-restdocs/docs/1.1.0.RELEASE/reference/html5/#documenting-your-api ありがとうございました。

答えて

7

Asciidoctorのタブはビルトインサポートされていませんが、非常に拡張性が高いため、この種のものを簡単に追加できます。

Spring REST Docsのドキュメントのタブは、Groovy、CSS、およびJavascriptを使用して小さな拡張として実装されています。コードを見たい場合は、this commitに追加されています。

このコミットが行われたので、拡張機能はseparate projectに移動されました。このプロジェクトのリリースはhttps://repo.spring.io/releaseから入手できます。拡張機能の使い方の詳細については、READMEをご覧ください。

+0

これは良いことですが、Andy。 Spring REST Docsで独自のドキュメントを生成する際に、この手法を使用する例がありますか? – Gary

+1

私が最初にこの回答を書いた後、その拡張は別のプロジェクトに移されました。私はプロジェクトへのリンクで答えを更新しました。 READMEは、その使用方法の例を示しています。 –

+0

さて、アンディ。これは素晴らしいです。私は昨日、その古いコミットを見て、このようなことをやろうと考えていました。もう一度、春のチームはいくつかのステップを進んでいます... – Gary

関連する問題