replace developer routes with static developer redirects file

This commit is contained in:
Sarah Schneider 2021-01-19 20:50:10 -05:00
Родитель d060fddc6f
Коммит 7e4286f76d
3 изменённых файлов: 21515 добавлений и 3771 удалений

Просмотреть файл

@ -1,90 +0,0 @@
const path = require('path')
const patterns = require('../patterns')
const { latest } = require('../enterprise-server-releases')
const { getPathWithoutLanguage, getPathWithoutVersion } = require('../path-utils')
// This function takes a known pre-migration path from developer.github.com and
// infers and returns a current, correct docs.github.com path.
module.exports = function getDocsPathFromDeveloperPath (oldDeveloperPath, allRedirects, pageMap) {
let newPath = oldDeveloperPath
// Look up the old path in the redirects object BEFORE modifying /v3 and /v4 paths
// in case there is a frontmatter redirect.
// e.g. /v3/activity/event_types -> /en/developers/webhooks-and-events/github-event-types
newPath = allRedirects[newPath] || newPath
// oneoff redirect
const v3OrgPreReceiveHooks = '/v3/orgs/pre_receive_hooks'
if (newPath.endsWith(v3OrgPreReceiveHooks)) {
newPath = newPath.replace(v3OrgPreReceiveHooks, '/v3/enterprise-admin/organization_pre_receive_hooks')
}
// oneoff redirect
const v3RepoPreReceiveHooks = '/v3/repos/pre_receive_hooks'
if (newPath.endsWith(v3RepoPreReceiveHooks)) {
newPath = newPath.replace(v3RepoPreReceiveHooks, '/v3/enterprise-admin/repository_pre_receive_hooks')
}
// oneoff redirect
const v3OrgHooks = '/v3/orgs/hooks'
if (newPath.endsWith(v3OrgHooks)) {
newPath = newPath.replace(v3OrgHooks, '/v3/orgs/webhooks')
}
// oneoff redirect
const v3RepoHooks = '/v3/repos/hooks'
if (newPath.endsWith(v3RepoHooks)) {
newPath = newPath.replace(v3RepoHooks, '/v3/repos/webhooks')
}
// oneoff redirect for a dotcom developer path to Enterprise-only path on docs.github.com
const oauthAuthorizations = '/v3/oauth_authorizations'
if (newPath.endsWith(oauthAuthorizations)) {
newPath = newPath.replace(oauthAuthorizations, `/enterprise-server@${latest}/v3/oauth_authorizations`)
}
// Change /v4/foo/bar to /v4/foo#bar
// Change /v3/foo/bar to /v3/foo#bar
// Then we can look up the hashless path in the redirect object,
// get the new path like /graphql/reference/foo or /rest/reference/foo,
// and add the #bar fragment back after.
let fragment
if (patterns.oldApiPath.test(newPath)) {
// pathParts = [ '', 'v4', 'foo', 'bar' ]
const pathParts = newPath.split('/')
// lastSegment = bar
const lastSegment = pathParts.pop()
// newPath = /v4/foo
newPath = pathParts.join('/')
// Underscores in the final segment of REST paths (`/admin_stats`)
// get changed to hyphens when they become fragments (`#admin-stats`).
// GraphQL paths rarely have underscores, but when they do, they are preserved (`__directive`).
fragment = newPath.includes('/v3/')
? lastSegment
.replace(/_/g, '-')
// this is a special oneoff replacement
.replace('org-pre-receive-hooks', 'organization-pre-receive-hooks')
.replace('repo-pre-receive-hooks', 'repository-pre-receive-hooks')
: lastSegment
}
// do a second lookup to find /v4/foo or /v3/foo without the last segment
newPath = allRedirects[newPath] || newPath
// old developer routes that include 'enterprise-admin' should always redirect to enterprise server
if (fragment && newPath.includes('/rest/reference/enterprise-admin') && !patterns.enterpriseServer.test(newPath)) {
newPath = path.posix.join('/en', `enterprise-server@${latest}`, getPathWithoutLanguage(getPathWithoutVersion(newPath)))
}
// show an error if the page to be redirected to doesn't exist
// but only if the current collection of pages includes REST and GraphQL reference pages
if (process.env.NODE_ENV !== 'test' && !pageMap[newPath] && pageMap['/en/rest/reference'] && pageMap['/en/graphql/reference']) {
console.error(`can't find ${newPath}! based on ${oldDeveloperPath}`)
}
// add fragment back in and return
return fragment
? newPath + '#' + fragment
: newPath
}

Разница между файлами не показана из-за своего большого размера Загрузить разницу

Разница между файлами не показана из-за своего большого размера Загрузить разницу