@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/blog/zh/l10n_platform_alternative/crowdin.md

@@ -15,6 +15,7 @@ history:
   - version: 7.5.0
     date: 2025-12-18
     changes: 初始版本
+author: aymericzip
 ---
 
 # 一个面向 Crowdin 的开源 L10n 替代方案（TMS）

package/blog/zh/l10n_platform_alternative/phrase.md

@@ -15,6 +15,7 @@ history:
   - version: 7.5.0
     date: 2025-12-18
     changes: 初始版本
+author: aymericzip
 ---
 
 # 用于 Phrase 的开源 L10n 替代方案（TMS）

package/blog/zh/list_i18n_technologies/frameworks/angular.md

@@ -16,6 +16,7 @@ slugs:
   - i18n-technologies
   - frameworks
   - angular
+author: aymericzip
 ---
 
 # 探索 i18n 解决方案以翻译您的 Angular 网站

package/blog/zh/list_i18n_technologies/frameworks/react-native.md

@@ -16,6 +16,7 @@ slugs:
   - i18n-technologies
   - frameworks
   - react-native
+author: aymericzip
 ---
 
 # 探索 i18n 解决方案以翻译您的 React Native 应用

package/blog/zh/list_i18n_technologies/frameworks/react.md

@@ -16,6 +16,7 @@ slugs:
   - i18n-technologies
   - frameworks
   - react
+author: aymericzip
 ---
 
 # 探索翻译您的 React 网站的 i18n 解决方案

package/blog/zh/list_i18n_technologies/frameworks/svelte.md

@@ -16,6 +16,7 @@ slugs:
   - i18n-technologies
   - frameworks
   - svelte
+author: aymericzip
 ---
 
 # 探索适用于翻译您的 Svelte 网站的 i18n 解决方案

package/blog/zh/list_i18n_technologies/frameworks/vue.md

@@ -16,6 +16,7 @@ slugs:
   - i18n-technologies
   - frameworks
   - vue
+author: aymericzip
 ---
 
 # 探索翻译您的 Vue.js 网站的 i18n 解决方案

package/blog/zh/next-i18next_vs_next-intl_vs_intlayer.md

@@ -15,6 +15,7 @@ keywords:
 slugs:
   - blog
   - next-i18next-vs-next-intl-vs-intlayer
+author: aymericzip
 ---
 
 # next-i18next VS next-intl VS intlayer | Next.js 国际化 (i18n)
@@ -62,14 +63,6 @@ slugs:
 
 ---
 
-## 并排功能比较（以 Next.js 为重点）
-
-| 功能 | `next-intlayer` (Intlayer) | `next-intl` | `next-i18next` |
-
-> 徽章会自动更新。快照会随时间变化。
-
----
-
 ## 并排功能对比（以 Next.js 为重点）
 
 | 功能                                   | `next-intlayer` (Intlayer)                                                     | `next-intl`                                                  | `next-i18next`                                               |
@@ -211,24 +204,6 @@ Next.js 为你内置了国际化路由支持（例如区域段）。但该功能
 
 ---
 
-## 缺失翻译处理
-
-**next-intl**
-
-- 依赖**运行时回退**（例如显示键名或默认语言）。构建不会失败。
-
-**next-i18next**
-
-- 依赖**运行时回退**（例如显示键名或默认语言）。构建不会失败。
-
-**intlayer**
-
-- **构建时检测**，对缺失的语言或键发出**警告/错误**。
-
-**重要原因：** 在构建时捕获缺口，防止生产环境出现“神秘字符串”，并符合严格的发布门控。
-
----
-
 ## 路由、中间件与 URL 策略
 
 <Columns>
@@ -1185,6 +1160,127 @@ export default robots;
 
 ---
 
+### 本地化路由的中间件
+
+<Tabs defaultTab="next-intl" group='techno'>
+  <Tab label="next-i18next" value="next-i18next">
+
+添加中间件以处理本地化检测和路由：
+
+```ts fileName="src/middleware.ts"
+import { NextResponse, type NextRequest } from "next/server";
+import { defaultLocale, locales } from "@/i18n.config";
+
+const PUBLIC_FILE = /\.[^/]+$/; // 排除带扩展名的文件
+
+export function middleware(request: NextRequest) {
+  const { pathname } = request.nextUrl;
+
+  if (
+    pathname.startsWith("/_next") ||
+    pathname.startsWith("/api") ||
+    pathname.startsWith("/static") ||
+    PUBLIC_FILE.test(pathname)
+  ) {
+    return;
+  }
+
+  const hasLocale = locales.some(
+    (l) => pathname === "/" + l || pathname.startsWith("/" + l + "/")
+  );
+  if (!hasLocale) {
+    const locale = defaultLocale;
+    const url = request.nextUrl.clone();
+    url.pathname = "/" + locale + (pathname === "/" ? "" : pathname);
+    return NextResponse.redirect(url);
+  }
+}
+
+export const config = {
+  matcher: [
+    // 匹配所有路径，除了以这些开头的路径和带扩展名的文件
+    "/((?!api|_next|static|.*\\..*).*)",
+  ],
+};
+```
+
+  </Tab>
+  <Tab label="next-intl" value="next-intl">
+
+添加中间件以处理本地化检测和路由：
+
+```ts fileName="src/middleware.ts"
+import createMiddleware from "next-intl/middleware";
+import { locales, defaultLocale } from "@/i18n";
+
+export default createMiddleware({
+  locales: [...locales],
+  defaultLocale,
+  localeDetection: true,
+});
+
+export const config = {
+  // 跳过 API、Next 内部文件和静态资源
+  matcher: ["/((?!api|_next|.*\\..*).*)"],
+};
+```
+
+  </Tab>
+  <Tab label="intlayer" value="intlayer">
+
+Intlayer 通过 `next-intlayer` package 配置提供内置的中间件处理。
+
+```ts fileName="src/middleware.ts"
+import { intlayerProxy } from "next-intlayer/proxy";
+
+export const middleware = intlayerProxy();
+
+// 仅将此中间件应用于 app 目录中的文件
+export const config = {
+  matcher: "/((?!api|_next|static|.*\\..*).*)",
+};
+```
+
+中间件的设置集中在 `intlayer.config.ts` 文件中。
+
+  </Tab>
+</Tabs>
+
+### 设置检查清单和最佳实践
+
+<Tabs defaultTab="next-intl" group='techno'>
+  <Tab label="next-i18next" value="next-i18next">
+
+- 确保在 `src/app/[locale]/layout.tsx` 中的根 `<html>` 上设置了 `lang` 和 `dir`。
+- 在 `src/locales/<locale>/` 下将翻译内容分割为命名空间（例如 `common.json`、`about.json`）。
+- 仅在客户端组件中使用 `useTranslation('<ns>')` 加载所需的命名空间，并通过相同的命名空间范围界定 `I18nProvider`。
+- 尽可能保持页面静态：在页面上导出 `export const dynamic = 'force-static'`；设置 `dynamicParams = false` 并实现 `generateStaticParams`。
+- 使用同步服务器组件嵌套在客户端边界下，通过传递预先计算的字符串或 `t` 函数和 `locale`。
+- 对于 SEO，在元数据中设置 `alternates.languages`，在 `sitemap.ts` 中列出本地化的 URL，并在 `robots.ts` 中禁止重复的本地化路由。
+- 优先使用区域感知的格式化程序（例如 `Intl.NumberFormat(locale)`），如果使用 React < 19，在客户端上对其进行 memoize。
+
+  </Tab>
+  <Tab label="next-intl" value="next-intl">
+
+- **设置 html `lang` 和 `dir`**：在 `src/app/[locale]/layout.tsx` 中，通过 `getLocaleDirection(locale)` 计算 `dir`，并设置 `<html lang={locale} dir={dir}>`。
+- **按命名空间分割消息**：按区域和命名空间组织 JSON（例如 `common.json`、`about.json`）。
+- **最小化客户端负载**：在页面上，仅将所需的命名空间发送到 `NextIntlClientProvider`（例如 `pick(messages, ['common', 'about'])`）。
+- **优先使用静态页面**：导出 `export const dynamic = 'force-static'` 并为所有 `locales` 生成静态参数。
+- **同步服务器组件**：通过传递预先计算的字符串（翻译后的标签、格式化的数字）而不是异步调用或不可序列化的函数，保持服务器组件的同步。
+
+  </Tab>
+  <Tab label="intlayer" value="intlayer">
+
+- **模块化内容**：使用 `.content.{ts|js|json}` 文件将内容字典与组件共同定位。
+- **类型安全**：利用 TypeScript 集成进行编译时内容验证。
+- **构建时优化**：使用 Intlayer 的构建工具进行自动 tree-shaking 和 bundle 优化。
+- **集成工具**：利用内置的路由、SEO 辅助工具和可视化编辑器支持。
+
+  </Tab>
+</Tabs>
+
+---
+
 ## 胜者是…
 
 这并不简单。每个选项都有权衡。以下是我的看法：

package/blog/zh/nextjs-multilingual-seo-comparison.md

@@ -16,6 +16,7 @@ keywords:
 slugs:
   - blog
   - blog-seo-i18n-nextjs
+author: aymericzip
 ---
 
 # Next.js 中的 SEO 和国际化：仅仅翻译是不够的
@@ -176,36 +177,6 @@ export function abs(locale: string, path: string) {
 }
 ```
 
-```tsx fileName="src/app/[locale]/about/layout.tsx"
-    rules: { userAgent: "*", allow: ["/"], disallow },
-    host: origin,
-    sitemap: `${origin}/sitemap.xml`,
-  };
-}
-```
-
-### **next-i18next**
-
-  </Tab>
-  <Tab label="next-i18next">
-
-```ts fileName="i18n.config.ts"
-export const locales = ["en", "fr"] as const;
-export type Locale = (typeof locales)[number];
-export const defaultLocale: Locale = "en";
-
-/** 除非是默认语言，否则为路径添加语言前缀 */
-export function localizedPath(locale: string, path: string) {
-  return locale === defaultLocale ? path : `/${locale}${path}`;
-}
-
-/** 绝对 URL 辅助函数 */
-const ORIGIN = "https://example.com";
-export function abs(locale: string, path: string) {
-  return `${ORIGIN}${localizedPath(locale, path)}`;
-}
-```
-
 ```tsx fileName="src/app/[locale]/about/layout.tsx"
 import type { Metadata } from "next";
 import { locales, defaultLocale, localizedPath } from "@/i18n.config";

package/blog/zh/per-component_vs_centralized_i18n.md

@@ -13,6 +13,7 @@ keywords:
 slugs:
   - blog
   - per-component-vs-centralized-i18n
+author: aymericzip
 ---
 
 # 每组件（Per-Component）与集中式（Centralized）i18n

package/blog/zh/rag_powered_documentation_assistant.md

@@ -13,6 +13,7 @@ keywords:
 slugs:
   - blog
   - rag-powered-documentation-assistant
+author: aymericzip
 ---
 
 # 构建一个基于RAG的文档助手（分块、嵌入和搜索）
@@ -29,33 +30,6 @@ slugs:
 
 👉 [在线演示](https://intlayer.org/doc/why) 👉 [代码模板](https://github.com/aymericzip/smart_doc_RAG)
 
-## 介绍
-
-如果你曾在文档中迷失，滚动寻找一个答案，你就知道这有多痛苦。文档是有用的，但它们是静态的，搜索起来常常感觉笨拙。
-
-这就是**RAG（检索增强生成）**的用武之地。我们不必强迫用户去翻找文本，而是结合**检索**（找到文档中正确的部分）和**生成**（让大型语言模型自然地解释它）。
-
-在这篇文章中，我将带你了解我是如何构建一个基于RAG的文档聊天机器人的，以及它不仅帮助用户更快地找到答案，还为产品团队提供了一种全新的方式来理解用户痛点。
-
-## 为什么为文档使用RAG？
-
-RAG之所以成为流行的方法，是有原因的：它是让大型语言模型真正发挥作用的最实用方式之一。
-
-对于文档来说，优势非常明显：
-
-- 即时回答：用户用自然语言提问，得到相关的回复。
-- 更好的上下文：模型只看到最相关的文档部分，减少了幻觉现象。
-- 更人性化的搜索：更像是Algolia + FAQ + 聊天机器人三合一。
-- 反馈循环：通过存储查询，你可以发现用户真正遇到的困难。
-
-最后一点至关重要。RAG 系统不仅仅是回答问题，它还能告诉你人们在问什么。这意味着：
-
-- 你会发现文档中缺失的信息。
-- 你会看到新功能请求的出现。
-- 你会发现一些模式，甚至可以指导产品策略。
-
-所以，RAG 不仅仅是一个支持工具，它还是一个**产品发现引擎**。
-
 ## RAG 流程是如何工作的
 
 ![RAG Pipeline](https://github.com/aymericzip/intlayer/blob/main/docs/assets/rag_flow.svg)
@@ -69,12 +43,6 @@ RAG之所以成为流行的方法，是有原因的：它是让大型语言模
 5. **增强与生成（RAG 中的 AG）** 这些文本块被注入到 ChatGPT 的提示中，使模型能够基于实际文档上下文进行回答。
 6. **查询日志反馈** 每个用户查询都会被存储。这对于理解痛点、缺失文档或新机会非常宝贵。
 
-## 第一步：读取文档
-
-第一步很简单：我需要一种方法扫描 docs/ 文件夹中的所有 .md 文件。使用 Node.js 和 glob，我将每个 Markdown 文件的内容加载到内存中。
-
-这保持了流程的灵活性：你可以不是从 Markdown，而是从数据库、CMS，甚至 API 中获取文档。
-
 ## 第2步：将文档分块
 
 为什么要分块？因为语言模型有**上下文限制**。给它们整本文档是行不通的。
@@ -111,164 +79,6 @@ RAG之所以成为流行的方法，是有原因的：它是让大型语言模
 
 每个向量都是文本的数学指纹，支持相似度搜索。
 
-## 第四步：索引与存储嵌入向量
-
-为了避免多次重新生成嵌入，我将它们存储在 embeddings.json 中。
-
-在生产环境中，你可能会想使用以下向量数据库：
-
-- Chroma
-- Qdrant
-- Pinecone
-- FAISS、Weaviate、Milvus 等等。
-
-向量数据库负责索引、可扩展性和快速搜索。但对于我的原型，使用本地 JSON 就足够了。
-
-## 第五步：使用余弦相似度进行检索
-
-当用户提出问题时：
-
-1. 为查询生成一个嵌入向量。
-2. 使用**余弦相似度**将其与所有文档嵌入向量进行比较。
-3. 只保留最相似的前 N 个块。
-
-余弦相似度衡量两个向量之间的夹角。完美匹配的得分为**1.0**。
-
-通过这种方式，系统能够找到与查询最接近的文档段落。
-
-## 第六步：增强 + 生成
-
-现在进入关键步骤。我们将最相关的块注入到 ChatGPT 的**系统提示**中。
-
-这意味着模型的回答就像那些文档片段是对话的一部分一样。
-
-结果是：准确的、**基于文档的响应**。
-
-## 第7步：记录用户查询
-
-这是隐藏的超级能力。
-
-每个提问都会被存储。随着时间推移，你会构建一个数据集，包含：
-
-- 最常见的问题（非常适合常见问题解答）
-- 未回答的问题（文档缺失或不清晰）
-- 伪装成问题的功能请求（“它能与X集成吗？”）
-- 你未曾预料到的新兴用例
-
-这将你的RAG助手变成一个**持续的用户研究工具**。
-
-## 成本是多少？
-
-对RAG的一个常见反对意见是成本。实际上，它出乎意料地便宜：
-
-- 为大约200个文档生成嵌入大约需要**5分钟**，成本为**1–2欧元**。
-- 文档搜索功能是100%免费的。
-- 对于查询，我们使用 gpt-4o-latest，不启用“思考”模式。在 Intlayer 上，我们每月大约处理 **300 次聊天查询**，OpenAI API 账单很少超过 **10 美元**。
-
-除此之外，你还需要考虑托管成本。
-
-## 实现细节
-
-技术栈：
-
-- Monorepo：pnpm 工作区
-- 文档包：Node.js / TypeScript / OpenAI API
-- 前端：Next.js / React / Tailwind CSS
-- 后端：Node.js API 路由 / OpenAI API
-
-`@smart-doc/docs` 包是一个 TypeScript 包，负责文档处理。当添加或修改 markdown 文件时，该包包含一个 `build` 脚本，用于重新构建每种语言的文档列表，生成嵌入向量，并将其存储在 `embeddings.json` 文件中。
-
-在前端，我们使用一个 Next.js 应用程序，提供：
-
-- Markdown 转换为 HTML 渲染
-- 一个用于查找相关文档的搜索栏
-- 一个用于提问文档问题的聊天机器人界面
-
-为了执行文档搜索，Next.js 应用程序包含一个 API 路由，该路由调用 `@smart-doc/docs` 包中的函数以检索与查询匹配的文档块。利用这些文档块，我们可以返回与用户搜索相关的文档页面列表。
-
-对于聊天机器人功能，我们遵循相同的搜索流程，但额外将检索到的文档块注入到发送给 ChatGPT 的提示中。
-
-以下是发送给 ChatGPT 的提示示例：
-
-系统提示：
-
-```txt
-你是一个能够回答关于 Intlayer 文档问题的有用助手。
-
-相关文档块：
-
------
-docName: "getting-started"
-docChunk: "1/3"
-docUrl: "https://example.com/docs/zh/getting-started"
----
-
-# 如何开始
-
-...
-
------
-docName: "another-doc"
-docChunk: "1/5"
-docUrl: "https://example.com/docs/zh/another-doc"
----
-
-# 另一个文档
-
-...
-```
-
-用户查询：
-
-```txt
-如何开始？
-```
-
-我们使用 SSE 来流式传输来自 API 路由的响应。
-
-如前所述，我们使用无“思考”模式的 gpt-4-turbo。响应相关且延迟低。
-我们尝试过 gpt-5，但延迟过高（有时回复需要长达 15 秒）。但我们将来会重新考虑。
-
-👉 [在这里试用演示](https://intlayer.org/doc/zh/why) 👉 [在 GitHub 查看代码模板](https://github.com/aymericzip/smart_doc_RAG)
-
-## 进一步探索
-
-该项目是一个最小实现。但你可以通过多种方式扩展它：
-
-- MCP 服务器 → 将文档检索功能迁移到 MCP 服务器，以便将文档连接到任何 AI 助手
-
-- 向量数据库 → 扩展到数百万文档块
-- LangChain / LlamaIndex → 现成的 RAG 流水线框架
-- 分析仪表盘 → 可视化用户查询和痛点
-- 多源检索 → 不仅检索文档，还能拉取数据库条目、博客文章、工单等
-- 改进的提示技术 → 重新排序、过滤和混合搜索（关键词 + 语义）
-
-## 我们遇到的限制
-
-- 分块和重叠是经验性的。正确的平衡（分块大小、重叠比例、检索块数量）需要反复迭代和测试。
-- 当文档发生变化时，嵌入不会自动重新生成。我们的系统仅在文件的分块数量与存储的不同情况下才会重置该文件的嵌入。
-- 在这个原型中，嵌入向量存储在 JSON 中。这适用于演示，但会污染 Git。在生产环境中，使用数据库或专用向量存储更为合适。
-
-## 这不仅仅是文档的重要性
-
-有趣的部分不仅仅是聊天机器人，而是**反馈循环**。
-
-通过 RAG，你不仅仅是在回答问题：
-
-- 你了解用户的困惑所在。
-- 你发现他们期望的功能。
-- 你根据真实查询调整产品策略。
-
-**示例：**
-
-想象一下发布一个新功能后，立即看到：
-
-- 50% 的问题都集中在同一个不清晰的设置步骤上
-- 用户反复请求你尚未支持的集成
-- 人们搜索的词汇揭示了一个新的使用场景
-
-这就是直接来自用户的**产品智能**。
-
 ## 结论
 
 RAG 是使大型语言模型（LLM）实用的最简单且最强大的方法之一。通过结合**检索 + 生成**，您可以将静态文档转变为**智能助手**，同时获得持续的产品洞察流。

package/blog/zh/react-i18next_vs_react-intl_vs_intlayer.md

@@ -15,6 +15,7 @@ keywords:
 slugs:
   - blog
   - react-i18next-vs-react-intl-vs-intlayer
+author: aymericzip
 ---
 
 # react-Intl VS react-i18next VS intlayer | React 国际化 (i18n)
@@ -147,6 +148,12 @@ slugs:
 
 ---
 
+## GitHub STARs
+
+GitHub stars 是项目受欢迎程度、社区信任度和长期相关性的强有力指标。虽然不是技术质量的直接衡量标准，但它们反映了有多少开发者认为该项目有用、关注其进展，以及可能会采用它。对于评估项目价值，stars 有助于比较不同替代方案的吸引力，并提供对生态系统增长的洞察。
+
+[![Star History Chart](https://api.star-history.com/chart?repos=formatjs/formatjs%2Ci18next/react-i18next%2Caymericzip/intlayer&type=date&legend=top-left)](https://www.star-history.com/#formatjs/formatjs&i18next/react-i18next&aymericzip/intlayer)
+
 ## 结论
 
 所有三个库都能有效地实现 React 的本地化。区别在于你需要构建多少**基础设施**，才能达到一个**安全、可扩展**的环境：

package/blog/zh/vue-i18n_vs_intlayer.md

@@ -15,6 +15,7 @@ keywords:
 slugs:
   - blog
   - vue-i18n-vs-intlayer
+author: aymericzip
 ---
 
 # vue-i18n VS Intlayer | Vue 国际化 (i18n)
@@ -259,6 +260,14 @@ const { greeting } = useIntlayer("component-example");
 
 ---
 
+## GitHub Stars
+
+GitHub stars 是项目受欢迎程度、社区信任度和长期相关性的强有力指标。虽然不是技术质量的直接衡量标准，但它们反映了有多少开发者认为该项目有用、关注其进展，以及可能会采用它。对于估计项目的价值，stars 有助于在各种方案之间进行性能对比，并提供生态系统增长的见解。
+
+[![Star History Chart](https://api.star-history.com/svg?repos=intlify/vue-i18n&repos=aymericzip/intlayer&type=Date)](https://www.star-history.com/#intlify/vue-i18n&aymericzip/intlayer)
+
+---
+
 ## 结论
 
 **vue-i18n** 和 **Intlayer** 都能很好地本地化 Vue 应用。区别在于你需要自己构建多少内容，才能实现一个健壮且可扩展的方案：

package/blog/zh/what_is_internationalization.md

@@ -15,6 +15,7 @@ keywords:
 slugs:
   - blog
   - what-is-internationalization
+author: aymericzip
 ---
 
 # 什么是国际化 (i18n)? 定义与挑战

package/dist/cjs/authors.cjs

@@ -0,0 +1,37 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_authors = require('./authors2.cjs');
+
+//#region src/authors.ts
+const loadAuthors = () => require_authors.default;
+/**
+* Resolve a full author profile by GitHub handle.
+* Returns `undefined` if the handle is not found in `authors.json`.
+*/
+const getAuthor = (github) => {
+	const profile = loadAuthors()[github];
+	if (!profile) return void 0;
+	return {
+		...profile,
+		github
+	};
+};
+/**
+* Build a Schema.org Person node suitable for JSON-LD.
+* Undefined fields are omitted automatically by JSON.stringify.
+*/
+const buildAuthorJsonLd = (profile, fallbackName = "Aymeric Pineau", fallbackUrl) => ({
+	"@type": "Person",
+	"@id": profile?.id,
+	name: profile?.name ?? fallbackName,
+	url: profile?.url ?? fallbackUrl,
+	jobTitle: profile?.title,
+	image: profile?.image,
+	sameAs: profile?.socialMedias?.length ? profile.socialMedias : void 0,
+	knowsAbout: profile?.knowsAbout?.length ? profile.knowsAbout : void 0
+});
+
+//#endregion
+exports.buildAuthorJsonLd = buildAuthorJsonLd;
+exports.getAuthor = getAuthor;
+exports.getAuthors = loadAuthors;
+//# sourceMappingURL=authors.cjs.map

package/dist/cjs/authors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"authors.cjs","names":["authorsData"],"sources":["../../src/authors.ts"],"sourcesContent":["import authorsData from '../authors.json' with { type: 'json' };\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\nexport type AuthorProfile = {\n  /** Full display name */\n  name: string;\n  /** Schema.org Person @id URI (optional) */\n  id?: string;\n  /** Professional title */\n  title?: string;\n  /** Canonical URL for this person */\n  url?: string;\n  /** Profile image URL */\n  image?: string;\n  /** List of equivalent profile URLs (LinkedIn, Twitter/X, GitHub…) */\n  socialMedias?: string[];\n  /** Areas of expertise */\n  knowsAbout?: string[];\n  /** GitHub username/handle */\n  github?: string;\n};\n\nexport type Authors = Record<string, AuthorProfile>;\n\n// ─── Loader (lazy singleton) ──────────────────────────────────────────────────\n\nconst loadAuthors = (): Authors => authorsData as Authors;\n\n// ─── Public API ───────────────────────────────────────────────────────────────\n\n/**\n * Resolve a full author profile by GitHub handle.\n * Returns `undefined` if the handle is not found in `authors.json`.\n */\nexport const getAuthor = (github: string): AuthorProfile | undefined => {\n  const profile = loadAuthors()[github];\n  if (!profile) return undefined;\n  return {\n    ...profile,\n    github,\n  };\n};\n\nexport { loadAuthors as getAuthors };\n\n/**\n * Build a Schema.org Person node suitable for JSON-LD.\n * Undefined fields are omitted automatically by JSON.stringify.\n */\nexport const buildAuthorJsonLd = (\n  profile?: AuthorProfile,\n  fallbackName = 'Aymeric Pineau',\n  fallbackUrl?: string\n) => ({\n  '@type': 'Person' as const,\n  '@id': profile?.id,\n  name: profile?.name ?? fallbackName,\n  url: profile?.url ?? fallbackUrl,\n  jobTitle: profile?.title,\n  image: profile?.image,\n  sameAs: profile?.socialMedias?.length ? profile.socialMedias : undefined,\n  knowsAbout: profile?.knowsAbout?.length ? profile.knowsAbout : undefined,\n});\n"],"mappings":";;;;AA2BA,MAAM,oBAA6BA;;;;;AAQnC,MAAa,aAAa,WAA8C;CACtE,MAAM,UAAU,aAAa,CAAC;AAC9B,KAAI,CAAC,QAAS,QAAO;AACrB,QAAO;EACL,GAAG;EACH;EACD;;;;;;AASH,MAAa,qBACX,SACA,eAAe,kBACf,iBACI;CACJ,SAAS;CACT,OAAO,SAAS;CAChB,MAAM,SAAS,QAAQ;CACvB,KAAK,SAAS,OAAO;CACrB,UAAU,SAAS;CACnB,OAAO,SAAS;CAChB,QAAQ,SAAS,cAAc,SAAS,QAAQ,eAAe;CAC/D,YAAY,SAAS,YAAY,SAAS,QAAQ,aAAa;CAChE"}

package/dist/cjs/authors2.cjs

@@ -0,0 +1,28 @@
+
+//#region authors.json
+var authors_default = { aymericzip: {
+	"name": "Aymeric PINEAU",
+	"title": "Founder of Intlayer, open-source multilingual CMS for Next.js and React",
+	"url": "https://github.com/aymericzip",
+	"image": "https://avatars.githubusercontent.com/u/62554073?v=4&size=124",
+	"socialMedias": [
+		"https://www.linkedin.com/in/aymericpineau/",
+		"https://x.com/aymericzip",
+		"https://github.com/aymericzip"
+	],
+	"knowsAbout": [
+		"Expert in technical internationalization",
+		"Senior software engineer",
+		"Multilingual SEO",
+		"AI translation automation"
+	]
+} };
+
+//#endregion
+Object.defineProperty(exports, 'default', {
+  enumerable: true,
+  get: function () {
+    return authors_default;
+  }
+});
+//# sourceMappingURL=authors2.cjs.map

package/dist/cjs/authors2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"authors2.cjs","names":[],"sources":["../../authors.json"],"sourcesContent":[""],"mappings":""}

package/dist/cjs/common.cjs

@@ -31,11 +31,14 @@ const formatMetadata = (docKey, file, locale = defaultLocale) => {
 	const keywords = (metadata.keywords ?? []).map(String);
 	const relativeUrl = (0, node_path.join)("/", ...slugs);
 	const slicedDocKey = docKey.slice(1);
+	const rawAuthor = metadata.author;
+	const author = typeof rawAuthor === "string" ? rawAuthor || void 0 : rawAuthor?.github || void 0;
 	return {
 		...metadata,
 		docKey,
 		slugs,
 		keywords,
+		author,
 		githubUrl: `${GITHUB_URL_PREFIX}${slicedDocKey}`.replace("/en/", `/${locale}/`),
 		relativeUrl: (0, _intlayer_core_localization.getLocalizedUrl)(relativeUrl, locale),
 		url: (0, _intlayer_core_localization.getLocalizedUrl)((0, node_path.join)(URL_PREFIX, relativeUrl), locale)