81 lines
3.3 KiB
JavaScript
81 lines
3.3 KiB
JavaScript
const assert = require('assert')
|
|
const path = require('path')
|
|
const externalRedirects = Object.keys(require('./redirects/external-sites'))
|
|
const { getPathWithoutLanguage, getVersionStringFromPath } = require('./path-utils')
|
|
const { getNewVersionedPath } = require('./old-versions-utils')
|
|
const patterns = require('./patterns')
|
|
const { latest } = require('./enterprise-server-releases')
|
|
const nonEnterpriseDefaultVersion = require('./non-enterprise-default-version')
|
|
const removeFPTFromPath = require('./remove-fpt-from-path')
|
|
const allVersions = require('./all-versions')
|
|
const supportedVersions = Object.keys(allVersions)
|
|
const supportedPlans = Object.values(allVersions).map(v => v.plan)
|
|
|
|
// Content authors write links like `/some/article/path`, but they need to be
|
|
// rewritten on the fly to match the current language and page version
|
|
module.exports = function rewriteLocalLinks ($, version, languageCode) {
|
|
assert(languageCode, 'languageCode is required')
|
|
|
|
$('a[href^="/"]').each((i, el) => {
|
|
getNewHref($(el), languageCode, version)
|
|
})
|
|
}
|
|
|
|
function getNewHref (link, languageCode, version) {
|
|
const href = link.attr('href')
|
|
|
|
// these links should not be rewritten
|
|
if (href.startsWith('/assets')) return
|
|
if (href.startsWith('/public')) return
|
|
|
|
// Leave old redirected URLs intact
|
|
// e.g. `/contact` should not be replaced with `/en/contact`
|
|
if (externalRedirects.includes(href)) return
|
|
|
|
let newHref
|
|
// If the link has a hardcoded plan or version in it, do not update the version, just add the language code
|
|
// Examples:
|
|
// /enterprise-server@2.20/rest/reference/oauth-authorizations
|
|
// /enterprise-server/rest/reference/oauth-authorizations (this redirects to the latest version)
|
|
// /enterprise-server@latest/rest/reference/oauth-authorizations (this redirects to the latest version)
|
|
const firstLinkSegment = href.split('/')[1]
|
|
if ([...supportedPlans, ...supportedVersions, 'enterprise-server@latest'].includes(firstLinkSegment)) {
|
|
newHref = path.join('/', languageCode, href)
|
|
}
|
|
|
|
// If link is dotcom-only, just get the language code
|
|
// Otherwise, get the versioned path with language code
|
|
if (!newHref) {
|
|
// start clean with no language (TOC pages already include the lang codes via lib/liquid-tags/link.js)
|
|
const hrefWithoutLang = getPathWithoutLanguage(href).replace(patterns.trailingSlash, '$1')
|
|
|
|
// normalize any legacy links so they conform to new link structure
|
|
newHref = path.join('/', languageCode, getNewVersionedPath(hrefWithoutLang))
|
|
|
|
// get the current version from the link
|
|
const versionFromHref = getVersionStringFromPath(newHref)
|
|
|
|
// ------ BEGIN ONE-OFF OVERRIDES ------//
|
|
// dotcom-only links always point to dotcom
|
|
if (link.hasClass('dotcom-only')) {
|
|
version = nonEnterpriseDefaultVersion
|
|
}
|
|
|
|
// desktop links always point to dotcom
|
|
if (patterns.desktop.test(hrefWithoutLang)) {
|
|
version = nonEnterpriseDefaultVersion
|
|
}
|
|
|
|
// admin links always point to Enterprise
|
|
if (patterns.adminProduct.test(hrefWithoutLang)) {
|
|
version = `enterprise-server@${latest}`
|
|
}
|
|
// ------ END ONE-OFF OVERRIDES ------//
|
|
|
|
// update the version in the link
|
|
newHref = removeFPTFromPath(newHref.replace(versionFromHref, version))
|
|
}
|
|
|
|
if (href !== newHref) link.attr('href', newHref)
|
|
}
|