From 076fca15a44847762a53e200a60de25c706590c6 Mon Sep 17 00:00:00 2001
From: Roman Hotsiy <gotsijroman@gmail.com>
Date: Thu, 2 Feb 2017 23:08:04 +0200
Subject: [PATCH] Render externalDocs (resolves #103)

---
 lib/components/ApiInfo/api-info.html         |  1 +
 lib/components/ExternalDocs/external-docs.ts | 18 ++++++++++++++++++
 lib/components/Method/method.html            |  1 +
 lib/components/Method/method.ts              |  7 ++++++-
 lib/components/MethodsList/methods-list.html |  1 +
 lib/components/index.ts                      |  5 +++--
 lib/services/menu.service.ts                 |  4 ++--
 7 files changed, 32 insertions(+), 5 deletions(-)
 create mode 100644 lib/components/ExternalDocs/external-docs.ts

diff --git a/lib/components/ApiInfo/api-info.html b/lib/components/ApiInfo/api-info.html
index b13a3b75..e11178c8 100644
--- a/lib/components/ApiInfo/api-info.html
+++ b/lib/components/ApiInfo/api-info.html
@@ -16,6 +16,7 @@
       <a *ngIf="info.license.url" href="{{info.license.url}}"> {{info.license.name}} </a>
       <span *ngIf="!info.license.url"> {{info.license.name}} </span>
     </span>
+    <redoc-externalDocs [docs]="componentSchema.externalDocs"></redoc-externalDocs>
   </p>
   <span class="redoc-markdown-block">
     <dynamic-ng2-viewer  [html]="info['x-redoc-html-description']"></dynamic-ng2-viewer>
diff --git a/lib/components/ExternalDocs/external-docs.ts b/lib/components/ExternalDocs/external-docs.ts
new file mode 100644
index 00000000..08871cf7
--- /dev/null
+++ b/lib/components/ExternalDocs/external-docs.ts
@@ -0,0 +1,18 @@
+'use strict';
+import { Component, Input, ChangeDetectionStrategy, OnInit } from '@angular/core';
+import { BaseComponent, SpecManager } from '../base';
+
+@Component({
+  selector: 'redoc-externalDocs',
+  template: `<a *ngIf="docs" [href]="docs.url" [innerHtml]="docs.description | marked"></a>`,
+  changeDetection: ChangeDetectionStrategy.OnPush
+})
+export class ExternalDocs implements OnInit {
+  @Input() docs;
+
+  ngOnInit() {
+    if (this.docs && !this.docs.description) {
+      this.docs.description = 'External Docs';
+    }
+  }
+}
diff --git a/lib/components/Method/method.html b/lib/components/Method/method.html
index d9b1afe6..c031ca74 100644
--- a/lib/components/Method/method.html
+++ b/lib/components/Method/method.html
@@ -9,6 +9,7 @@
     <p *ngIf="method.info.description" class="method-description"
     [innerHtml]="method.info.description | marked">
     </p>
+    <redoc-externalDocs [docs]="method.externalDocs"></redoc-externalDocs>
     <params-list pointer="{{pointer}}/parameters"> </params-list>
     <responses-list pointer="{{pointer}}/responses"> </responses-list>
   </div>
diff --git a/lib/components/Method/method.ts b/lib/components/Method/method.ts
index 7067b4c8..852290bb 100644
--- a/lib/components/Method/method.ts
+++ b/lib/components/Method/method.ts
@@ -17,6 +17,10 @@ interface MethodInfo {
   bodyParam: any;
   summary: any;
   anchor: any;
+  externalDocs: {
+    url: string;
+    description?: string;
+  }
 }
 
 @Component({
@@ -50,7 +54,8 @@ export class Method extends BaseComponent implements OnInit {
       bodyParam: this.findBodyParam(),
       summary: SchemaHelper.methodSummary(this.componentSchema),
       apiUrl: this.getBaseUrl(),
-      anchor: this.buildAnchor()
+      anchor: this.buildAnchor(),
+      externalDocs: this.componentSchema.externalDocs
     };
   }
 
diff --git a/lib/components/MethodsList/methods-list.html b/lib/components/MethodsList/methods-list.html
index 18a833c8..7daccd7c 100644
--- a/lib/components/MethodsList/methods-list.html
+++ b/lib/components/MethodsList/methods-list.html
@@ -3,6 +3,7 @@
     <div class="tag-info" *ngIf="tag.name">
       <h1 class="sharable-header"> <a class="share-link" href="#{{tag.id}}"></a>{{tag.name}} </h1>
       <p *ngIf="tag.description" [innerHtml]="tag.description | marked"> </p>
+      <redoc-externalDocs [docs]="tag.metadata.externalDocs"></redoc-externalDocs>
     </div>
     <method *lazyFor="let methodItem of tag.items; let ready = ready;"
     [hidden]="!ready" [pointer]="methodItem.metadata.pointer"
diff --git a/lib/components/index.ts b/lib/components/index.ts
index ecf74a79..f26d2f10 100644
--- a/lib/components/index.ts
+++ b/lib/components/index.ts
@@ -16,15 +16,16 @@ import { Warnings } from './Warnings/warnings';
 import { SecurityDefinitions } from './SecurityDefinitions/security-definitions';
 import { LoadingBar } from './LoadingBar/loading-bar';
 import { RedocSearch } from './Search/redoc-search';
+import { ExternalDocs } from './ExternalDocs/external-docs';
 
 import { Redoc } from './Redoc/redoc';
 
 export const REDOC_DIRECTIVES = [
   ApiInfo, ApiLogo, JsonSchema, JsonSchemaLazy, ParamsList, RequestSamples, ResponsesList,
   ResponsesSamples, SchemaSample, SideMenu, MethodsList, Method, Warnings, Redoc, SecurityDefinitions,
-  LoadingBar, SideMenuItems, RedocSearch
+  LoadingBar, SideMenuItems, RedocSearch, ExternalDocs
 ];
 
 export { ApiInfo, ApiLogo, JsonSchema, JsonSchemaLazy, ParamsList, RequestSamples, ResponsesList,
 ResponsesSamples, SchemaSample, SideMenu, MethodsList, Method, Warnings, Redoc, SecurityDefinitions,
-LoadingBar, SideMenuItems, RedocSearch }
+LoadingBar, SideMenuItems, RedocSearch, ExternalDocs }
diff --git a/lib/services/menu.service.ts b/lib/services/menu.service.ts
index c6c279c3..348aead3 100644
--- a/lib/services/menu.service.ts
+++ b/lib/services/menu.service.ts
@@ -107,7 +107,7 @@ export class MenuService {
 
   makeSureLastItemsEnabled() {
     let lastIdx = this.flatItems.length - 1;
-    let item = this.flatItems[lastIdx]
+    let item = this.flatItems[lastIdx];
     while(item && (!item.metadata || !item.items)) {
       item.ready = true;
       item = this.flatItems[lastIdx -= 1];
@@ -357,7 +357,7 @@ export class MenuService {
         name: tag['x-displayName'] || tag.name,
         id: id,
         description: tag.description,
-        metadata: { type: 'tag' },
+        metadata: { type: 'tag', externalDocs: tag.externalDocs },
         parent: parent,
         items: null
       };