1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
const docsLocales = new Set(['ja', 'zh-cn']);
const docsVersionPattern = /^\d+\.\d+\.\d+$/;
export type DocsTarget = 'stable' | 'preview' | string;
export interface DocsRoute {
isDocs: boolean;
locale: string | undefined;
target: DocsTarget;
page: string;
}
export interface DocsScope {
locales: Record<string, string[]>;
}
export function docsRoute(pathname: string): DocsRoute {
const segments = pathname.split('/').filter(Boolean);
let locale: string | undefined;
if (segments[0] && docsLocales.has(segments[0])) {
locale = segments.shift();
}
if (segments.shift() !== 'docs') {
return { isDocs: false, locale, target: 'stable', page: '' };
}
let target: DocsTarget = 'stable';
if (segments[0] === 'preview') {
target = 'preview';
segments.shift();
} else if (segments[0] && docsVersionPattern.test(segments[0])) {
target = segments.shift()!;
}
return {
isDocs: true,
locale,
target,
page: segments.join('/'),
};
}
export function docsVersion(pathname: string) {
return docsRoute(pathname).target;
}
export function docsTargetHref(
route: DocsRoute,
target: DocsTarget,
scopes?: Record<string, DocsScope>,
) {
if (!route.isDocs) throw new Error('cannot build a documentation target from a non-docs route');
const localeKey = route.locale ?? 'root';
const availablePages = scopes?.[target]?.locales[localeKey];
const page = availablePages?.includes(route.page) === false ? '' : route.page;
const prefix = route.locale ? `/${route.locale}` : '';
const targetSegment = target === 'stable' ? '' : `/${target}`;
return `${prefix}/docs${targetSegment}${page ? `/${page}` : ''}/`;
}
export function docsPath({ entry }: { entry: string }) {
const slug = entry.replace(/\.(md|mdx|markdown|mdown|mkdn|mkd|mdwn)$/i, '');
const normalized = slug.replace(/\/index$/, '');
const segments = normalized.split('/');
let targetSegment = '';
if (segments[0] === 'preview') {
targetSegment = 'preview';
segments.shift();
} else if (segments[0] === '_versions' && segments[1] && docsVersionPattern.test(segments[1])) {
segments.shift();
targetSegment = segments.shift()!;
}
let locale: string | undefined;
if (segments[0] && docsLocales.has(segments[0])) {
locale = segments.shift();
}
const page = segments.join('/');
const prefix = locale ? `${locale}/` : '';
const target = targetSegment ? `/${targetSegment}` : '';
return `${prefix}docs${target}${page && page !== 'index' ? `/${page}` : ''}`;
}
|
