Function resolvePagePermalink

packages/core/src/page/resolvePagePermalink.ts:11–59

({
  app,
  frontmatter,
  slug,
  date,
  pathInferred,
  pathLocale,
}: {
  app: App
  frontmatter: PageFrontmatter
  slug: string
  date: string
  pathInferred: string | null
  pathLocale: string
})

 * @internal
 */
export const resolvePagePermalink = ({
  app,
  frontmatter,
  slug,
  date,
  pathInferred,
  pathLocale,
}: {
  app: App
  frontmatter: PageFrontmatter
  slug: string
  date: string
  pathInferred: string | null
  pathLocale: string
}): string | null => {
  // frontmatter.permalink has the highest priority
  if (frontmatter.permalink === null) {
    return null
  }
  if (isString(frontmatter.permalink)) {
    return frontmatter.permalink
  }

  // frontmatter.permalinkPattern has higher priority than app.options.permalinkPattern
  if (frontmatter.permalinkPattern === null) {
    return null
  }

  const permalinkPattern =
    frontmatter.permalinkPattern || app.options.permalinkPattern

  if (!isString(permalinkPattern)) {
    return null
  }

  // resolve permalink according to the pattern
  const [year, month, day] = date.split('-')
  const link = path.join(
    pathLocale,
    permalinkPattern
      .replace(/:year/, year)
      .replace(/:month/, month)
      .replace(/:day/, day)
      .replace(/:slug/, slug)
      .replace(/:raw/, pathInferred?.replace(/^\//, '') ?? ''),
  )

  return ensureLeadingSlash(link)
}