From 524406b710569f07e879fe21750c9245420f0276 Mon Sep 17 00:00:00 2001
From: Ludovic Dussart <ludovic.dussart@ineat-conseil.fr>
Date: Fri, 12 Feb 2021 16:39:36 +0100
Subject: [PATCH] feat: add version parameter to allow version override

Close #107
---
 README.md                  | 1 +
 macros/commons.html        | 8 ++++++++
 package.json               | 4 ++++
 partials/introduction.html | 5 ++++-
 partials/sidebar.html      | 5 +++--
 template/index.html        | 4 +++-
 6 files changed, 23 insertions(+), 4 deletions(-)
 create mode 100644 macros/commons.html

diff --git a/README.md b/README.md
index 9093a3507..c09726279 100644
--- a/README.md
+++ b/README.md
@@ -21,6 +21,7 @@ npm install -g @asyncapi/generator
 |---|---|---|---|---|
 |sidebarOrganization|Defines how the sidebar should be organized. Set its value to `byTagsNoRoot` to categorize operations by operations tags. Set its value to `byTags` when you have tags on a root level. These tags are used to model tags navigation and need to have the same tags in operations.|No|`byTags`, `byTagsNoRoot`|`byTagsNoRoot`|
 |baseHref|Sets the base URL for links and forms.|No|*Any*|`/docs`|
+|version|Override the Async API version displayed in the generated pages.|No|*Any* ([See Semver versionning](https://semver.org/))|`1.0.0`|
 |singleFile|Set output into one html-file with styles and scripts inside|No|`true`,`false`|`true`|
 |outFilename|The filename of the output file.|No|*Any*|`asyncapi.html`|
 |pdf|Generates output HTML as PDF|No|`true,false`|`false`|
diff --git a/macros/commons.html b/macros/commons.html
new file mode 100644
index 000000000..040979974
--- /dev/null
+++ b/macros/commons.html
@@ -0,0 +1,8 @@
+{% macro getApiVersion() %}
+    {% if params.version %}
+    {% set version = params.version %}
+    {% else %}
+    {% set version = asyncapi.info().version() %}
+    {% endif %}
+    <span>{{version}}</span>
+{% endmacro %}
diff --git a/package.json b/package.json
index 4e1b573e7..bedd869fb 100644
--- a/package.json
+++ b/package.json
@@ -84,6 +84,10 @@
         "description": "Sets the base URL for links and forms.",
         "required": false
       },
+      "version": {
+        "description": "Override the Async API version displayed in the generated pages.",
+        "required": false
+      },
       "singleFile": {
         "description": "If set this parameter to true generate single html file with scripts and styles inside",
         "required": false,
diff --git a/partials/introduction.html b/partials/introduction.html
index 3f7050f9a..feb6b4f8d 100644
--- a/partials/introduction.html
+++ b/partials/introduction.html
@@ -1,6 +1,9 @@
+{% from "macros/commons.html" import getApiVersion with context %}
+
 <div class="center-block p-8">
   <a name="introduction"></a>
-  <h1>{{asyncapi.info().title()}} {{asyncapi.info().version()}}</h1>
+
+  <h1>{{asyncapi.info().title()}} {{getApiVersion()}}</h1>
   <div class="leading-normal mb-4">
     {% if asyncapi.info().termsOfService() %}
     <a class="border border-solid border-purple-300 hover:bg-purple-300 hover:text-purple-600 font-bold no-underline text-purple-500 text-xs uppercase rounded mr-2 px-3 py-1"
diff --git a/partials/sidebar.html b/partials/sidebar.html
index 7c693e774..ab1138469 100644
--- a/partials/sidebar.html
+++ b/partials/sidebar.html
@@ -1,4 +1,5 @@
 {% from "./sliced-string.html" import slicedString %}
+{% from "macros/commons.html" import getApiVersion with context %}
 
 <input id="burger-menu" type="checkbox" />
 <label for="burger-menu" class="shadow">
@@ -15,7 +16,7 @@
       <img src="{{ asyncapi.info().ext('x-logo') }}" alt="{{ asyncapi.info().title() }} logo">
     {% else %}
       <h1 class="text-2xl font-thin">
-        {{ asyncapi.info().title() }} {{ asyncapi.info().version() }}
+        {{ asyncapi.info().title() }} {{ getApiVersion() }}
       </h1>
     {% endif %}
     <ul class="text-sm mt-10 list-reset mt-2">
@@ -92,4 +93,4 @@ <h2 class="text-xs uppercase text-gray-500 mt-10 mb-4 font-thin">Messages</h2>
       </ul>
     {% endif %}
   </div>
-</div>
\ No newline at end of file
+</div>
diff --git a/template/index.html b/template/index.html
index 631dbc93a..4f8feb08b 100644
--- a/template/index.html
+++ b/template/index.html
@@ -1,11 +1,13 @@
 <!DOCTYPE html>
+{% from "macros/commons.html" import getApiVersion with context %}
 <html lang="en">
 <head>
   <meta charset="UTF-8">
   {% if params.baseHref %}
    <base href="{{params.baseHref}}">
   {% endif %}
-  <title>{{asyncapi.info().title()}} {{asyncapi.info().version()}} documentation</title>
+
+  <title>{{asyncapi.info().title()}} {{getApiVersion()}} documentation</title>
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   {% if params.singleFile %}
     <style type="text/css">