support multiple versions

Author: rigor789

build/index.js

@@ -23,6 +23,7 @@ const permalinks = require('./plugins/permalinks');
 const changeExt = require('./plugins/change-ext');
 const markdown = require('./plugins/remark');
 const locales = require('./plugins/locales');
+const versions  = require('./plugins/versions');
 const layouts = require('./plugins/layouts');
 const order = require('./plugins/order');
 const toc = require('./plugins/toc');
@@ -116,6 +117,16 @@ Metalsmith(cwd)
     defaultLocale: 'en',
     locales: ['en', 'ko', 'pt-BR', 'ru']
   }))
+  .use(versions({
+    versions: [
+      { name: 'latest', url: '//nativescript-vue.org' },
+      { name: 'v1.3.1', url: '//v1.3.1.nativescript-vue.org' },
+    ],
+    currentVersion: {
+      name: 'latest',
+      branch: 'master'
+    } // different for each branch
+  }))
   .use(order())
   .use(categories())
   // group certain files into collections

build/plugins/versions.js

@@ -0,0 +1,14 @@
+function plugin(opts) {
+
+  return function (files, metalsmith, done) {
+    const meta = metalsmith.metadata();
+    // set global information about the available versions
+    meta.defaultVersions = opts.defaultVersion;
+    meta.versions = opts.versions;
+    meta.currentVersion = opts.currentVersion;
+
+    done();
+  }
+}
+
+module.exports = plugin;

content/docs/en/elements/components/label.md

@@ -18,7 +18,7 @@ contributors: [MisterBrownRSA, rigor789, eddyverbruggen, ikoevska]
 
 ### Styling the label
 
-If you need to style parts of the text, you can use a combination of a [`FormattedString`](https://docs.nativescript.org/cookbook/formatted-string-ng) and [`Span`](https://docs.nativescript.org/api-reference/classes/_text_span_.span) elements.
+If you need to style parts of the text, you can use a combination of a [`FormattedString`](https://docs.nativescript.org/angular/ui/ng-ui-widgets/formatted-string) and [`Span`](https://docs.nativescript.org/api-reference/classes/_text_span_.span) elements.
 
 ```html
 <Label textWrap="true">

content/docs/en/getting-started/5-nativescript-plugins.md

@@ -5,7 +5,7 @@ contributors: [EddyVerbruggen, naderio, rigor789, ikoevska]
 
 Plugins work as in [any other NativeScript app](https://docs.nativescript.org/plugins/plugins), but you may wonder how *UI* plugins work with Vue.
 
-UI plugins work almost identically to how you'd [use a NativeScript UI plugin in an Angular app](https://docs.nativescript.org/angular/plugins/plugins). 
+UI plugins work almost identically to how you'd use a NativeScript UI plugin in an Angular app. 
 
 ## Sample use: nativescript-gradient
 

content/docs/en/routing/vue-router.md

@@ -109,6 +109,6 @@ Vue Router has more tricks up its sleeve, so be sure to visit [the official docu
 
 Check out the following [NativeScript-Vue samples](https://github.com/nativescript-vue/nativescript-vue/tree/master/samples):
 
-* [app-with-page-routing](nativescript-vue/samples/app/app-with-page-routing.js)
-* [app-with-router](nativescript-vue/samples/app/app-with-router.js)
-* [app-with-router-pages](nativescript-vue/samples/app/app-with-router-pages.js)
+* [app-with-page-routing](https://github.com/nativescript-vue/nativescript-vue/tree/master/samples/app/app-with-page-routing.js)
+* [app-with-router](https://github.com/nativescript-vue/nativescript-vue/tree/master/samples/app/app-with-router.js)
+* [app-with-router-pages](https://github.com/nativescript-vue/nativescript-vue/tree/master/samples/app/app-with-router-pages.js)

content/docs/ko/getting-started/4-templates.md

@@ -4,7 +4,7 @@ contributors: [qgp9]
 outdated: true
 ---
 
-여러분의 `nativescript-vue` 앱을 시작하기 위해 네이티브-스크립트의 [템플릿 시스템](https://docs.nativescript.org/tooling/app-templates)을 사용할 수 있습니다. 이 템플릿들은 `nativescript-vue` 플러그인을 사용하는 네이티브-스크립트 앱을 생성합니다. 어떤 템플릿들은 Vue.js 단일 파일 컴포넌트(`.vue`) 와 라이브-리로드(livereload) 지원과 같은 추가 기능이 내장되어 있습니다.
+여러분의 `nativescript-vue` 앱을 시작하기 위해 네이티브-스크립트의 템플릿 시스템 을 사용할 수 있습니다. 이 템플릿들은 `nativescript-vue` 플러그인을 사용하는 네이티브-스크립트 앱을 생성합니다. 어떤 템플릿들은 Vue.js 단일 파일 컴포넌트(`.vue`) 와 라이브-리로드(livereload) 지원과 같은 추가 기능이 내장되어 있습니다.
 
 ## nativescript-vue-template
 

content/docs/pt-BR/elements/components/label.md

@@ -18,7 +18,7 @@ contributors: [alexhiroshi]
 
 ### Estilizando o label
 
-Se você precisa estilizar partes do texto, use a combinação de elementos [`FormattedString`](https://docs.nativescript.org/cookbook/formatted-string-ng) e [`Span`](https://docs.nativescript.org/api-reference/classes/_text_span_.span).
+Se você precisa estilizar partes do texto, use a combinação de elementos [`FormattedString`](https://docs.nativescript.org/angular/ui/ng-ui-widgets/formatted-string) e [`Span`](https://docs.nativescript.org/api-reference/classes/_text_span_.span).
 
 ```html
 <Label textWrap="true">

content/docs/pt-BR/getting-started/5-nativescript-plugins.md

@@ -5,7 +5,7 @@ contributors: [alexhiroshi, WesleiRamos]
 
 Plugins funcionam como em qualquer outro aplicativo NativeScript, mas você pode ser pergunta como plugins de *UI* funcionaria com Vue.
 
-Plugins de UI funcionam quase da mesma forma como você usaria um plugin de UI do NativeScript em um [aplicativo com Angular](https://docs.nativescript.org/angular/plugins/plugins).
+Plugins de UI funcionam quase da mesma forma como você usaria um plugin de UI do NativeScript em um aplicativo com Angular.
 
 ## Uso de exemplo: nativescript-gradient
 

content/docs/ru/elements/components/label.md

@@ -18,7 +18,7 @@ contributors: [sn0wil]
 
 ### Стилизация элемента label
 
-Если вам необходимо применить стили, то вы можете использовать комбинацию элементов [`FormattedString`](https://docs.nativescript.org/cookbook/formatted-string-ng) и [`Span`](https://docs.nativescript.org/api-reference/classes/_text_span_.span).
+Если вам необходимо применить стили, то вы можете использовать комбинацию элементов [`FormattedString`](https://docs.nativescript.org/angular/ui/ng-ui-widgets/formatted-string) и [`Span`](https://docs.nativescript.org/api-reference/classes/_text_span_.span).
 
 ```html
 <Label textWrap="true">

layouts/_partials/header.ejs

@@ -4,10 +4,10 @@
    class="block bg-blue-light md:bg-green md:border-t-8 border-green p-4 md:p-0 text-center no-underline text-white">
    Jun 12: Building Better Apps with NativeScript 4.0
 </a>-->
-<a href="/blog/nativescript-vue-1.0-and-a-new-site/"
+<!--<a href="/blog/nativescript-vue-1.0-and-a-new-site/"
    class="block md:hidden bg-green p-2 text-center no-underline text-white">
     Announcing 1.0
-</a>
+</a>-->
 <div id="app" class="bg-blue-dark md:border-t-8 border-green">
     <div class="container flex items-center flex-wrap px-4 md:px-0 mx-auto">
         <div class="flex-1 flex items-center">
@@ -22,7 +22,7 @@
                 </div>
             </a>
 
-            <div class="flex items-center">
+            <!--<div class="flex items-center">
                 <span role="presentation" aria-hidden="true"
                       class="hidden lg:block w-1 h-1 bg-blue-light rounded-full ml-2"></span>
                 <span role="presentation" aria-hidden="true"
@@ -35,7 +35,7 @@
                         Announcing 1.0
                     </a>
                 </div>
-            </div>
+            </div>-->
         </div>
         <div class="w-auto text-center relative">
             <input class="docSearch-input w-full md:w-48 px-4 py-2 text-blue-lightest bg-blue-light rounded-full"
@@ -100,6 +100,22 @@
                 </div>
             </div>
             <% } %>
+            <% if(meta.versions.length > 1) { %>
+            <div class="inline text-blue-lightest py-4 relative group ml-4">
+                <span class="-md:hidden bg-blue-light rounded-sm px-2 py-1"><%= meta.currentVersion.name %></span>
+
+                <div class="pl-4 mt-3 md:pl-0 md:hidden group-hover:block hover:block md:absolute md:bg-white md:shadow md:rounded md:pin-r overflow-hidden z-50">
+                    <div class="flex flex-col">
+                        <% meta.versions.forEach(v => { %>
+                        <a href="<%= v.url %>"
+                           class="no-underline text-blue-lightest md:text-blue-dark hover:bg-green hover:text-white px-4 py-2">
+                            <%= v.name %>
+                        </a>
+                        <% }) %>
+                    </div>
+                </div>
+            </div>
+            <% } %>
         </div>
     </div>
 </div>

layouts/docs.ejs

@@ -17,6 +17,13 @@
         </div>
     </div>
 
+    <% if(meta.currentVersion.branch !== 'master') { %>
+    <a href="//nativescript-vue.org/"
+       class="block bg-orange-dark p-2 text-center no-underline text-white">
+        You are reading docs for <span class="bg-orange-lightest text-orange-dark rounded-sm px-2 py-1"><%= meta.currentVersion.name %></span>, click here for the latest version.
+    </a>
+    <% } %>
+
     <div class="md:bg-docs-gradient min-h-screen">
         <div class="container mx-auto flex">
             <div class="hidden md:w-1/4 md:block border-r-4 min-h-full">
@@ -81,7 +88,7 @@
                     <% } %>
 
                     <div class="flex justify-center">
-                        <a href="https://github.com/nativescript-vue/nativescript-vue.org/tree/master/content/<%= current.filePath %>"
+                        <a href="https://github.com/nativescript-vue/nativescript-vue.org/tree/<%= meta.currentVersion.branch %>/content/<%= current.filePath %>"
                            target="_blank"
                            rel="noopener"
                            class="border border-green px-4 py-2 no-underline text-green hover:border-blue-dark hover:text-blue-dark my-8">