Updated download links to Apache mirrors and prepared for multiple versions docs (#660)

site/_config.local.yml

@@ -20,6 +20,5 @@
 destination: generated
 livereload: true
 baseurl: "/"
-current_version: 1.18
 include:
 - docs/example.md

site/_config.yml

@@ -25,9 +25,8 @@ pulsar_repo: https://github.com/apache/incubator-pulsar/tree/master
 baseurl: /
 destination: ../generated-site/content
 
-versions:
-- 1.18
-latest: 1.18
+current_version: 1.19.0-incubating
+archived_releases:
 
 markdown: kramdown
 kramdown:

site/_includes/explanations/install-package.md

-{% capture binary_release_url %}https://github.com/apache/incubator-pulsar/releases/download/v{{ site.current_version }}/pulsar-{{ site.current_version }}-bin.tar.gz{% endcapture %}
-{% capture source_release_url %}https://github.com/apache/incubator-pulsar/releases/download/v{{ site.current_version }}/pulsar-{{ site.current_version }}-src.tar.gz{% endcapture %}
+
+{% capture binary_release_url %}http://www.apache.org/dyn/closer.cgi/incubator/pulsar/pulsar-{{ site.current_version }}/apache-pulsar-{{ site.current_version }}-bin.tar.gz{% endcapture %}
+{% capture source_release_url %}http://www.apache.org/dyn/closer.cgi/incubator/pulsar/pulsar-{{ site.current_version }}/apache-pulsar-{{ site.current_version }}-src.tar.gz{% endcapture %}
 
 ## System requirements
 
@@ -20,22 +21,22 @@ To get started running Pulsar, download a binary tarball release in one of the f
 
   ```shell
   # Source release
-  $ wget {{ source_release_url }}
+  $ wget http://archive.apache.org/dist/incubator/pulsar/pulsar-{{site.current_version}}/apache-pulsar-{{site.current_version}}-src.tar.gz
 
   # Binary release
-  $ wget {{ binary_release_url }}
+  $ wget http://archive.apache.org/dist/incubator/pulsar/pulsar-{{site.current_version}}/apache-pulsar-{{site.current_version}}-bin.tar.gz
   ```
 
 Once the tarball is downloaded, untar it and `cd` into the resulting directory:
 
 ```bash
 # Source release
-$ tar xvf pulsar-{{ site.latest }}-bin.tar.gz
-$ cd pulsar-{{ site.latest }}
+$ tar xvfz pulsar-{{ site.current_version }}-src.tar.gz
+$ cd pulsar-{{ site.current_version }}
 
 # Binary release
-$ tar xvf pulsar-{{ site.latest }}-src.tar.gz
-$ cd pulsar-{{ site.latest }}
+$ tar xvfz apache-pulsar-{{ site.current_version }}-bin.tar.gz
+$ cd pulsar-{{ site.current_version }}
 ```
 
 ## What your package contains
@@ -60,4 +61,4 @@ To compile, skipping the tests:
 
 ```shell
 $ mvn install -DskipTests
-```
\ No newline at end of file
+```

site/_includes/navbar.html

@@ -31,8 +31,26 @@
 
   <div class="collapse navbar-collapse justify-content-end" id="navbarNavDropdown">
     <ul class="navbar-nav">
-      <li class="nav-item">
-        <a class="nav-link" href="/docs/latest/getting-started/LocalCluster">Documentation</a>
+      <li class="nav-item dropdown">
+        <a class="nav-link dropdown-toggle" href="#" id="clientLibsDropdown" data-toggle="dropdown"
+            aria-haspopup="true" aria-expanded="false">Documentation</a>
+
+        <div class="dropdown-menu" aria-labelledby="documentationDropdown">
+            <a class="dropdown-item" href="/docs/latest/getting-started/LocalCluster">Latest</a>
+
+            <div class="dropdown-divider"></div>
+            <h3 class="dropdown-header">Stable release</h3>
+            <a class="dropdown-item" href="/docs/v{{site.current_version}}/getting-started/LocalCluster">{{site.current_version}}</a>
+
+            {% if site.archived_releases %}
+                <div class="dropdown-divider"></div>
+                <h3 class="dropdown-header">Other releases</h3>
+
+                {% for version in site.archived_releases %}
+                    <a class="dropdown-item" href="/docs/v{{version}}/getting-started/LocalCluster">{{version}}</a>
+                {% endfor %}
+            {% endif %}
+        </div>
       </li>
 
       <li class="nav-item">

site/_includes/versions.html

-<!--
-
-    Licensed to the Apache Software Foundation (ASF) under one
-    or more contributor license agreements.  See the NOTICE file
-    distributed with this work for additional information
-    regarding copyright ownership.  The ASF licenses this file
-    to you under the Apache License, Version 2.0 (the
-    "License"); you may not use this file except in compliance
-    with the License.  You may obtain a copy of the License at
-
-      http://www.apache.org/licenses/LICENSE-2.0
-
-    Unless required by applicable law or agreed to in writing,
-    software distributed under the License is distributed on an
-    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-    KIND, either express or implied.  See the License for the
-    specific language governing permissions and limitations
-    under the License.
-
--->
-<ul>
-  {% for version in site.versions %}
-  <li><a href="/docs/{{ version }}">{{ version }}</a></li>
-  {% endfor %}
-</ul>

site/docs/latest/_config.version.yml

@@ -18,4 +18,3 @@
 #
 
 data_dir: _data
-current_version: latest
\ No newline at end of file

site/download.md

 ---
 title: Apache Pulsar downloads
-layout: docs
-toc_disable: true
+layout: content
 ---
 
-{% include admonition.html type="success" title='Notice' content="
-The current release was done prior to entering the Apache Incubator, so
-it's still relative to 'Yahoo Pulsar' rather than 'Apache Pulsar'" %}
-
 Download Pulsar from the [releases page](https://github.com/apache/incubator-pulsar/releases) on GitHub or here:
 
-{% for version in site.versions %}
-### Version {{ version }}{% if version == site.current_version %} (latest){% endif %}
+### Version {{ site.current_version }}
 
 | Type   | Link                                                                                                                                           |
 |:-------|:-----------------------------------------------------------------------------------------------------------------------------------------------|
-| Source | [pulsar-{{ version }}-src.tar.gz](https://github.com/apache/incubator-pulsar/releases/download/v{{ version }}/pulsar-{{ version }}-src.tar.gz) |
-| Binary | [pulsar-{{ version }}-bin.tar.gz](https://github.com/apache/incubator-pulsar/releases/download/v{{ version }}/pulsar-{{ version }}-bin.tar.gz) |
-{% endfor %}
+| Source | [apache-pulsar-{{ site.current_version }}-src.tar.gz](http://www.apache.org/dyn/closer.cgi/incubator/pulsar/pulsar-{{ site.current_version }}/apache-pulsar-{{ site.current_version }}-src.tar.gz) |
+| Binary | [apache-pulsar-{{ site.current_version }}-bin.tar.gz](http://www.apache.org/dyn/closer.cgi/incubator/pulsar/pulsar-{{ site.current_version }}/apache-pulsar-{{ site.current_version }}-bin.tar.gz) |
+
 
 ### Release notes
 
-{% for version in site.versions %}
-* [Pulsar version {{version}}{% if version == site.current_version %} (latest){% endif %}](https://github.com/apache/incubator-pulsar/releases/tag/v{{ version }})
-{% endfor %}
+[https://github.com/apache/incubator-pulsar/releases/tag/v{{site.current_version}}](https://github.com/apache/incubator-pulsar/releases/tag/v{{site.current_version}})
 
 ### Getting started
 
-Once you've downloaded a Pulsar release, instructions on getting up and running with a {% popover standalone %} cluster that you can run your laptop can be found in [Run Pulsar locally](../docs/{{ site.current_version }}/getting-started/LocalCluster).
+Once you've downloaded a Pulsar release, instructions on getting up and running with a {% popover standalone %} cluster that you can run your laptop can be found in [Run Pulsar locally](/docs/latest/getting-started/LocalCluster).
 
 If you need to connect to an existing Pulsar {% popover cluster %} or {% popover instance %} using an officially supported client, see client docs for these languages:
 
@@ -36,3 +28,16 @@ Client guide | API docs
 [The Pulsar Java client](../docs/latest/clients/Java) | [Java client Javadoc](../api/client)<br />[Java admin interface Javadoc](../api/admin)
 [The Pulsar Python client](../docs/latest/clients/Python) | [pdoc](../api/python)
 [The Pulsar C++ client](../docs/latest/clients/Cpp) | [Doxygen docs](../api/cpp)
+
+
+{% if site.archived_releases %}
+
+### Other releases
+
+| Release   | Download | Release notes                                                                                      |
+|:-------|:--------------------------------------------|--------------------------------------------|
+{% for version in site.archived_releases
+%} {{version}} | [http://archive.apache.org/dist/incubator/pulsar/pulsar-{{version}}](http://archive.apache.org/dist/incubator/pulsar/pulsar-{{version}}) | [Release notes v{{version}}](https://github.com/apache/incubator-pulsar/releases/tag/v{{ version }})|
+{% endfor %}
+
+{% endif %}