Function isValidRef

document/script/checkDocRefs.js:116–155

(url, mdxPath)

}

function isValidRef(url, mdxPath) {
  if (isExternal(url)) return { ok: true };
  const target = stripFragment(url);
  if (!target) return { ok: true };

  // 绝对路径
  if (target.startsWith('/')) {
    if (isSkippedAttachment(target)) return { ok: true };
    if (target.startsWith('/imgs/')) {
      const p = path.join(PUBLIC_DIR, target);
      return fileExists(p) ? { ok: true } : { ok: false, expected: p };
    }
    const ext = path.extname(target).toLowerCase();
    if (ext && !MDX_EXTS.includes(ext)) {
      const p = path.join(PUBLIC_DIR, target);
      return fileExists(p) ? { ok: true } : { ok: false, expected: p };
    }
    const langMatch = target.match(/^\/(en|zh)\/(.+)$/);
    const subRaw = langMatch ? langMatch[2] : target.slice(1);
    const sub = normalizeRoutePath(subRaw);
    const base = path.join(CONTENT_DIR, sub);
    return routeExists(base)
      ? { ok: true }
      : { ok: false, expected: `${base}(.mdx | .en.mdx | /index.mdx)` };
  }
  // 相对路径
  const ext = path.extname(target).toLowerCase();
  if (ext && !MDX_EXTS.includes(ext)) {
    const resolved = path.resolve(path.dirname(mdxPath), target);
    if (FILE_LIKE_EXTS.has(ext)) {
      return fileExists(resolved) ? { ok: true } : { ok: false, expected: resolved };
    }
    return fileExists(resolved) ? { ok: true } : { ok: false, expected: resolved };
  }
  const normalized = normalizeRoutePath(target);
  const resolved = path.resolve(path.dirname(mdxPath), normalized);
  return routeExists(resolved)
    ? { ok: true }
    : { ok: false, expected: `${resolved}(.mdx | .en.mdx | /index.mdx)` };
}

function isMetaFile(name) {
  return /^meta(\.en)?\.json$/.test(name);