/** * Builds snippet URI for the given {@code operation} and {@code snippetName}.<br> * Default implementation use {@code <snippetBaseUri>/<normalizeName(<operation id>)>/<snippetName>.<markup ext>}.<br> * You can override this method to configure your own folder normalization. * * @param context current context * @param operation current operation * @return subdirectory normalized name */ public URI operationSnippetUri(Context context, PathOperation operation, String snippetName) { return snippetBaseUri.resolve(IOUtils.normalizeName(operation.getId()) + "/").resolve(context.getMarkupDocBuilder().addFileExtension(snippetName)); }
public void snippetSection(Context context, String snippetName, String title) { ContentExtension content = new ContentExtension(globalContext, context); URI snippetUri = operationSnippetUri(context, context.getOperation().get(), snippetName); logger.info("Processing Spring REST Docs snippet: {}", snippetUri.toString()); content.importContent(snippetUri, reader -> { context.getMarkupDocBuilder().sectionTitleLevel(1 + levelOffset(context), title); context.getMarkupDocBuilder().importMarkup(reader, extensionMarkupLanguage, levelOffset(context) + 1); }); } }