createLocalePath

多语言站点的 URL 换算。纯函数、无全局状态、无 DOM，构建期脚本（sitemap、hreflang）和浏览器里都能跑。

采用子目录（/zh/book/）而非子域名（zh.example.com/book/）：搜索引擎把子域名当独立站点、权重从零开始，而子目录继承主站权重。默认语言落在根路径，其余语言带前缀。

API

createLocalePath(config)

参数	说明	类型	默认值
`locales`	`{ code, prefix? }[]`，无 prefix 表示默认语言、落在根路径	`LocaleRoute[]`	必填
`defaultLocale`	默认语言 code	`string`	第一个无 prefix 的项
`base`	部署子路径，如 `/weread`；结尾斜杠会被忽略	`string`	`''`

成员	说明
`base` / `defaultLocale`	归一化后的配置，只读
`localeFromPath(pathname)`	识别语言，识别不出返回默认语言
`stripLocale(pathname)`	去掉语言前缀，得到与语言无关的路径（路由判断用）
`href(path, code?)`	生成某语言下的链接
`hrefForLocale(pathname, code)`	把当前路径换算到另一语言（语言切换器用）
`alternates(pathname)`	所有语言下的地址，用于 `<link rel="alternate" hreflang>`

示例

import { createLocalePath } from 'ranuts';

const paths = createLocalePath({
  locales: [{ code: 'en' }, { code: 'zh-CN', prefix: 'zh' }, { code: 'zh-HK', prefix: 'zh-hant' }],
  base: '/docs',
});

paths.href('/book/walden/'); // '/docs/book/walden/'
paths.href('/book/walden/', 'zh-CN'); // '/docs/zh/book/walden/'
paths.localeFromPath('/docs/zh/book/'); // 'zh-CN'
paths.stripLocale('/docs/zh/book/'); // '/docs/book/'
paths.hrefForLocale('/docs/zh/book/', 'zh-HK'); // '/docs/zh-hant/book/'

// hreflang 标签
paths.alternates(location.pathname).forEach(({ code, href }) => {
  head.append(link({ rel: 'alternate', hreflang: code, href }));
});

注意

href 是幂等的。加新前缀前会先剥掉已有前缀，所以传入已本地化的路径不会叠加， hrefForLocale 本身就是 href。
长前缀优先匹配，zh 不会吃掉 /zh-hant/...。
base 只从开头剥。用 replace(base, '') 会替换字符串中第一次出现的位置，路径中部含有同名片段时会剥错地方。
query 与 hash 会保留，换算只作用于 pathname。
没有全局「当前语言」。语言 code 由调用方显式传入或走默认值；当前语言是 i18n 运行时的职责，不是本模块的。