[docs] Upgrade to Docusaurus 2 (#5271)

* [docs] Upgrade to Docusaurus 2

Due to formatting issues with Docusaurus 1 and code blocks, and upcoming
4.3 and 5.0 releases, this is an upgrade to have more control over
formatting and other functionality.

This adds behavior to have light/dark themes.

As a consequence of upgrading, columnar format on ul element in
generated generator docs had to be moved to css. This will not impact
users viewing the markdown on GitHub because it didn't display the
column format.

This upgrade should improve syntax highlighting and performance.

* Fix user page layout, choose theme with clear diff colors

Author: jimschubert

docs/3.0.0-release-note.md

@@ -1,7 +1,7 @@
 ---
 id: release-3-0-0
-title: Release Notes: 3.0.0
-sidebar_label: Release Notes: 3.0.0
+title: "Release Notes: 3.0.0"
+sidebar_label: "Release Notes: 3.0.0"
 ---
 
 * ## Docker

docs/customization.md

@@ -3,7 +3,7 @@ id: customization
 title: Customization
 ---
 
-<a id="creating-a-new-template"></a><!-- maintain old link ref name.-->
+<a id="creating-a-new-template"></a>
 ## Custom Generator (and Template)
 
 If none of the built-in generators suit your needs and you need to do more than just modify the mustache templates to tweak generated code, you can create a brand new generator and its associated templates. OpenAPI Generator can help with this, using the `meta` command:

docs/faq-contributing.md

@@ -1,6 +1,6 @@
 ---
 id: faq-contributing
-title: FAQ: Contributing
+title: "FAQ: Contributing"
 ---
 
 ## Automated checks on my PR have failed. Do you know what's wrong?

docs/faq-extending.md

@@ -1,6 +1,6 @@
 ---
 id: faq-extending
-title: FAQ: Extending
+title: "FAQ: Extending"
 ---
 
 ## How do I use my own Java models?

docs/faq-generators.md

@@ -1,6 +1,6 @@
 ---
 id: faq-generators
-title: FAQ: Generators
+title: "FAQ: Generators"
 ---
 
 ### What are some server generator use cases?

docs/faq.md

@@ -1,6 +1,6 @@
 ---
 id: faq
-title: FAQ: General
+title: "FAQ: General"
 ---
 
 ## Do you have a chat room?

docs/generators/ada-server.md

@@ -26,7 +26,8 @@ sidebar_label: ada-server
 
 ## LANGUAGE PRIMITIVES
 
-<ul data-columns="2" style="list-style-type: disc;-webkit-columns:2;-moz-columns:2;columns:2;-moz-column-fill:auto;column-fill:auto"><li>Boolean</li>
+<ul class="column-ul">
+<li>Boolean</li>
 <li>Character</li>
 <li>Integer</li>
 <li>boolean</li>
@@ -38,7 +39,8 @@ sidebar_label: ada-server
 
 ## RESERVED WORDS
 
-<ul data-columns="2" style="list-style-type: disc;-webkit-columns:2;-moz-columns:2;columns:2;-moz-column-fill:auto;column-fill:auto"><li>abort</li>
+<ul class="column-ul">
+<li>abort</li>
 <li>abs</li>
 <li>abstract</li>
 <li>accept</li>

docs/generators/ada.md

@@ -26,7 +26,8 @@ sidebar_label: ada
 
 ## LANGUAGE PRIMITIVES
 
-<ul data-columns="2" style="list-style-type: disc;-webkit-columns:2;-moz-columns:2;columns:2;-moz-column-fill:auto;column-fill:auto"><li>Boolean</li>
+<ul class="column-ul">
+<li>Boolean</li>
 <li>Character</li>
 <li>Integer</li>
 <li>boolean</li>
@@ -38,7 +39,8 @@ sidebar_label: ada
 
 ## RESERVED WORDS
 
-<ul data-columns="2" style="list-style-type: disc;-webkit-columns:2;-moz-columns:2;columns:2;-moz-column-fill:auto;column-fill:auto"><li>abort</li>
+<ul class="column-ul">
+<li>abort</li>
 <li>abs</li>
 <li>abstract</li>
 <li>accept</li>

docs/generators/android.md

@@ -15,7 +15,7 @@ sidebar_label: android
 |ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
 |groupId|groupId for use in the generated build.gradle and pom.xml| |null|
 |invokerPackage|root package for generated code| |null|
-|library|library template (sub-template) to use|<dl><dt>**volley**</dt><dd>HTTP client: Volley 1.0.19 (default)</dd><dt>**httpclient**</dt><dd>HTTP client: Apache HttpClient 4.3.6. JSON processing: Gson 2.3.1. IMPORTANT: Android client using HttpClient is not actively maintained and will be depecreated in the next major release.</dd><dl>|null|
+|library|library template (sub-template) to use|<dl><dt>**volley**</dt><dd>HTTP client: Volley 1.0.19 (default)</dd><dt>**httpclient**</dt><dd>HTTP client: Apache HttpClient 4.3.6. JSON processing: Gson 2.3.1. IMPORTANT: Android client using HttpClient is not actively maintained and will be depecreated in the next major release.</dd></dl>|null|
 |modelPackage|package for generated models| |null|
 |prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|
 |serializableModel|boolean - toggle &quot;implements Serializable&quot; for generated models| |false|
@@ -56,7 +56,8 @@ sidebar_label: android
 
 ## LANGUAGE PRIMITIVES
 
-<ul data-columns="2" style="list-style-type: disc;-webkit-columns:2;-moz-columns:2;columns:2;-moz-column-fill:auto;column-fill:auto"><li>Boolean</li>
+<ul class="column-ul">
+<li>Boolean</li>
 <li>Double</li>
 <li>Float</li>
 <li>Integer</li>
@@ -69,7 +70,8 @@ sidebar_label: android
 
 ## RESERVED WORDS
 
-<ul data-columns="2" style="list-style-type: disc;-webkit-columns:2;-moz-columns:2;columns:2;-moz-column-fill:auto;column-fill:auto"><li>abstract</li>
+<ul class="column-ul">
+<li>abstract</li>
 <li>apiinvoker</li>
 <li>assert</li>
 <li>authnames</li>

docs/generators/apache2.md

@@ -42,11 +42,13 @@ sidebar_label: apache2
 
 ## LANGUAGE PRIMITIVES
 
-<ul data-columns="2" style="list-style-type: disc;-webkit-columns:2;-moz-columns:2;columns:2;-moz-column-fill:auto;column-fill:auto"></ul>
+<ul class="column-ul">
+</ul>
 
 ## RESERVED WORDS
 
-<ul data-columns="2" style="list-style-type: disc;-webkit-columns:2;-moz-columns:2;columns:2;-moz-column-fill:auto;column-fill:auto"></ul>
+<ul class="column-ul">
+</ul>
 
 ## FEATURE SET