8cdc76ba4c
These tags are preserved by the Closure compiler and vulcanize in order to serve the license notices embedded in the outputs. In a standalone Gerrit server, these license are also covered in the LICENSES.txt served with the documentation. When serving PG assets from a CDN, it's less obvious what the corresponding LICENSES.txt file is, since the CDN is not directly linked to a running Gerrit server. Safer to embed the licenses in the assets themselves. Change-Id: Id1add1451fad1baa7916882a6bda02c326ccc988
63 lines
1.8 KiB
HTML
63 lines
1.8 KiB
HTML
<!--
|
|
@license
|
|
Copyright (C) 2017 The Android Open Source Project
|
|
|
|
Licensed 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.
|
|
-->
|
|
<link rel="import" href="../base-url-behavior/base-url-behavior.html">
|
|
<script>
|
|
(function(window) {
|
|
'use strict';
|
|
|
|
const PROBE_PATH = '/Documentation/index.html';
|
|
const DOCS_BASE_PATH = '/Documentation';
|
|
|
|
let cachedPromise;
|
|
|
|
window.Gerrit = window.Gerrit || {};
|
|
|
|
/** @polymerBehavior Gerrit.DocsUrlBehavior */
|
|
Gerrit.DocsUrlBehavior = [{
|
|
|
|
/**
|
|
* Get the docs base URL from either the server config or by probing.
|
|
* @param {Object} config The server config.
|
|
* @param {!Object} restApi A REST API instance
|
|
* @return {!Promise<string>} A promise that resolves with the docs base
|
|
* URL.
|
|
*/
|
|
getDocsBaseUrl(config, restApi) {
|
|
if (!cachedPromise) {
|
|
cachedPromise = new Promise(resolve => {
|
|
if (config && config.gerrit && config.gerrit.doc_url) {
|
|
resolve(config.gerrit.doc_url);
|
|
} else {
|
|
restApi.probePath(this.getBaseUrl() + PROBE_PATH).then(ok => {
|
|
resolve(ok ? (this.getBaseUrl() + DOCS_BASE_PATH) : null);
|
|
});
|
|
}
|
|
});
|
|
}
|
|
return cachedPromise;
|
|
},
|
|
|
|
/** For testing only. */
|
|
_clearDocsBaseUrlCache() {
|
|
cachedPromise = undefined;
|
|
},
|
|
},
|
|
Gerrit.BaseUrlBehavior,
|
|
];
|
|
})(window);
|
|
</script>
|