doc update for v1.6.8

Author: bnasslahsen

docs/faq.html

@@ -634,6 +634,21 @@ <h3 id="_how_can_i_customise_the_openapi_object">How can I customise the OpenAPI
 }</code></pre>
 </div>
 </div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+This bean <code>OpenApiCustomizer</code> will be applied to the Default OpenAPI only.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>If you need the <code>OpenApiCustomizer</code> to applied to <code>GroupedOpenApi</code> as well, then use <code>GlobalOpenApiCustomiser</code> instead.</p>
+</div>
 </div>
 <div class="sect2">
 <h3 id="_how_can_i_return_an_empty_content_as_response">How can I return an empty content as response?</h3>
@@ -1746,12 +1761,100 @@ <h3 id="_how_can_i_define_different_description_for_a_class_attribute_depending_
 </div>
 </div>
 <div class="sect2">
+<h3 id="_customizing_swagger_static_resources">Customizing swagger static resources</h3>
+<div class="paragraph">
+<p>You can customize swagger documentation static resources located in <code>META-INF/resources/webjars/swagger-ui/{swagger.version}/</code>. The list of resources includes:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>index.html</code></p>
+</li>
+<li>
+<p><code>swagger-ui-bundle.js</code></p>
+</li>
+<li>
+<p><code>swagger-ui.css</code></p>
+</li>
+<li>
+<p><code>swagger-ui-standalone-preset.js</code></p>
+</li>
+<li>
+<p><code>swagger-ui.css.map</code></p>
+</li>
+<li>
+<p><code>swagger-ui-bundle.js.map</code></p>
+</li>
+<li>
+<p><code>swagger-ui-standalone-preset.js.map</code></p>
+</li>
+<li>
+<p><code>favicon-32x32.png</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>To do this, you need to extend the implementation of <code>SwaggerIndexPageTransformer</code></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">public class SwaggerCodeBlockTransformer
+       extends SwaggerIndexPageTransformer {
+  // &lt; constructor &gt;
+  @Override
+  public Resource transform(HttpServletRequest request,
+                            Resource resource,
+                            ResourceTransformerChain transformer)
+                            throws IOException {
+      if (resource.toString().contains("swagger-ui.css")) {
+          final InputStream is = resource.getInputStream();
+          final InputStreamReader isr = new InputStreamReader(is);
+          try (BufferedReader br = new BufferedReader(isr)) {
+              final String css = br.lines().collect(Collectors.joining());
+              final byte[] transformedContent = css.replace("old", "new").getBytes();
+              return  new TransformedResource(resource, transformedContent);
+          } // AutoCloseable br &gt; isr &gt; is
+      }
+      return super.transform(request, resource, transformer);
+  }
+
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Next, add transformer <code>@Bean</code> to your <code>@Configuration</code></p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">@Configuration
+public class OpenApiConfig {
+    @Bean
+    public SwaggerIndexTransformer swaggerIndexTransformer(
+            SwaggerUiConfigProperties a,
+            SwaggerUiOAuthProperties b,
+            SwaggerUiConfigParameters c,
+            SwaggerWelcomeCommon d) {
+        return new SwaggerCodeBlockTransformer(a, b, c, d);
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Illustrative example</p>
+</div>
+<div class="imageblock">
+<div class="content">
+<img src="images/static_content_transformation.png" alt="Illustrative example">
+</div>
+</div>
+</div>
+<div class="sect2">
 <h3 id="_what_is_the_compatibility_matrix_of_springdoc_openapi_with_spring_boot">What is the compatibility matrix of <code>springdoc-openapi</code> with <code>spring-boot</code> ?</h3>
 <div class="paragraph">
 <p><code>springdoc-openapi</code> is compatible with <code>spring-boot 1</code> and <code>spring-boot 2</code>.</p>
 </div>
 <div class="paragraph">
-<p>In general, <strong>you should only pick the last stable version as per today 1.6.7.</strong></p>
+<p>In general, <strong>you should only pick the last stable version as per today 1.6.8.</strong></p>
 </div>
 <div class="paragraph">
 <p>More precisely, this the exhaustive list of spring-boot versions against which <code>springdoc-openapi</code> has been built:</p>
@@ -1798,7 +1901,7 @@ <h3 id="_what_is_the_compatibility_matrix_of_springdoc_openapi_with_spring_boot"
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2022-04-08 19:19:25 +0200
+Last updated 2022-04-22 02:32:02 +0200
 </div>
 </div>
 <script src="js/highlight/highlight.min.js"></script>

docs/getting-started.html

@@ -30,7 +30,7 @@ <h2 id="getting-started">Getting Started</h2>
 <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-ui&lt;/artifactId&gt;
-      &lt;version&gt;1.6.7&lt;/version&gt;
+      &lt;version&gt;1.6.8&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>