@riebeckite/plugin-l10n 0.0.30 → 0.0.31

package/README.md

@@ -30,7 +30,7 @@ translation: getting-started
 ---
 ```
 
-Conventions may be mixed. Built-in precedence is **frontmatter > custom detector > filename > default language**. Conflicts emit `L10N_LANGUAGE_CONFLICT`; use `strict: true` to fail the build instead. A duplicate `translation + lang` emits `L10N_DUPLICATE_TRANSLATION` (and also fails in strict mode).
+Conventions may be mixed. Built-in precedence is **frontmatter > custom detector > filename > default language**. Conflicts emit `L10N_LANGUAGE_CONFLICT`; use `strict: true` to fail the build instead. A duplicate translation identity and language emits `L10N_DUPLICATE_TRANSLATION` (and also fails in strict mode).
 
 `translation` is independent of locale and filename. Use it to group files with unrelated paths or names:
 
@@ -39,6 +39,18 @@ Conventions may be mixed. Built-in precedence is **frontmatter > custom detector
 English/getting-started.md lang: en, translation: getting-started
 ```
 
+Set `translationKey` to read the identity from a different frontmatter property:
+
+```ts
+l10n({
+  defaultLang: "ja",
+  languages: ["ja", "en"],
+  translationKey: "translationId",
+});
+```
+
+With this option, `translationId: getting-started` replaces `translation: getting-started`. The default is `translation`.
+
 ## URLs and missing translations
 
 The default language keeps Core's resolved URL (`/about`); other languages are prefixed (`/en/about`). The plugin augments the existing content-location resolver, so it works with other URL plugins rather than creating a router. Different source paths or a permalink plugin can provide different resolved URLs for translations.

package/README_ja.md

@@ -27,7 +27,7 @@ translation: getting-started
 ---
 ```
 
-組み合わせた場合の組み込み規則の優先順位は **frontmatter > 独自検出 > ファイル名 > 既定言語** です。矛盾は `L10N_LANGUAGE_CONFLICT`、同一 `translation + lang` の重複は `L10N_DUPLICATE_TRANSLATION` として診断します。`strict: true` ではビルドを失敗させます。
+組み合わせた場合の組み込み規則の優先順位は **frontmatter > 独自検出 > ファイル名 > 既定言語** です。矛盾は `L10N_LANGUAGE_CONFLICT`、同一の翻訳 ID と言語の重複は `L10N_DUPLICATE_TRANSLATION` として診断します。`strict: true` ではビルドを失敗させます。
 
 `translation` はロケール検出とは別です。異なるパス・ファイル名でも明示的な ID でグループ化できます。
 
@@ -36,6 +36,18 @@ translation: getting-started
 English/getting-started.md lang: en, translation: getting-started
 ```
 
+翻訳グループの ID を読み取る frontmatter プロパティは `translationKey` で変更できます。
+
+```ts
+l10n({
+  defaultLang: "ja",
+  languages: ["ja", "en"],
+  translationKey: "translationId",
+});
+```
+
+この場合、`translation: getting-started` の代わりに `translationId: getting-started` を使用します。既定値は `translation` です。
+
 翻訳がない言語のページを複製・生成することはありません。`getLocalization(manifest, slug)` は存在する翻訳だけを `availableLanguages` と言語ごとの `translations` に含め、`getLocalizedContent(manifest, slug, lang)` は見つからなければ `null` を返します。
 
 ## URL・テーマ・SEO

package/dist/index.js

@@ -163,6 +163,7 @@ function resolveOptions(options) {
       languages.map((language) => [language.toLowerCase(), language])
     ),
     strict: options.strict ?? false,
+    translationKey: (options.translationKey ?? "translation").trim(),
     detect: options.detect
   };
 }
@@ -195,6 +196,9 @@ function validateOptions(options) {
   if (options.strict !== void 0 && typeof options.strict !== "boolean") {
     errors.push("l10n.strict must be a boolean.");
   }
+  if (options.translationKey !== void 0 && (typeof options.translationKey !== "string" || !options.translationKey.trim())) {
+    errors.push("l10n.translationKey must be a non-empty string.");
+  }
   if (options.detect !== void 0 && typeof options.detect !== "function") {
     errors.push("l10n.detect must be a function.");
   }
@@ -256,7 +260,9 @@ function detectContents(entries, options) {
       diagnostics.push(conflictDiagnostic(entry, signals, options.strict));
     }
     const lang = signals.frontmatter ?? signals.custom ?? signals.filename ?? options.defaultLang;
-    const translationId = readTranslationId(custom?.translationId ?? frontmatter.translation) ?? deriveTranslationId(entry.path, filenameLanguage);
+    const translationId = readTranslationId(
+      custom?.translationId ?? frontmatter[options.translationKey]
+    ) ?? deriveTranslationId(entry.path, filenameLanguage);
     const content = {
       path: entry.path,
       slug: entry.slug,

package/dist/src/l10n.d.ts

@@ -16,6 +16,7 @@ export type L10nOptions = {
     defaultLang: string;
     languages: readonly string[];
     strict?: boolean;
+    translationKey?: string;
     detect?: (content: L10nDetectorContext) => L10nDetectorResult | undefined;
 };
 export type LocalizedContent = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-l10n",
-  "version": "0.0.30",
+  "version": "0.0.31",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -23,12 +23,12 @@
   "dependencies": {
     "hono": "^4.12.25",
     "yaml": "^2.9.0",
-    "@riebeckite/core": "0.0.30",
-    "@riebeckite/ui": "0.0.30"
+    "@riebeckite/ui": "0.0.31",
+    "@riebeckite/core": "0.0.31"
   },
   "devDependencies": {
     "tsx": "^4.22.4",
-    "@riebeckite/plugin-obsidian-markdown": "0.0.30"
+    "@riebeckite/plugin-obsidian-markdown": "0.0.31"
   },
   "publishConfig": {
     "access": "public"