日期:2026年1月10日20时36分 摘要:在顶部菜单增加语言选择入口,并支持通过环境变量配置默认语言(影响根路径语言与链接前缀)。
【question】 在页面菜单上增加语言选择功能,并提供默认语言
【try to solve】 在站点构建时渲染的 header 菜单中加入语言入口:
- 当启用多语言(
SITE_LANGS包含多个语言)时,显示下拉菜单,可在已启用语言之间切换,并为每页生成对应语言链接。 - 当仅启用一种语言时,仍在菜单中展示当前语言(禁用态按钮),便于未来开启多语言后无缝出现切换功能。
同时增加默认语言配置:
- 新增
SITE_DEFAULT_LANG(默认zh),用于确定“根路径/对应的语言”。 - 语言路径前缀由默认语言自动推导:默认语言不加前缀,其他语言使用
/<lang>(例如/en)。
【执行操作】
- 更新:
scripts/site/config.mjs(新增SITE_DEFAULT_LANG,默认语言与路径前缀推导) - 更新:
scripts/site/components.mjs(header 菜单语言入口:单语言显示、双语显示下拉) - 更新:
README.md(补充默认语言用法)