mirror of https://github.com/vuejs/vitepress
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
188 lines
5.1 KiB
188 lines
5.1 KiB
import type { HeadConfig, PageData, SiteData } from '../../types/shared'
|
|
|
|
export type {
|
|
Awaitable,
|
|
DefaultTheme,
|
|
HeadConfig,
|
|
Header,
|
|
LocaleConfig,
|
|
LocaleSpecificConfig,
|
|
MarkdownEnv,
|
|
PageData,
|
|
PageDataPayload,
|
|
SSGContext,
|
|
SiteData
|
|
} from '../../types/shared'
|
|
|
|
export const EXTERNAL_URL_RE = /^(?:[a-z]+:|\/\/)/i
|
|
export const APPEARANCE_KEY = 'vitepress-theme-appearance'
|
|
export const HASH_RE = /#.*$/
|
|
export const EXT_RE = /(index)?\.(md|html)$/
|
|
|
|
export const inBrowser = typeof document !== 'undefined'
|
|
|
|
export const notFoundPageData: PageData = {
|
|
relativePath: '',
|
|
filePath: '',
|
|
title: '404',
|
|
description: 'Not Found',
|
|
headers: [],
|
|
frontmatter: { sidebar: false, layout: 'page' },
|
|
lastUpdated: 0,
|
|
isNotFound: true
|
|
}
|
|
|
|
export function isActive(
|
|
currentPath: string,
|
|
matchPath?: string,
|
|
asRegex: boolean = false
|
|
): boolean {
|
|
if (matchPath === undefined) {
|
|
return false
|
|
}
|
|
|
|
currentPath = normalize(`/${currentPath}`)
|
|
|
|
if (asRegex) {
|
|
return new RegExp(matchPath).test(currentPath)
|
|
}
|
|
|
|
if (normalize(matchPath) !== currentPath) {
|
|
return false
|
|
}
|
|
|
|
const hashMatch = matchPath.match(HASH_RE)
|
|
|
|
if (hashMatch) {
|
|
return (inBrowser ? location.hash : '') === hashMatch[0]
|
|
}
|
|
|
|
return true
|
|
}
|
|
|
|
export function normalize(path: string): string {
|
|
return decodeURI(path).replace(HASH_RE, '').replace(EXT_RE, '')
|
|
}
|
|
|
|
export function isExternal(path: string): boolean {
|
|
return EXTERNAL_URL_RE.test(path)
|
|
}
|
|
|
|
/**
|
|
* this merges the locales data to the main data by the route
|
|
*/
|
|
export function resolveSiteDataByRoute(
|
|
siteData: SiteData,
|
|
relativePath: string
|
|
): SiteData {
|
|
const localeIndex =
|
|
Object.keys(siteData.locales).find(
|
|
(key) =>
|
|
key !== 'root' &&
|
|
!isExternal(key) &&
|
|
isActive(relativePath, `/${key}/`, true)
|
|
) || 'root'
|
|
|
|
return Object.assign({}, siteData, {
|
|
localeIndex,
|
|
lang: siteData.locales[localeIndex]?.lang ?? siteData.lang,
|
|
dir: siteData.locales[localeIndex]?.dir ?? siteData.dir,
|
|
title: siteData.locales[localeIndex]?.title ?? siteData.title,
|
|
titleTemplate:
|
|
siteData.locales[localeIndex]?.titleTemplate ?? siteData.titleTemplate,
|
|
description:
|
|
siteData.locales[localeIndex]?.description ?? siteData.description,
|
|
head: mergeHead(siteData.head, siteData.locales[localeIndex]?.head ?? []),
|
|
themeConfig: {
|
|
...siteData.themeConfig,
|
|
...siteData.locales[localeIndex]?.themeConfig
|
|
}
|
|
})
|
|
}
|
|
|
|
/**
|
|
* Create the page title string based on config.
|
|
*/
|
|
export function createTitle(siteData: SiteData, pageData: PageData): string {
|
|
const title = pageData.title || siteData.title
|
|
const template = pageData.titleTemplate ?? siteData.titleTemplate
|
|
|
|
if (typeof template === 'string' && template.includes(':title')) {
|
|
return template.replace(/:title/g, title)
|
|
}
|
|
|
|
const templateString = createTitleTemplate(siteData.title, template)
|
|
|
|
if (title === templateString.slice(3)) {
|
|
return title
|
|
}
|
|
|
|
return `${title}${templateString}`
|
|
}
|
|
|
|
function createTitleTemplate(
|
|
siteTitle: string,
|
|
template?: string | boolean
|
|
): string {
|
|
if (template === false) {
|
|
return ''
|
|
}
|
|
|
|
if (template === true || template === undefined) {
|
|
return ` | ${siteTitle}`
|
|
}
|
|
|
|
if (siteTitle === template) {
|
|
return ''
|
|
}
|
|
|
|
return ` | ${template}`
|
|
}
|
|
|
|
function hasTag(head: HeadConfig[], tag: HeadConfig) {
|
|
const [tagType, tagAttrs] = tag
|
|
if (tagType !== 'meta') return false
|
|
const keyAttr = Object.entries(tagAttrs)[0] // First key
|
|
if (keyAttr == null) return false
|
|
return head.some(
|
|
([type, attrs]) => type === tagType && attrs[keyAttr[0]] === keyAttr[1]
|
|
)
|
|
}
|
|
|
|
export function mergeHead(prev: HeadConfig[], curr: HeadConfig[]) {
|
|
return [...prev.filter((tagAttrs) => !hasTag(curr, tagAttrs)), ...curr]
|
|
}
|
|
|
|
// https://github.com/rollup/rollup/blob/fec513270c6ac350072425cc045db367656c623b/src/utils/sanitizeFileName.ts
|
|
|
|
const INVALID_CHAR_REGEX = /[\u0000-\u001F"#$&*+,:;<=>?[\]^`{|}\u007F]/g
|
|
const DRIVE_LETTER_REGEX = /^[a-z]:/i
|
|
|
|
export function sanitizeFileName(name: string): string {
|
|
const match = DRIVE_LETTER_REGEX.exec(name)
|
|
const driveLetter = match ? match[0] : ''
|
|
|
|
return (
|
|
driveLetter +
|
|
name
|
|
.slice(driveLetter.length)
|
|
.replace(INVALID_CHAR_REGEX, '_')
|
|
.replace(/(^|\/)_+(?=[^/]*$)/, '$1')
|
|
)
|
|
}
|
|
|
|
export function slash(p: string): string {
|
|
return p.replace(/\\/g, '/')
|
|
}
|
|
|
|
// md, html? are intentionally omitted, see treatAsHtml
|
|
const commonMimeTypes = `3g2,3gp,7z,aac,abw,ai,aif,aifc,aiff,arc,asf,asr,asx,au,avi,avif,axs,azw,bin,bmp,bz,bz2,c,cda,cer,class,crl,crt,csh,css,csv,dcr,der,dll,doc,docx,eot,eps,epub,exe,gif,gtar,gz,gzip,ico,ics,ief,jar,jpe,jpeg,jpg,js,json,jsonld,latex,m3u,man,mdb,mht,mhtml,mid,midi,mjs,mov,mp2,mp3,mp4,mpa,mpe,mpeg,mpg,mpkg,mpp,odp,ods,odt,oga,ogv,ogx,opus,otf,p10,p12,p7b,p7c,p7m,p7r,p7s,pbm,pdf,pfx,php,png,ppt,pptx,ps,pub,qt,rar,roff,rtf,rtx,ser,sh,spc,svg,swf,t,tar,tcl,tex,texi,texinfo,tgz,tif,tiff,tr,ts,tsv,ttf,txt,ua,viv,vivo,vsd,wav,weba,webm,webp,woff,woff2,xbm,xhtml,xls,xlsx,xml,xul,zip`
|
|
|
|
const set = new Set(commonMimeTypes.split(','))
|
|
|
|
export function treatAsHtml(filename: string): boolean {
|
|
const ext = filename.split('.').pop()?.toLowerCase()
|
|
|
|
return ext == null || !set.has(ext)
|
|
}
|