feat: add version parameter to allow version override

Close #107
asyncapi · Feb 15, 2021 · 3cda680 · 3cda680
1 parent b1cd9a0
commit 3cda680
Show file tree

Hide file tree

Showing 6 changed files with 23 additions and 4 deletions.
diff --git 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 version of your application provided under `info.version` location in the specification file.|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
@@ -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
@@ -84,6 +84,10 @@
         "description": "Sets the base URL for links and forms.",
         "required": false
       },
+      "version": {
+        "description": "Override the version of your application provided under `info.version` location in the specification file.",
+        "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
@@ -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
@@ -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>
+</div>
diff --git 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">